Save business details
Saves your business details once, to reuse for every number application. Documents are not part of this record and are never stored.
Replace every value below with your own. Send version 0 for the first save, then the version you last read. Send every field: entity_type (company, llp, partnership or proprietorship), legal_name, email, address_line1, city, state and postal_code are required; the rest may be empty. PAN and GSTIN are upper-cased, and a GSTIN must contain the PAN (a GSTIN alone fills the PAN in). phone is an India mobile, saved as +91 and ten digits.
A field the API can’t accept is 400 naming it (details.<field>: what is wrong). If someone saved since you read it, the answer is 409 conflict: read it again and retry. A sub-workspace that saves here gets its own record.
curl --request PUT \
--url https://sandbox.voice.miraiminds.co/v2/business-verification \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"version": 0,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
}
}
'import requests
url = "https://sandbox.voice.miraiminds.co/v2/business-verification"
payload = {
"version": 0,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/business-verification';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
version: 0,
details: {
entity_type: 'company',
legal_name: 'Mirai Motors Private Limited',
pan: 'AAACM1234A',
gstin: '27AAACM1234A1Z5',
registration_number: 'U34100PN2019PTC123456',
email: 'accounts@example.com',
phone: '+919876543210',
address_line1: '4th Floor, Example House, 12 MG Road',
address_line2: 'Camp',
city: 'Pune',
state: 'Maharashtra',
postal_code: '411001',
signatory_name: 'Asha Rao'
}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": "bkv_01K9N2P5R8T1W4Y7B0D3G6J9M2",
"version": 1,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
},
"details_source": "saved",
"editable": true,
"number_types": [
{
"type": "landline",
"state": "in_review",
"provider_state": "submitted",
"onboarding_id": "tbo_01K9N4R7T0W3Y6B9D2G5J8M1P4",
"verification_source": null,
"missing": []
},
{
"type": "mobile",
"state": "unavailable",
"provider_state": "",
"onboarding_id": "",
"verification_source": null,
"missing": []
}
]
}curl --request PUT \
--url https://sandbox.voice.miraiminds.co/v2/business-verification \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"version": 0,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
}
}
'import requests
url = "https://sandbox.voice.miraiminds.co/v2/business-verification"
payload = {
"version": 0,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/business-verification';
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
version: 0,
details: {
entity_type: 'company',
legal_name: 'Mirai Motors Private Limited',
pan: 'AAACM1234A',
gstin: '27AAACM1234A1Z5',
registration_number: 'U34100PN2019PTC123456',
email: 'accounts@example.com',
phone: '+919876543210',
address_line1: '4th Floor, Example House, 12 MG Road',
address_line2: 'Camp',
city: 'Pune',
state: 'Maharashtra',
postal_code: '411001',
signatory_name: 'Asha Rao'
}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": "bkv_01K9N2P5R8T1W4Y7B0D3G6J9M2",
"version": 1,
"details": {
"entity_type": "company",
"legal_name": "Mirai Motors Private Limited",
"pan": "AAACM1234A",
"gstin": "27AAACM1234A1Z5",
"registration_number": "U34100PN2019PTC123456",
"email": "accounts@example.com",
"phone": "+919876543210",
"address_line1": "4th Floor, Example House, 12 MG Road",
"address_line2": "Camp",
"city": "Pune",
"state": "Maharashtra",
"postal_code": "411001",
"signatory_name": "Asha Rao"
},
"details_source": "saved",
"editable": true,
"number_types": [
{
"type": "landline",
"state": "in_review",
"provider_state": "submitted",
"onboarding_id": "tbo_01K9N4R7T0W3Y6B9D2G5J8M1P4",
"verification_source": null,
"missing": []
},
{
"type": "mobile",
"state": "unavailable",
"provider_state": "",
"onboarding_id": "",
"verification_source": null,
"missing": []
}
]
}