Submissions

Submissions are the starting point of business verification. Each submission is one verification request for a business and tracks it from creation to a decision.

Each submission belongs to one market, set with country_code when you create it: Mexico (mx), Brazil (br), Chile (cl) or Colombia (co). The market decides which fields are required, which documents you upload and which checks run. See Verifying a new business for the end-to-end flow and Country-specific fields for what each market returns.

A submission:

Holds the business details you send (legal name, tax ID, applicant, custom data)

Collects the documents uploaded for the business

Tracks verification through the statuses below

Can be updated while its status is pending

Use the endpoints in this section to create, list, retrieve, update and run submissions.

Submission statuses

Status	Description
`pending`	Created; waiting for documents and for Run business verification
`processing`	Niva is performing the full business verification
`needs_review`	Processing finished and the submission awaits a decision
`pending_rfi`	More information was requested; add or remove documents and run verification again. Business inputs remain read-only
`approved`	The business passed verification and is approved
`rejected`	The business did not pass verification

Schema

Submission

Submissions

Submission statuses#

Schema#

Submission statuses

Schema