Getting started

Welcome to the Niva API! Our API enables you to seamlessly integrate business verification into your own applications, platforms, or workflows.

It allows you to:

Submit business information for verification

Upload and validate necessary documents

Track the status of verification requests

Receive real-time updates on verification progress

Prerequisites

Before you begin, ensure you have:

A Niva account with API access

Your unique API token

Basic knowledge of RESTful APIs and HTTP requests

Authentication

All requests to the Niva API must be authenticated. Include your API token in the apiKey header of each request:

apiKey: YOUR_API_TOKEN

For more details, see our Authentication guide.

Base URL

Use the following base URL for all API requests:

Production: https://api.niva.co/v1

Demo: https://api.niva-demo.com/v1

Making Your First API Call

Let's create a new submission to verify a business:

Example request body:

{
  "country": "MX",
  "business_type": "legal_entity",
  "legal_name": "Acme Inc.",
  "trade_name": "Acme Trading",
  "rfc": "NVA120490XD2",
  "website": "https://acme.co.mx",
  "operating_address": "Prolongación Caridad 0, 48913 Zaragoza, Nav",
  "applicant": {
    "first_name": "José Luis",
    "last_name": "Saavedra",
    "email": "Miguel0@gmail.com",
    "phone": "+52 23-22-54-23-45"
  }
}

This will return a submission ID, which you'll use in subsequent API calls.

Next Steps

Learn how to upload documents and complete the verification process in our Verifying a business guide.

Set up webhooks to receive real-time updates about your submissions. See our Webhooks guide.

Explore our API Reference for detailed endpoint information.

Error Handling

The API uses standard HTTP response codes. In case of an error, the response body will contain more details about the error.

Support

If you need assistance or have any questions about integrating our API, please contact our support team at support@niva.co.

Getting started

Prerequisites#

Authentication#

Base URL#

Making Your First API Call#

Next Steps#

Error Handling#