> ## 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. # Listar os documentos de um contato > Lista os documentos de um contato, do documento mais novo ao mais antigo. A lista traz os documentos das coletas e os documentos da Triagem. O slot vazio de uma coleta entra na lista com `status` igual a `pending`. A lista não traz o documento descartado. `GET /documents/{id}` mostra o documento descartado, com `discarded` igual a `true`. Informe o `contact_id` ou o `tax_id`. ## OpenAPI ````yaml /openapi.yaml get /documents openapi: 3.1.0 info: title: QX API version: 1.0.0 description: >- A API do QX cria e lê os contatos, as coletas e os documentos da organização e lista os pacotes. Cada chamada leva a chave de API da organização. servers: - url: https://app.useqx.com/api/v1 description: Produção security: - bearerAuth: [] tags: - name: Coletas description: >- As coletas da organização. A coleta pede ao contato os documentos de um pacote. - name: Contatos description: >- As pessoas e as empresas da organização. A pessoa tem um CPF, e a empresa tem um CNPJ. - name: Documentos description: >- Os documentos da organização. O documento enviado sem coleta entra na Triagem, e o documento enviado com coleta ocupa o slot do tipo. - name: Pacotes description: Os pacotes da organização e os requisitos de cada pacote. paths: /documents: get: tags: - Documentos summary: Listar os documentos de um contato description: >- Lista os documentos de um contato, do documento mais novo ao mais antigo. A lista traz os documentos das coletas e os documentos da Triagem. O slot vazio de uma coleta entra na lista com `status` igual a `pending`. A lista não traz o documento descartado. `GET /documents/{id}` mostra o documento descartado, com `discarded` igual a `true`. Informe o `contact_id` ou o `tax_id`. operationId: listDocuments parameters: - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/Cursor' - name: contact_id in: query description: >- O id do contato. O id da pessoa começa com `per_`, e o id da empresa começa com `com_`. schema: type: string example: com_12 - name: tax_id in: query description: O CPF ou o CNPJ do contato, com ou sem pontuação. schema: type: string example: 12.345.678/0001-95 - name: collection_id in: query description: >- O id de uma coleta. Com este filtro, a lista traz só os documentos da coleta. schema: type: string example: col_40 responses: '200': description: Uma página de documentos. content: application/json: schema: $ref: '#/components/schemas/DocumentList' examples: page: summary: Uma página com a fatura lida e um slot vazio da coleta 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 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 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: A quantidade de itens da página, de 1 a 100. O padrão é 25. schema: type: integer minimum: 1 maximum: 100 default: 25 example: 25 Cursor: name: cursor in: query description: >- O valor de `next_cursor` da página anterior. Sem este parâmetro, a lista começa no item mais novo. 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: Com `true`, a lista tem mais itens depois desta página. next_cursor: type: - string - 'null' description: >- O valor do parâmetro `cursor` para a próxima página. Na última página, o valor é `null`. DocumentSummary: description: Um documento, sem os campos. allOf: - $ref: '#/components/schemas/DocumentFields' unevaluatedProperties: false Problem: type: object description: Um erro no formato da RFC 9457. required: - type - title - status - detail - code properties: type: type: string const: about:blank description: Sempre `about:blank`. title: type: string description: A frase do status HTTP, em inglês. examples: - Unauthorized status: type: integer description: O status HTTP. examples: - 401 detail: type: string description: A explicação do erro, em português. code: type: string description: O código do erro, em inglês. O código não muda entre versões da v1. DocumentFields: type: object description: Os campos de todo documento. required: - id - document_type - status - reading_status - contact - collection_id - in_triage - discarded - discard_reason - number - arrival_channel - arrived_at - files - created_at properties: id: type: string pattern: ^doc_[1-9][0-9]*$ description: O id do documento. 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: >- O andamento da leitura do documento. `not_started`: a leitura não começou. `extracting`, `enriching` e `validating`: a leitura está em curso. `complete`: a leitura terminou. `failed`: a leitura falhou. `no_reader`: o tipo de documento não tem leitura. contact: description: >- O contato do documento. O valor é `null` quando o documento não tem contato. anyOf: - $ref: '#/components/schemas/CollectionContact' - type: 'null' collection_id: type: - string - 'null' pattern: ^col_[1-9][0-9]*$ description: >- O id da coleta do documento. O valor é `null` enquanto o documento está na Triagem. examples: - col_40 in_triage: type: boolean description: Com `true`, o documento está na Triagem e ainda não tem coleta. discarded: type: boolean description: Com `true`, o documento está descartado. discard_reason: type: - string - 'null' enum: - outside_pack - identical_copy - superseded - operator - null description: >- O motivo do descarte. O valor é `null` no documento que não está descartado. `outside_pack`: nenhum pacote de operação ativo pede o tipo do documento. `identical_copy`: o documento repete o arquivo de outro documento. `superseded`: um documento mais novo substituiu este. `operator`: o operador descartou o documento. number: type: - string - 'null' description: >- O número impresso que identifica o documento, como o número da fatura. O valor é `null` antes da leitura. examples: - INV-81244/2026 arrival_channel: type: - string - 'null' enum: - email - portal_upload - operator_upload - spreadsheet - vault - api - null description: >- O canal de chegada do arquivo. O valor é `null` no slot vazio. `email`: o arquivo chegou por e-mail. `portal_upload`: o cliente enviou o arquivo no portal. `operator_upload`: o operador enviou o arquivo na tela. `spreadsheet`: o arquivo saiu de uma planilha. `vault`: o cliente reaproveitou no portal um arquivo do Cofre. `api`: o arquivo chegou pela API. arrived_at: type: - string - 'null' format: date-time description: >- A data e a hora da chegada do arquivo, no fuso horário da organização. O valor é `null` no slot vazio. files: type: array description: Os arquivos do documento. No slot vazio, a lista é vazia. items: $ref: '#/components/schemas/DocumentFile' created_at: type: string format: date-time description: A data e a hora da criação, no fuso horário da organização. 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: O id do tipo de documento. examples: - dtp_31 name: type: string description: O nome do tipo de documento. examples: - Fatura Comercial (Commercial Invoice) DocumentStatus: type: string enum: - pending - uploaded - approved - rejected description: >- O andamento do documento. `pending`: o documento espera o envio. `uploaded`: o documento chegou e espera a revisão. `approved`: o operador aprovou o documento. `rejected`: o operador recusou o documento. CollectionContact: type: object additionalProperties: false required: - id - type - name properties: id: type: string pattern: ^(per|com)_[1-9][0-9]*$ description: O id do contato. examples: - com_12 type: type: string enum: - person - company description: '`person` para a pessoa e `company` para a empresa.' name: type: - string - 'null' description: O nome do contato. examples: - Importadora Exemplo Ltda DocumentFile: type: object additionalProperties: false required: - name - content_type - size properties: name: type: string description: O nome do arquivo. examples: - fatura.pdf content_type: type: - string - 'null' description: O tipo MIME do arquivo. examples: - application/pdf size: type: integer description: O tamanho do arquivo, em bytes. examples: - 182044 responses: BadRequest: description: Um parâmetro falta ou tem um valor inválido. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - invalid_parameter examples: invalid_parameter: summary: O limit passa de 100 value: type: about:blank title: Bad Request status: 400 detail: O parâmetro limit tem um valor inválido. code: invalid_parameter Unauthorized: description: A chave falta, não existe ou está revogada. 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: A chave falta ou não vale value: type: about:blank title: Unauthorized status: 401 detail: >- A chamada não trouxe uma chave de API válida. Envie a chave no cabeçalho Authorization, no formato Bearer . code: unauthorized PaymentRequired: description: A assinatura da organização está bloqueada. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - subscription_blocked examples: subscription_blocked: summary: A assinatura está bloqueada value: type: about:blank title: Payment Required status: 402 detail: >- A assinatura da organização está bloqueada. Regularize o pagamento no QX para usar a API. code: subscription_blocked Forbidden: description: >- A organização está arquivada, ou o plano da organização não inclui a API. content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/Problem' - type: object properties: code: enum: - organization_archived - plan_required examples: plan_required: summary: O plano gratuito não inclui a API value: type: about:blank title: Forbidden status: 403 detail: >- O plano gratuito não inclui a API. Assine um plano pago no QX para usar a API. code: plan_required TooManyRequests: description: A chave ou o endereço IP passou de um limite. 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: A chave passou do limite por minuto value: type: about:blank title: Too Many Requests status: 429 detail: >- A chave passou de um limite por minuto. Espere os segundos do cabeçalho Retry-After e chame de novo. code: rate_limited headers: WwwAuthenticate: description: O esquema de autenticação que a API espera. required: true schema: type: string example: Bearer realm="QX API" RetryAfter: description: Os segundos de espera antes da próxima chamada. required: true schema: type: integer minimum: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: >- A chave de API da organização, no cabeçalho `Authorization: Bearer `. A chave começa com `qx_`. ````