> ## Documentation Index > Fetch the complete documentation index at: https://developers.useqx.com/llms.txt > Use this file to discover all available pages before exploring further. # List the documents of a contact > Lists the documents of a contact, from the newest document to the oldest. The list includes the documents of the collections and the documents in Triage. An empty slot of a collection appears in the list with `status` equal to `pending`. The list does not include a discarded document. `GET /documents/{id}` shows a discarded document, with `discarded` equal to `true`. Send the `contact_id` or the `tax_id`. ## OpenAPI ````yaml /en/openapi.yaml get /documents openapi: 3.1.0 info: title: QX API version: 1.0.0 description: >- The QX API creates and reads the contacts, the collections and the documents of the organization, and it lists the packs. Each call carries the API key of the organization. The API sends each error in the RFC 9457 format (`application/problem+json`), with a stable `code`. In addition to the errors of each endpoint, any path under `/api/v1` can return these errors: - `404` with `route_not_found`: the API does not have the path, or the path does not accept the HTTP method. - `405` with `method_not_allowed`: the API does not recognize the HTTP method. - `406` with `not_acceptable`: the API does not recognize the `Content-Type` or the `Accept` of the call. - another `4xx` status with `request_refused`: the API could not complete the call. - a `5xx` status with `internal_error`: QX had an internal error. servers: - url: https://app.useqx.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Collections description: >- The collections of the organization. A collection asks the contact for the documents of a pack. - name: Contacts description: >- The people and the companies of the organization. A person has a CPF, and a company has a CNPJ. - name: Documents description: >- The documents of the organization. A document sent without a collection goes to Triage. A document sent with a collection fills the slot of its type. - name: Packs description: The packs of the organization and the requirements of each pack. paths: /documents: get: tags: - Documents summary: List the documents of a contact description: >- Lists the documents of a contact, from the newest document to the oldest. The list includes the documents of the collections and the documents in Triage. An empty slot of a collection appears in the list with `status` equal to `pending`. The list does not include a discarded document. `GET /documents/{id}` shows a discarded document, with `discarded` equal to `true`. Send the `contact_id` or the `tax_id`. operationId: listDocuments parameters: - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' - name: contact_id in: query description: >- The id of the contact. A person id starts with `per_`, and a company id starts with `com_`. schema: type: string example: com_12 - name: tax_id in: query description: The CPF or the CNPJ of the contact, with or without punctuation. schema: type: string example: 12.345.678/0001-95 - name: collection_id in: query description: >- The id of a collection. With this filter, the list includes only the documents of the collection. schema: type: string example: col_40 responses: '200': description: A page of documents. content: application/json: schema: $ref: '#/components/schemas/DocumentList' examples: page: summary: >- A page with the invoice after the reading and an empty slot of the collection value: data: - id: doc_318 document_type: id: dtp_31 name: Fatura Comercial (Commercial Invoice) status: uploaded reading_status: complete contact: id: com_12 type: company name: Importadora Exemplo Ltda collection_id: col_40 in_triage: false discarded: false discard_reason: null replaced_by: null number: INV-81244/2026 arrival_channel: api arrived_at: '2026-09-25T10:32:05.000-03:00' files: - name: fatura.pdf content_type: application/pdf size: 182044 created_at: '2026-09-25T10:32:05.000-03:00' - id: doc_312 document_type: id: dtp_33 name: Romaneio de Carga (Packing List) status: pending reading_status: not_started contact: id: com_12 type: company name: Importadora Exemplo Ltda collection_id: col_40 in_triage: false discarded: false discard_reason: null replaced_by: null number: null arrival_channel: null arrived_at: null files: [] created_at: '2026-09-25T10:31:12.000-03:00' has_more: true next_cursor: WyIyMDI2LTA5LTI1VDEzOjMxOjEyLjAwMDAwMFoiLDMxMl0 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: Limit: name: limit in: query description: The number of items on the page, from 1 to 100. The default is 25. schema: type: integer minimum: 1 maximum: 100 default: 25 example: 25 Cursor: name: cursor in: query description: >- The `next_cursor` value of the previous page. Without this parameter, the list starts at the newest item. schema: type: string example: WyIyMDI2LTA5LTI1VDEzOjMxOjEyLjAwMDAwMFoiLDQwXQ schemas: DocumentList: type: object additionalProperties: false required: - data - has_more - next_cursor properties: data: type: array items: $ref: '#/components/schemas/DocumentSummary' has_more: type: boolean description: With `true`, the list has more items after this page. next_cursor: type: - string - 'null' description: >- The value of the `cursor` parameter for the next page. On the last page, the value is `null`. DocumentSummary: description: A document, without the fields. allOf: - $ref: '#/components/schemas/DocumentFields' unevaluatedProperties: false Problem: type: object description: An error in the RFC 9457 format. required: - type - title - status - detail - code properties: type: type: string const: about:blank description: Always `about:blank`. title: type: string description: The phrase of the HTTP status, in English. examples: - Unauthorized status: type: integer description: The HTTP status. examples: - 401 detail: type: string description: >- The explanation of the error, in the language of the organization. An answer that leaves before the key identifies the organization stays in Portuguese. code: type: string description: >- The error code, in English. The code does not change between versions of v1. DocumentFields: type: object description: The fields of every document. required: - id - document_type - status - reading_status - contact - collection_id - in_triage - discarded - discard_reason - replaced_by - number - arrival_channel - arrived_at - files - created_at properties: id: type: string pattern: ^doc_[1-9][0-9]*$ description: The id of the document. examples: - doc_310 document_type: $ref: '#/components/schemas/DocumentTypeReference' status: $ref: '#/components/schemas/DocumentStatus' reading_status: type: string enum: - not_started - extracting - enriching - validating - complete - failed - no_reader description: >- The progress of the reading of the document. `not_started`: the reading did not start. `extracting`, `enriching` and `validating`: the reading is in progress. `complete`: the reading ended. `failed`: the reading failed. `no_reader`: the document type has no reading. contact: description: >- The contact of the document. The value is `null` when the document has no contact. anyOf: - $ref: '#/components/schemas/CollectionContact' - type: 'null' collection_id: type: - string - 'null' pattern: ^col_[1-9][0-9]*$ description: >- The id of the collection of the document. The value is `null` while the document is in Triage. examples: - col_40 in_triage: type: boolean description: With `true`, the document is in Triage and has no collection yet. discarded: type: boolean description: With `true`, the document is discarded. discard_reason: type: - string - 'null' enum: - outside_pack - identical_copy - superseded - operator - replaced - null description: >- The reason for the discard. The value is `null` on a document that is not discarded. `outside_pack`: no active operation pack asks for the type of the document. `identical_copy`: the document repeats the file of another document. `superseded`: a newer document replaced this document. `operator`: the operator discarded the document. `replaced`: a file swap created a new document, and this document stayed as the previous version. replaced_by: type: - string - 'null' pattern: ^doc_[1-9][0-9]*$ description: >- In the previous version of a file swap, the id of the current document. The current document is the last document in the chain of file swaps. On the other documents, the value is `null`. examples: - doc_325 number: type: - string - 'null' description: >- The printed number that identifies the document, such as the invoice number. The value is `null` before the reading. examples: - INV-81244/2026 arrival_channel: type: - string - 'null' enum: - email - portal_upload - operator_upload - spreadsheet - vault - api - null description: >- The arrival channel of the file. The value is `null` on an empty slot. `email`: the file arrived by email. `portal_upload`: the client sent the file on the portal. `operator_upload`: the operator sent the file on the QX screen. `spreadsheet`: the file came from a spreadsheet. `vault`: the client reused a file from the Vault on the portal. `api`: the file arrived through the API. arrived_at: type: - string - 'null' format: date-time description: >- The date and the time when the file arrived, in the time zone of the organization. The value is `null` on an empty slot. files: type: array description: The files of the document. On an empty slot, the list is empty. items: $ref: '#/components/schemas/DocumentFile' created_at: type: string format: date-time description: >- The date and the time of the creation, in the time zone of the organization. examples: - '2026-09-25T10:30:00.000-03:00' DocumentTypeReference: type: object additionalProperties: false required: - id - name properties: id: type: string pattern: ^dtp_[1-9][0-9]*$ description: The id of the document type. examples: - dtp_31 name: type: string description: The name of the document type. examples: - Fatura Comercial (Commercial Invoice) DocumentStatus: type: string enum: - pending - uploaded - approved - rejected description: >- The progress of the document. `pending`: the document waits for the upload. `uploaded`: the document arrived and waits for the review. `approved`: the operator approved the document. `rejected`: the operator rejected the document. CollectionContact: type: object additionalProperties: false required: - id - type - name properties: id: type: string pattern: ^(per|com)_[1-9][0-9]*$ description: The id of the contact. examples: - com_12 type: type: string enum: - person - company description: '`person` for a person and `company` for a company.' name: type: - string - 'null' description: The name of the contact. examples: - Importadora Exemplo Ltda DocumentFile: type: object additionalProperties: false required: - name - content_type - size properties: name: type: string description: The name of the file. examples: - fatura.pdf content_type: type: - string - 'null' description: The MIME type of the file. examples: - application/pdf size: type: integer description: The size of the file, in bytes. examples: - 182044 responses: BadRequest: description: >- The API refused the call. The `code` gives the reason: - `invalid_parameter`: a parameter is missing or has an invalid value. - `malformed_request`: the API could not read the call. Examples of causes: - the path or the query has an invalid encoding; - the query repeats a parameter in different forms, such as `limit=1&limit[]=2`; - the body is not valid JSON; - the address in the `Client-IP` header is not in the `X-Forwarded-For` header. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - invalid_parameter - malformed_request examples: invalid_parameter: summary: The limit is above 100 value: type: about:blank title: Bad Request status: 400 detail: The limit parameter has an invalid value. code: invalid_parameter malformed_request: $ref: '#/components/examples/MalformedRequest' Unauthorized: description: The key is missing, does not exist or is revoked. headers: WWW-Authenticate: $ref: '#/components/headers/WwwAuthenticate' content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - unauthorized examples: unauthorized: summary: The key is missing or not valid value: type: about:blank title: Unauthorized status: 401 detail: >- The call did not include a valid API key. Send the key in the Authorization header, in the format Bearer . code: unauthorized PaymentRequired: description: The subscription of the organization is blocked. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - subscription_blocked examples: subscription_blocked: summary: The subscription is blocked value: type: about:blank title: Payment Required status: 402 detail: >- The subscription of the organization is blocked. Settle the payment in QX to use the API. code: subscription_blocked Forbidden: description: >- The organization is archived, or the plan of the organization does not include the API. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - organization_archived - plan_required examples: plan_required: summary: The free plan does not include the API value: type: about:blank title: Forbidden status: 403 detail: >- The free plan does not include the API. Subscribe to a paid plan in QX to use the API. code: plan_required TooManyRequests: description: The key or the IP address went over a limit. headers: Retry-After: $ref: '#/components/headers/RetryAfter' content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - rate_limited - daily_limit_reached - too_many_invalid_keys examples: rate_limited: summary: The key went over the per-minute limit value: type: about:blank title: Too Many Requests status: 429 detail: >- The key went over a per-minute limit. Wait for the seconds in the Retry-After header and call again. code: rate_limited examples: MalformedRequest: summary: The API could not read the call value: type: about:blank title: Bad Request status: 400 detail: >- The API could not read the call. Check the shape and the encoding of the path and the query, the JSON of the body and the headers. code: malformed_request headers: WwwAuthenticate: description: The authentication scheme that the API expects. required: true schema: type: string example: Bearer realm="QX API" RetryAfter: description: The seconds to wait before the next call. required: true schema: type: integer minimum: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: >- The API key of the organization, in the `Authorization: Bearer ` header. The key starts with `qx_`. ````