Submit business verification

curl --request POST \
  --url https://sandbox.voice.miraiminds.co/v2/telephony/onboarding \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account": "mirai",
  "number_type": "local",
  "version": 0,
  "request_id": "business-verification-local-2026-10-02",
  "consent": true,
  "application": {
    "requirement_id": "9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83",
    "business": {
      "name": "Mirai Motors Private Limited",
      "email": "accounts@example.com",
      "address_line1": "4th Floor, Example House, 12 MG Road",
      "address_line2": "Camp",
      "city": "Pune",
      "state": "Maharashtra",
      "postal_code": "411001",
      "registration_number": "27AAACM1234A1Z5"
    },
    "documents": [
      {
        "document_type_id": "3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60",
        "data_fields": {
          "business_name": "Mirai Motors Private Limited",
          "date_of_incorporation": "2019-04-01"
        },
        "file_name": "certificate-of-incorporation.pdf",
        "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
      },
      {
        "document_type_id": "7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85",
        "data_fields": {},
        "file_name": "letter-of-authorisation.pdf",
        "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
      }
    ]
  }
}
'

import requests

url = "https://sandbox.voice.miraiminds.co/v2/telephony/onboarding"

payload = {
    "account": "mirai",
    "number_type": "local",
    "version": 0,
    "request_id": "business-verification-local-2026-10-02",
    "consent": True,
    "application": {
        "requirement_id": "9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83",
        "business": {
            "name": "Mirai Motors Private Limited",
            "email": "accounts@example.com",
            "address_line1": "4th Floor, Example House, 12 MG Road",
            "address_line2": "Camp",
            "city": "Pune",
            "state": "Maharashtra",
            "postal_code": "411001",
            "registration_number": "27AAACM1234A1Z5"
        },
        "documents": [
            {
                "document_type_id": "3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60",
                "data_fields": {
                    "business_name": "Mirai Motors Private Limited",
                    "date_of_incorporation": "2019-04-01"
                },
                "file_name": "certificate-of-incorporation.pdf",
                "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
            },
            {
                "document_type_id": "7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85",
                "data_fields": {},
                "file_name": "letter-of-authorisation.pdf",
                "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
            }
        ]
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://sandbox.voice.miraiminds.co/v2/telephony/onboarding';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account: 'mirai',
    number_type: 'local',
    version: 0,
    request_id: 'business-verification-local-2026-10-02',
    consent: true,
    application: {
      requirement_id: '9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83',
      business: {
        name: 'Mirai Motors Private Limited',
        email: 'accounts@example.com',
        address_line1: '4th Floor, Example House, 12 MG Road',
        address_line2: 'Camp',
        city: 'Pune',
        state: 'Maharashtra',
        postal_code: '411001',
        registration_number: '27AAACM1234A1Z5'
      },
      documents: [
        {
          document_type_id: '3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60',
          data_fields: {
            business_name: 'Mirai Motors Private Limited',
            date_of_incorporation: '2019-04-01'
          },
          file_name: 'certificate-of-incorporation.pdf',
          content_base64: 'JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=='
        },
        {
          document_type_id: '7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85',
          data_fields: {},
          file_name: 'letter-of-authorisation.pdf',
          content_base64: 'JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=='
        }
      ]
    }
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "id": "tbo_01K9N4R7T0W3Y6B9D2G5J8M1P4",
  "account": "mirai",
  "number_type": "local",
  "state": "submitted",
  "compliance_id": "4f1a9c2e-7b3d-4e8a-9c61-2d5f8b0e3a17",
  "request_id": "business-verification-local-2026-10-02",
  "version": 3,
  "setup_state": "not_started"
}

{
  "error": {
    "code": "invalid_application",
    "message": "Verification requirements changed. Reload the form before submitting."
  }
}

{
  "error": {
    "code": "verification_in_progress",
    "message": "Refresh verification before submitting. An existing application may still be under review."
  }
}

Telephony

Submit business verification

Sends your business details and documents to Plivo for review. It doesn’t buy a number or charge your wallet. The documents go to Plivo; Mirai doesn’t keep a copy.

Replace every value below with your own. The example document is a placeholder. Give one documents entry per item in Get verification requirements (at most four), with that item’s document_type_id and its required_fields in data_fields. Where proof_required is true, attach the file as content_base64 (PDF, JPEG or PNG, 5 MB each) with a file_name whose extension matches.

consent: true confirms you’re authorised to submit these for your business. version is 0 for a first application, otherwise the current one from Get business verification.

request_id is a unique id you choose. If the request is cut off, send exactly the same body again with the same request_id: it returns the application without uploading twice. Only a submission_failed or rejected application can be corrected, with a new request_id and all documents again.

Answers 202 with the application. Plivo’s review takes time; check on it with Refresh business verification.

POST

telephony

onboarding

Submit business verification

curl --request POST \
  --url https://sandbox.voice.miraiminds.co/v2/telephony/onboarding \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account": "mirai",
  "number_type": "local",
  "version": 0,
  "request_id": "business-verification-local-2026-10-02",
  "consent": true,
  "application": {
    "requirement_id": "9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83",
    "business": {
      "name": "Mirai Motors Private Limited",
      "email": "accounts@example.com",
      "address_line1": "4th Floor, Example House, 12 MG Road",
      "address_line2": "Camp",
      "city": "Pune",
      "state": "Maharashtra",
      "postal_code": "411001",
      "registration_number": "27AAACM1234A1Z5"
    },
    "documents": [
      {
        "document_type_id": "3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60",
        "data_fields": {
          "business_name": "Mirai Motors Private Limited",
          "date_of_incorporation": "2019-04-01"
        },
        "file_name": "certificate-of-incorporation.pdf",
        "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
      },
      {
        "document_type_id": "7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85",
        "data_fields": {},
        "file_name": "letter-of-authorisation.pdf",
        "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
      }
    ]
  }
}
'

import requests

url = "https://sandbox.voice.miraiminds.co/v2/telephony/onboarding"

payload = {
    "account": "mirai",
    "number_type": "local",
    "version": 0,
    "request_id": "business-verification-local-2026-10-02",
    "consent": True,
    "application": {
        "requirement_id": "9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83",
        "business": {
            "name": "Mirai Motors Private Limited",
            "email": "accounts@example.com",
            "address_line1": "4th Floor, Example House, 12 MG Road",
            "address_line2": "Camp",
            "city": "Pune",
            "state": "Maharashtra",
            "postal_code": "411001",
            "registration_number": "27AAACM1234A1Z5"
        },
        "documents": [
            {
                "document_type_id": "3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60",
                "data_fields": {
                    "business_name": "Mirai Motors Private Limited",
                    "date_of_incorporation": "2019-04-01"
                },
                "file_name": "certificate-of-incorporation.pdf",
                "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
            },
            {
                "document_type_id": "7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85",
                "data_fields": {},
                "file_name": "letter-of-authorisation.pdf",
                "content_base64": "JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=="
            }
        ]
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const url = 'https://sandbox.voice.miraiminds.co/v2/telephony/onboarding';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account: 'mirai',
    number_type: 'local',
    version: 0,
    request_id: 'business-verification-local-2026-10-02',
    consent: true,
    application: {
      requirement_id: '9a3c5e71-2b4d-4f86-a1c9-7e0d2f4b6a83',
      business: {
        name: 'Mirai Motors Private Limited',
        email: 'accounts@example.com',
        address_line1: '4th Floor, Example House, 12 MG Road',
        address_line2: 'Camp',
        city: 'Pune',
        state: 'Maharashtra',
        postal_code: '411001',
        registration_number: '27AAACM1234A1Z5'
      },
      documents: [
        {
          document_type_id: '3b6f0d2a-8c41-4e7b-a5d9-1f2e3c4b5a60',
          data_fields: {
            business_name: 'Mirai Motors Private Limited',
            date_of_incorporation: '2019-04-01'
          },
          file_name: 'certificate-of-incorporation.pdf',
          content_base64: 'JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=='
        },
        {
          document_type_id: '7d2e9b14-5a63-4c08-b1f7-6e3a0c9d2b85',
          data_fields: {},
          file_name: 'letter-of-authorisation.pdf',
          content_base64: 'JVBERi0xLjQKJSBQbGFjZWhvbGRlcjogcmVwbGFjZSBjb250ZW50X2Jhc2U2NCB3aXRoIHlvdXIgcmVhbCBkb2N1bWVudCwgYmFzZTY0LWVuY29kZWQuCg=='
        }
      ]
    }
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "id": "tbo_01K9N4R7T0W3Y6B9D2G5J8M1P4",
  "account": "mirai",
  "number_type": "local",
  "state": "submitted",
  "compliance_id": "4f1a9c2e-7b3d-4e8a-9c61-2d5f8b0e3a17",
  "request_id": "business-verification-local-2026-10-02",
  "version": 3,
  "setup_state": "not_started"
}

{
  "error": {
    "code": "invalid_application",
    "message": "Verification requirements changed. Reload the form before submitting."
  }
}

{
  "error": {
    "code": "verification_in_progress",
    "message": "Refresh verification before submitting. An existing application may still be under review."
  }
}

Authorizations

Authorization

string

header

required

Your workspace secret key, sk_live_ followed by 32 hex characters. Create one in the console under Developers.

Body

application/json

account

string

required

application

object

required

Show child attributes

number_type

string

required

request_id

string

required

version

integer

required

Response

Sent to Plivo for review

Get started

Agents

Calls

Flows

Tools and secrets

Campaigns

Do-not-call list

Phone numbers

Phone pools

Telephony

Transcriptions

Speech to text

Text to speech

Wallet

Reference

Submit business verification

Authorizations

Body

Response