KYB document classification API
Introduction
This API enables users to categorize various KYB documents, including Business PAN(Income Tax Department), Certificate of Incorporation, FSSAI (Food Safety and Standards Authority of India) certificates, GST Registration Certificates, Import Export Certificates, Memorandum of Association (MOA) and Articles of Association (AOA), Shop and Establishment Registration, UDYAM and Udyog Aadhar.
API details
Endpoint
POST https://api.signzy.app/api/v3/id-classification/businessPOST https://api-preproduction.signzy.app/api/v3/id-classification/businessRequest headers
Name | Value | Required | Description |
|---|---|---|---|
Content-Type | application/json | Mandatory | The type of content that the request body contains. |
Authorization | XXXXXXXXXXXXXXX | Mandatory | An authentication token to authorize the request. Reach out to the Signzy support team to get one created. |
Request body parameters
Parameter | Data type | Description | Required |
|---|---|---|---|
file | String | A URL of the image. | Mandatory |
{
"file":"https://persist.signzy.tech/api/files/944450379/download/33178be150604f62b0df874d8d682cf984ddb737a46e4c709050a1931450924c.png"
}Code samples
curl --location 'https://api-preproduction.signzy.app/api/v3/id-classification/business' \
--header 'Content-Type: application/json' \
--header 'Authorization: <AUTH_KEY>' \
--data '{"file":["https://persist.signzy.tech/api/files/949794811/download/1684a7f93d1740619115083f3bd09b3b78538dfb9f804240a757c91835987032.png"]}'Response body parameters
Parameter | Data Type | Description |
|---|---|---|
docType | String | Type of Business Document (Business PAN(Income Tax Department), Certificate of Incorporation, FSSAI (Food Safety and Standards Authority of India), GST Registration Certificates, Import Export Certificates, Memorandum of Association (MOA) and Articles of Association (AOA), Shop and Establishment Registration, UDYAM and Udyog Aadhar) |
Error Code
Code | Status | Description |
|---|---|---|
200 | Success | Type of Business Document |
400 | Bad Request | Invalid request format or missing required parameters. |
422 | Invalid Input | Invalid Input |
500 | Internal Server Error | Something is broken. This is usually a temporary error, for example in a high-load situation.or if an endpoint is temporarily having issues. Try again later. |
{
"docType": "Import Export Certificate"
}Success Rate
Business Document | Success Rate |
|---|---|
Business Pan(Income Tax Department) | 100% |
Certificate of Incorporation | 100% |
FSSAI | 100% |
GST Registration Certificate | 100% |
Import Export Certificate | 100% |
Memorandum of Association (MOA) and Articles of Association (AOA) | 99.5% |
Shop and Establishment Registration | 100% |
UDYAM and Udyog Aadhar | 100% |
Notes
Rejection outputs (3):
- invalid_handwritten — entire document is handwritten on blank paper, no official structure
- invalid_self_declared — company's own letter/declaration listing registration details, not government-issued
- invalid_unclassified — doesn't match any category or lacks authenticity markers
Valid classification outputs (12):
- Business Pan (Income tax department)
- Trade License
- Municipal corporation
- Contract Labour Regular and Abolition
- ITR
- Certificate of Incorporation
- FSSAI (Food Safety and Standards Authority of India)
- GST Registration Certificate
- Import Export Certificate
- Memorandum of Association (MOA) and Articles of Association (AOA)
- Shop and Establishment Registration
- UDYAM and Udyog Aadhar
Multi-label examples (comma-separated):
- Trade License, Municipal corporation
- Trade License, Shop and Establishment Registration
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!