Bulk CIN Verification — Company Batch Check
Verify multiple Corporate Identification Numbers in one batch. Get company names, registration status, and details at scale.
curl -X POST "https://production.deepvue.tech/v1/verification/mca/cin/batch?webhook_url=example_string" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY" \
--form batch_file=example_string
import requests
import json
url = "https://production.deepvue.tech/v1/verification/mca/cin/batch?webhook_url=example_string"
headers = {
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
data = {
"batch_file": "example_string"
}
response = requests.post(url, headers=headers, data=data)
print(response.json())
const formData = new FormData();
formData.append("batch_file", "example_string");
const response = await fetch("https://production.deepvue.tech/v1/verification/mca/cin/batch?webhook_url=example_string", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
},
body: formData
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"mime/multipart"
)
func main() {
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
writer.WriteField("batch_file", "example_string")
writer.Close()
req, err := http.NewRequest("POST", "https://production.deepvue.tech/v1/verification/mca/cin/batch?webhook_url=example_string", body)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Content-Type", writer.FormDataContentType())
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/mca/cin/batch?webhook_url=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
request.set_form([
["batch_file", "example_string"]
], 'multipart/form-data')
response = http.request(request)
puts response.body
{
"transaction_id": "51cd8b6ab36d46a98afb2f01e856e89a",
"timestamp": 1732088933797,
"code": 200,
"message": "Batch Upload status fetched successfully",
"sub_code": "SUCCESS",
"data": {
"request_id": "06d0d7c340ed460d96103aaa0b26f0de",
"status": 200,
"product_id": "",
"message": "batch processing completed",
"batch_output_file_url": "https://bulk-data-processing.s3.ap-south-1.amazonaws.com/upi-basic-batch-output-files/06d0d7c340ed460d96103aaa0b26f0de.csv"
}
}
{
"transaction_id": "8263c58f81d54cb3a8053ac22afefa4e",
"timestamp": 1732103344104,
"code": 200,
"message": "Batch Upload status fetched successfully",
"sub_code": "SUCCESS",
"data": {
"request_id": "673f7487fc0e4949b54e443a0bcc767d",
"status": 201,
"product_id": "",
"message": "batch processing in progress",
"batch_output_file_url": null
}
}
{
"detail": "Bad Request"
}
{
"detail": "Not authenticated"
}
{
"detail": "Invalid client_id, access Denied"
}
{
"detail": "Could not validate credentials"
}
{
"detail": "Incorrect client_id or client_secret"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": 1732002741216,
"transaction_id": "88e4835cf10647b599ee675a473cddfd",
"sub_code": "INVALID_REQUEST_ID",
"message": "Invalid Request ID"
}
{
"detail": "Internal Server Error"
}
/v1/verification/mca/cin/batch
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
The media type of the request body
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Body
Responses
Overview
This API enables bulk verification of Corporate Identity Numbers (CIN) through an asynchronous processing model. You submit a CSV batch file containing CIN data, receive a request ID for tracking, and processing occurs in the background. Upon completion, verified results are sent to your configured webhook URL.
You can optionally specify a webhook_url parameter to override the default registered endpoint for a specific request.
Input files must contain fewer than 1,000 records.
The batch can return in two states: Completed (results available at the provided batch output file URL) or In Progress (still processing -- retry later or monitor the webhook).
Last updated 4 weeks ago
Built with Documentation.AI