---
id: list-documents
title: "List documents"
description: "List documents with pagination and optional search. Documents are the source content from which memory units are extracted."
sidebar_label: "List documents"
hide_title: true
hide_table_of_contents: true
api: eJzFVk1v4zYQ/SvEnFpAsSRvctEt7QatgWw33bg9NDAMmhpb3FCkQlJJDEH/fUGK+trESVsUqC+2ycd58/FmyAZyNEzzynIlIYNrbizJFatLlNaQJ24LUtEDl9QBCJU5UR5LBTFINSsW5OMApxqJLZAYVWuGhClpUVqy16okTwVnBSmxVPpIaskDHJ+tpsxivoAIVIXaE61yyEBwY7eDLxBBRTUt0aI2kN01IGmJkMGOyvstzyEC7iKoqC0gAo0PNdeYQ2Z1jREYVmBJIWvAHit3zFjN5QEisNwKt/ATlfdklUPbRoPth97qQ436ODO7p8LM7FJ5/Lz3js0ZnLmwImshoN2MnL/P2AQvuf0HjMEqlxYPqCGCHPe0FhayNElGkmtvdkqk9nuD/w3ThOdzZ7V1AWo0lZIGjTu9TBL3NVfabc0YGrOvBfkSwBBBkIzPZ1UJzrwc4q/GnWkmHlXaicXyjoFbLOc/aJ7zTqc3E2SnhRCN2n1FZqEdFqjW9DhRxMobc/vKUvFqHnro2iPaKNTwLWgoR9RX4S3skNLvnZ5W6y5E3fsZDUIKDJspubFDv07yPq9Nv0FKlaMge6WJmA8GlHmluLSua/GZlpWzPqT/rhm6MoPaoE6XH8bibgtqCpfuHQvrGqnFfEstZLBMludnSXqWXqzTJPuQZEnyl1OqM2XQGK7kNoUIukmydZNky1TtNJNeRGDx2W4FyoMtILs4XyYR1FX+jnmn2FA43zl9ZZKh9BdJ6z4RnC+XL7X8JxU87ybkldZK/3sh52gpFzMlzwFCsbnO3586vazazWmpX6vOQafL0hzempOf0Bh6wLFvTkN9Msja7b4nYRdXRx1wE9GO6e2yezqMj136XiPrIb+u1zcvDHa1LdEWyuns4Iejv0kyiB/TOIy72KnaxE0QdxtPbycu98onoyfiMjf8UFjiKMnlzepFn/UbvsMGfFAPZV49YWR/6i7O26OxWHaDhqHr3RFyWVFWIFkuEoig1gIyKKytTBbHT09PC+q3F0of4nDWxNern69+u706Wy6SRWFLP8EeUZvOvXSRLBK3VCljSyonXPN3wveBNaP8/+cXRVCBmwpxJSj3Ave5aUJ97+AxnVxokZ9cLqJsfFiMgW4iKJSx7ljT7KjBP7RoW7fc3aKuEXNu6E5M7tF7PIa3xCMVtfPHt+cJXD+8/w52uMhH8Mb90dyhX/fmZKV++BL68UdyKnN928njlLP3pk+YHzQF0hy1d6HbvWQMq6mvL+ai833owV+u1tC23wAZ6pY/
sidebar_class_name: "get api-method"
info_path: docs/api-reference/endpoints/hindsight-http-api
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List documents"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/v1/default/banks/{bank_id}/documents"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List documents with pagination and optional search. Documents are the source content from which memory units are extracted.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"bank_id","in":"path","required":true,"schema":{"type":"string","title":"Bank Id"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["items","total","limit","offset"],"title":"ListDocumentsResponse","description":"Response model for list documents endpoint.","example":{"items":[{"bank_id":"user123","content_hash":"abc123","created_at":"2024-01-15T10:30:00Z","id":"session_1","memory_unit_count":15,"text_length":5420,"updated_at":"2024-01-15T10:30:00Z"}],"limit":100,"offset":0,"total":50}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}}}
>
  
</StatusCodes>