Run business verification

Starts business verification: the submission moves to processing and Niva sends a submission.status_updated webhook, then another one when processing ends in needs_review, pending_rfi, approved or rejected.

The request returns 422 unless:

The status is pending or pending_rfi: Submission status must be pending or pending_rfi

At least one document is uploaded: No documents found for submission, at least one is required.

Mexico, legal entities: a usable acta constitutiva (formation / acta_constitutiva): Acta constitutiva is required to run a submission

Legal entities in Chile, Colombia, and Brazil: a usable formation document whose country_code is the submission's market (e.g. a CCMEI for an MEI): A usable formation document is required to run a submission

Sole proprietors need no formation document. Brazilian submissions are created as legal entities. Usable means Niva extracted the file and recognized it as the declared type.

To run a processed submission again, first set its status to pending_rfi with Update submission status, add the new information or documents, then call this endpoint again.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢201Created

application/json

Success

Bodyapplication/json

Example

{
  "id": "sub_3ZMd9KJnvAdYt4mOyW7YQRAp",
  "token": "YOUR_SUBMISSION_TOKEN",
  "country_code": "mx",
  "status": "processing",
  "business_type": "persona_moral",
  "legal_name": "Nueva Vista Alimentos S.A. de C.V.",
  "tax_id_number": "NVA120409XD2",
  "tax_id_label": "rfc",
  "created_at": "2026-10-23T21:31:32.501Z",
  "updated_at": "2026-10-23T21:31:33.090Z",
  "external_id": "acct-10293",
  "policy_id": "pol_gMPYprwdJXy9CNezk6A93zEN",
  "dashboard_url": "https://app.niva.co/dashboard/submissions/sub_3ZMd9KJnvAdYt4mOyW7YQRAp/details"
}

🟠401Unauthorized

🟠404Not Found

🟠422Unprocessable Content

🔴500Internal Server Error