List submissions

Returns your account's submissions as summaries, 10 per page by default (per_page up to 50). Pagination totals are in the X-Total, X-Total-Pages, X-Page, X-Per-Page, X-Next-Page and X-Prev-Page response headers. Archived submissions are included. Use Get submission for a submission's documents and extracted business data.

Responses

🟢200OK

application/json

Success

Bodyapplication/json

Example

[
  {
    "id": "sub_3ZMd9KJnvAdYt4mOyW7YQRAp",
    "token": "YOUR_SUBMISSION_TOKEN",
    "country_code": "mx",
    "status": "needs_review",
    "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"
  },
  {
    "id": "sub_LRx8bNQornNoTW2r057zpyWj",
    "token": "YOUR_SUBMISSION_TOKEN",
    "country_code": "cl",
    "status": "pending",
    "business_type": "legal_entity",
    "legal_name": "Comercial Los Andes Spa",
    "tax_id_number": "761349414",
    "tax_id_label": "rut",
    "created_at": "2026-10-23T21:31:33.287Z",
    "updated_at": "2026-10-23T21:31:33.287Z",
    "external_id": "acct-10294",
    "policy_id": "pol_djm648yaJ3jyHQMPOBAzwWYQ",
    "dashboard_url": "https://app.niva.co/dashboard/submissions/sub_LRx8bNQornNoTW2r057zpyWj/details"
  }
]

🟠401Unauthorized

🟠422Unprocessable Content

🔴500Internal Server Error

List submissions

Request

Request Code Samples

Responses