Get document (public)

Returns one document with the data Niva extracted in data (shape per Supported document types). Send your public API key in the apiKey header and the submission's token in the path; see Public Documents API. Otherwise this endpoint behaves exactly like its private counterpart.

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_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

🔴500Internal Server Error