Rerun validations

Production

https://api.niva.co/v1

PUT

/submissions/{submission_id}/documents/{document_id}/run_validations

Runs the document's instant checks again, synchronously, e.g. after correcting validation_inputs[name], and returns the updated documents. document_id accepts the document ID (doc_…) or your external_id; external IDs need not be unique, so the response is always an array.

Request

Authorization

Add parameter in header

apiKey

Example:

apiKey: ********************

Path Params

Header Params

Body Params application/json

Example

{
    "validation_inputs": {
        "name": "Juan Pérez",
        "entity_type": "person"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.niva.co/v1/submissions/sub_3ZMd9KJnvAdYt4mOyW7YQRAp/documents/doc_MAXm5v0B7kZVHorQL8YjV2y9/run_validations' \
--header 'Accept-Language: en' \
--header 'apiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "validation_inputs": {
        "name": "Juan Pérez",
        "entity_type": "person"
    }
}'

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": []
  }
]

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Content

🔴500Internal Server Error

Download document file

RPC search