List documents

Lists the documents on a submission. Filter by country_code, document_type, document_subtype, document_name or external_id; filters combine with AND, and a value no document has returns [], not an error. Send only the filters you need: an empty value matches only empty fields.

On Mexican submissions, ID documents are returned with document_subtype ine whatever subtype was sent, and one uploaded with a foreign country_code keeps document_type ine, so match documents by id or external_id rather than by type.

If document merging is enabled in your policy, merged documents are not listed; the parent document is returned in their place. See Merging documents.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Success

Bodyapplication/json

Example

[
  {
    "id": "doc_MAXm5v0B7kZVHorQL8YjV2y9",
    "submission_id": "sub_3ZMd9KJnvAdYt4mOyW7YQRAp",
    "validation_status": "valid",
    "country_code": "mx",
    "document_type": "formation",
    "document_subtype": "acta_constitutiva",
    "uploaded_at": "2026-10-23T21:31:32.588Z",
    "validation_errors": [],
    "source": "user",
    "external_id": "acta-001",
    "document_name": null,
    "file": {
      "name": "acta_constitutiva.pdf",
      "byte_size": 482113
    },
    "data": {
      "business": {
        "entity_type": null,
        "legal_name": "Nueva Vista Alimentos S.A. de C.V.",
        "previous_legal_names": [],
        "merged_company_legal_names": [],
        "incorporation_date": null
      },
      "document": {
        "document_type": "acta_constitutiva",
        "date_of_deed": "2012-04-09",
        "boleta": {
          "is_present": true,
          "entry_number": "N-2012012345"
        }
      },
      "officers": null
    },
    "parent_document_id": null,
    "merged_documents": []
  },
  {
    "id": "doc_VJ1O9pg07bBNulJ7LjYd6Nx2",
    "submission_id": "sub_3ZMd9KJnvAdYt4mOyW7YQRAp",
    "validation_status": "valid",
    "country_code": "mx",
    "document_type": "tax_registration",
    "document_subtype": "csf",
    "uploaded_at": "2026-10-23T21:31:32.717Z",
    "validation_errors": [],
    "source": "user",
    "external_id": "csf-001",
    "document_name": null,
    "file": {
      "name": "csf.pdf",
      "byte_size": 118204
    },
    "data": {
      "name": "Nueva Vista Alimentos S.A. de C.V.",
      "full_business_name": "Nueva Vista Alimentos S.A. de C.V.",
      "place_of_issue": null,
      "date_of_issue": "2026-10-22",
      "curp": null,
      "first_name": null,
      "first_last_name": null,
      "second_last_name": null,
      "trade_name": null,
      "start_date": null,
      "status_update_date": null,
      "status": "activo",
      "economic_activity": [],
      "regimen_capital": null,
      "business_name": "Nueva Vista Alimentos S.A. de C.V.",
      "entity_type": null,
      "id_cif": null,
      "address": "Esc. 750 Escalinata Verónica s/n. Puerta 243, Burgos, Vas 31477",
      "tax_regimes": [
        {
          "regime": "Régimen General de Ley Personas Morales",
          "start_date": "2026-04-23",
          "end_date": "2027-04-23"
        }
      ],
      "economic_activities": [],
      "address_components": {
        "address_line_1": "",
        "city": null,
        "state": null,
        "postal_code": null,
        "colony": null,
        "locality": null,
        "street_type": null,
        "street_name": null,
        "exterior_number": null,
        "interior_number": null,
        "cross_street_1": null,
        "cross_street_2": null
      }
    },
    "parent_document_id": null,
    "merged_documents": []
  }
]

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Content

🔴500Internal Server Error