Home
Home
  1. Submissions
  • Getting started
  • Authentication
  • Webhooks
  • Embeddable widgets
    • Overview
    • Document upload widget
      • Designing an upload flow
  • Guides
    • Verifying a new business
    • Verifying bank accounts
    • Uploading documents
    • Country-specific fields
    • Supported document types
  • API reference
    • Submissions
      • Reports
        • List available report templates
        • Download a report
      • Create new submission
        POST
      • Get submission
        GET
      • Update submission
        PUT
      • Update submission status
        PUT
      • Run a submission pre-flight check
        POST
      • Run business verification
        POST
      • Get submission checks
        GET
      • Delete submission
        DELETE
      • List submissions
        GET
    • Documents
      • Public documents API
        • List documents (public)
        • Upload document (public)
        • Get document (public)
        • Delete document (public)
        • Download document file (public)
        • Rerun validations (public)
      • List documents
      • Upload document
      • Get document
      • Delete document
      • Download document file
      • Rerun validations
    • RPC search
      • RPC search
      • Get company with ID
      • Look up company by RFC
      • Search companies by name
      • Download RPC document
    • Utilities
      • Matcher
        • Run name matching
  1. Submissions

Get submission

Production
https://api.niva.co/v1
Production
https://api.niva.co/v1
GET
https://api.niva.co/v1
/submissions/{id}
Returns the submission with the information you sent (inputs), its documents and, once processing has run, the business data Niva extracted and verified (business). id accepts the submission ID (sub_…) or your external_id.
Keys under business fill in as processing runs, so expect null and empty arrays on a new submission. The keys that depend on the market are listed under Country-specific fields.

Request

Authorization
Add parameter in header
apiKey
Example:
apiKey: ********************
Path Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.niva.co/v1/submissions/sub_3ZMd9KJnvAdYt4mOyW7YQRAp' \
--header 'Accept-Language: en' \
--header 'apiKey: <api-key>'

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",
  "inputs": {
    "applicant": {
      "first_name": "José Luis",
      "last_name": "Saavedra Ruiz",
      "tax_id": null,
      "email": "jose.saavedra@nuevavista.mx",
      "phone_country": null,
      "phone": "+52 55 1234 5678"
    },
    "legal_representatives": null,
    "legal_name": "Nueva Vista Alimentos S.A. de C.V.",
    "trade_name": "Nueva Vista",
    "entity_type": null,
    "website": "https://nuevavista.mx",
    "operating_address": "Av. Insurgentes Sur 1602, Crédito Constructor, Benito Juárez, 03940 Ciudad de México, CDMX",
    "nationality": "MEX",
    "custom": {
      "plan": "gold"
    }
  },
  "documents": [
    {
      "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": 15
      }
    },
    {
      "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": 15
      }
    }
  ],
  "business": {
    "tax_id_number": "NVA120409XD2",
    "tax_id_label": "rfc",
    "legal_name": "Nueva Vista Alimentos S.A. de C.V.",
    "entity_type": "Sociedad Anónima de Capital Variable",
    "incorporation_date": "2012-04-09",
    "industry": [
      "Elaboración de alimentos"
    ],
    "previous_legal_names": [],
    "merged_company_legal_names": [],
    "business_description": "Elaboración y comercialización de alimentos preparados.",
    "registration_details": {
      "fme": "N-2012012345",
      "jurisdiction": "Ciudad de México",
      "duration": "99 años",
      "objeto_social": {
        "raw": null,
        "credit_allowed": true,
        "commercial_contracts_allowed": true,
        "guarantee_third_parties_allowed": false
      }
    },
    "tax_status": {
      "sat_efirma_serial_number": null,
      "economic_activity": [
        {
          "order": 1,
          "percent": 100,
          "activity": "Elaboración de alimentos preparados",
          "start_date": "2012-05-01",
          "end_date": null
        }
      ],
      "geolocated_address": {
        "formatted": "Av. Insurgentes Sur 1602, Crédito Constructor, Benito Juárez, 03940 Ciudad de México, CDMX",
        "place_id": null,
        "latitude": null,
        "longitude": null,
        "google_maps_link": null
      },
      "address": {
        "formatted": "Av. Insurgentes Sur 1602, Crédito Constructor, Benito Juárez, 03940 Ciudad de México, CDMX",
        "exterior_number": null,
        "interior_number": null,
        "street_type": null,
        "street_name": null,
        "colony": null,
        "city": null,
        "state": null,
        "postal_code": null,
        "locality": null,
        "cross_street_1": null,
        "cross_street_2": null
      },
      "tax_regimes": [
        {
          "regime": "Régimen General de Ley Personas Morales",
          "start_date": "2012-05-01",
          "end_date": null
        }
      ],
      "tax_id_number": "NVA120409XD2",
      "tax_id_label": "rfc",
      "status": "active"
    },
    "legal_representatives": [
      {
        "name": "Jorge Ramírez Torres",
        "nationality": "MEX",
        "date_of_birth": "1978-01-01",
        "title": "Administrador Único",
        "normalized_title": "Administrador Único",
        "appointed": "2012-04-09",
        "removed": null,
        "entity_type": "person",
        "powers": [
          {
            "type": "administrative",
            "authorization": "individual",
            "max_amount": null,
            "limitations": [],
            "power": "Administración",
            "limitation": null
          },
          {
            "type": "banking",
            "authorization": "individual",
            "max_amount": null,
            "limitations": [],
            "power": "Bancaria",
            "limitation": null
          }
        ],
        "nationality_country_code": "MX",
        "tax_id_number": "RATJ780101XY2",
        "tax_id_label": "rfc",
        "curp": "RATJ780101HDFMRR05",
        "management_type": null
      }
    ],
    "owners": [
      {
        "entity_type": "person",
        "type": "person",
        "name": "María Fernanda López García",
        "nationality": "MEX",
        "date_of_birth": "1985-03-15",
        "total_value": null,
        "tax_id_number": "LOGM850315AB1",
        "tax_id_label": "rfc",
        "fixed_capital_value": 60000.0,
        "variable_capital_value": 0,
        "shares": [
          {
            "type": "fixed",
            "name": "Serie A",
            "number": 600,
            "price_per_share": "100.0",
            "value": "60000.0"
          }
        ],
        "nationality_country_code": "MX",
        "ownership_percentage": null,
        "curp": "LOGM850315MDFPRR09"
      }
    ]
  }
}
🟠401Unauthorized
🟠404Not Found
🔴500Internal Server Error
Previous
Create new submission
Next
Update submission