{"info":{"_postman_id":"28a74a0f-2a52-47f9-80ef-5c13f6990dd3","name":"Subex IDC APIs v1.80.0","description":"

IDcentral (IDC)

IDcentral's identity analytics solution assists companies in delivering a seamless and secure customer experience while preventing fraud. A key challenge faced by companies today is balancing customer satisfaction with cybersecurity. Our solution utilizes multiple data sources to verify true identities without unnecessary data collection, simplifying the digital onboarding process. Moreover, it enhances sales conversions by leveraging over 200 data attributes for decision-making. For seamless integration with third-party applications, IDcentral offers powerful REST APIs for instant verification. These user-friendly endpoints empower developers to create custom onboarding applications for various scenarios. Additionally, IDcentral seamlessly integrates with existing applications and workflows, safeguarding against identity fraud, forgery, and spamming.

Modes Of Accessing the Services

Restful API - Our API is optimized for automation, offering scalability and high availability. It is particularly well-suited for integrating with app and web app workflows, making it an ideal solution for businesses looking to automate processes.
\n
Client Portal - Our Client Portal is a user interface which provides a simple and intuitive platform for real-time data verification. It is particularly well-suited for manual and small-scale checks, enabling quick and easy verification of data.
\n

IDcentral's services are available to registered legal entities worldwide, ensuring global accessibility for businesses seeking our solutions.

Registration Quickstart

To request an account with IDcentral, please visit our Contact Us page and provide your name, company name, official email ID, and contact number. After discussing your requirements, we will share the link to our portal. The sign-up process requires verification of your business email, and a one-time password will be sent to the email you provided for this purpose.

Once your account is created, you will be able to generate an API key from the IDC-Client portal. Separate API keys will be provided for the Sandbox and Production environment. You can access the API documentation from the Client portal as well. For further information, please contact us at support@idcentral.io.

Base URL

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Environment	URL
Sandbox
Production	https://api.idcentral.io/idc

(Note: Production URL has been shown as 'baseUrl' in endpoint URL)

Endpoints

To access the API, users can make HTTP requests to a designated endpoint URL, where GET or POST variables are used to specify the desired information. All endpoints are accessible via SSL-enabled HTTPS to ensure secure communication.

The IDcentral API utilizes appropriate HTTPS methods for every action to ensure secure and reliable data transmission between the client and the server.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Method	Description
GET	GET is used to request data from a specified resource
POST	POST is used to send data to a server to create/update a resource
DELETE	DELETE is used to delete data from the resource

Authentication

To access the IDcentral API, the API key must be passed in the request header. The API key is provided upon request by the IDcentral team, and users can reach out to support@idcentral.io to obtain it. However, it is important to note that the API key should not be exposed on browser applications. If a browser application is being used, it is recommended to set up the API calls from the server side to ensure the security of the API key.

Errors and Status Codes

IDcentral uses HTTP status codes to indicate the status of an API call, standard HTTP status code conventions are -

Status codes in the 2xx range mean success.
\n
Status codes in the 4xx range means there was an error in the provided information.
\n
Status Codes in the 5xx range indicate server-side errors.
\n

Scenario	Status Code	Response Code	Status	Message	Error
When the request has been successfully processed. This Indicates that the request has succeeded.	200	1	success	Successful Request
If the request has been processed successfully but a response other than the expected HTTP status code for a valid successful scenario has been received.	200	2-8 (Note: Response codes range from 2-8 indicate that request has been processed successfully but scenarios outside Status Code ”200” and Response Code “1” will be mapped.	success	Successful Request
When request has been processed successfully but new response message / response code received. (All the mismatch error)	200	9	success
When user exited the journey.	200	10	failed	Note: API specific message will be shown	Note: API specific message will be shown
When invalid input has been entered.	400	-1	failed	Note: API specific message will be shown	Note: API specific message will be shown
When invalid credentials are given.	401	70	failed	Note: API specific message will be shown	Authentication Failed
When no access has been provided to the user for particular API which user is trying.	401	71	failed	Please Contact Administrator for Access	No access
When JWT token has expired.	401	72	failed		Token expired
When account balance is exhausted.	401	80	failed	Kindly contact for assistance	Account balance exhausted
When invalid endpoint URL is passed.	404	0	failed
When invalid request method is passed.	405	0	failed	The request URL does not support the request method [METHOD NAME] used, use [METHOD NAME]	Request method invalid
When rate limit threshold is hit.	429	60	failed	Note: API specific message will be shown	Rate Limited
When unexpected internal server error occurs.	500	88	failed		Internal Error
When unexpected error from partner / source occurs.	500	99	failed

(Note: Above errors are considered to be generic or common errors and may not
necessarily apply to every API provided by IDcentral. It is important to note
that each API may have its own unique set of errors and error codes. These
individual errors have been mentioned in the API documentation provided for
each independent API.)

Backwards Compatibility

The following modifications are classified as being backward compatible:

Introducing new API endpoints.
\n
Adding fresh attributes to the responses generated by existing API endpoints.
\n
Appending optional parameters to the existing API endpoints.
\n
Modifying the format or length of IDs.
\n
Amending the message attributes communicated in case of validation failures or other errors.
\n
Dispatching webhooks for new event types.
\n
Rearranging the properties returned by the existing API endpoints.
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"IDcentral (IDC)","slug":"idcentral-idc"}],"owner":"32415637","collectionId":"28a74a0f-2a52-47f9-80ef-5c13f6990dd3","publishedId":"2sA3e2fUhy","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-07-09T07:23:10.000Z"},"item":[{"name":"Aadhaar","item":[{"name":"Offline Aadhaar KYC","item":[{"name":"Aadhaar - Generate OTP","id":"d673fc51-1af8-48e3-9218-4e900d6f4766","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"{{aadhaar_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp","description":"

In order to obtain the details of an Aadhaar holder from the Aadhaar database, it is necessary to obtain the consent of the said holder. This consent is typically provided in the form of a One-Time Password (OTP). To initiate this process, one must use the Aadhaar - Generate OTP, which will send an OTP to the Aadhaar-linked mobile number of the customer.

Upon initiating the Aadhaar - Generate OTP process, a response will be generated indicating whether the OTP has been successfully sent. Additionally, a unique client ID will be provided, which is required to validate the OTP and authenticate the Aadhaar details.

It is important to note that the OTP generated through the Aadhaar - Generate OTP process is valid for a duration of 10 minutes. After this period has elapsed, it is necessary to recall the API in order to authenticate the Aadhaar card.

Best Practices for Generating OTP

If the response generated by the API is 'success', with a status code of 200 and a response code of 1, users are advised to wait for a period of 60 seconds before attempting to generate a new OTP for the same Aadhaar using the Generate OTP API. This scenario typically occurs when an OTP has been successfully generated but has not been received by the user.
\n
If the response generated by the API is 'failed', the client may retry the API immediately without any delay.
\n
Generated OTP is valid for a period of 10 minutes only.
\n

OKYC Health Score: This refers to the health score of Offline Aadhaar KYC which defines its success rate. This gives the score in the range 0 to 10.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Score	Health Status	Description
1-3	Bad	The success rate is low.
4-6	Average	The success rate is Average.
7-10	Good	The success rate is high.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	aadhaar_number	String	Required	Aadhaar Number

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	client_id	String	A uniquely generated reference ID, which is used in the OKYC-Submit OTP API
8.2	otp_sent	Boolean	This Key field confirms whether OTP has been sent to registered mobile number or not. . If value is 'true' then OTP has been sent successfully and if value is 'false' then OTP has not been sent
8.3	if_number	Boolean	This Key field confirms whether the given Aadhaar number is linked to a mobile number or not. If the value is 'true', then the Aadhaar is linked with the mobile number. Conversely, if the value is 'false', then the Aadhaar is not linked to any mobile number
8.4	valid_aadhaar	Boolean	This Key field confirms whether the given Aadhaar number a is valid Aadhaar number or not. If the value is 'true', then the given Aadhaar number is valid and if the value is 'false', then the given Aadhaar number is not valid
9	okyc_health	Integer	This refers to the health score of Offline Aadhaar KYC

Covered Scenarios:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Invalid Aadhaar is entered (Less then or more than 12 digits)	400	-1	failed	Please provide a valid Aadhaar number	Validation error
When OTP is successfully generated with valid Aadhaar number	200	1	success	OTP sent
When mobile number is not linked with Aadhaar	200	2	success	Mobile number not linked with aadhaar number	Mobile not linked
When Invalid Aadhaar is entered (12 digits)	200	3	success	Please provide a valid Aadhaar number	Invalid Aadhaar number
When UID is locked	200	4	success	Please unlock Aadhar from the UIDAI portal	UID Locked
When user tries to generate OTP within 60 seconds from the previously generated OTP	429	61	success	OTP is already generated for the given Aadhaar number, please try again after 60sec	Rate Limited

","urlObject":{"path":["v2","aadhaar","okyc","generate-otp"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"6e2fb6f5-e557-4240-b34c-bc4c265a921c","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"aadhaar_number\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 09:10:16 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_generate_otp_kDZiIPuvAsOXOAcsFANO\",\n \"timestamp\": 1681895408750,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"OTP sent\",\n \"data\": {\n \"client_id\": \"aadhaar_v2_LuwacQvQBpwlIccCxYni\",\n \"otp_sent\": true,\n \"if_number\": true,\n \"valid_aadhaar\": true\n },\n \"okyc_health\": 5\n}"},{"id":"01311d50-15da-43f9-9c07-f4feb2a66364","name":"Invalid Aadhaar Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"invalid_aadhaar_number\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 09:04:43 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_generate_otp_H8AQxMsil0RfOULfoLkA\",\n \"timestamp\": 1681895083187,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Invalid Aadhaar number\",\n \"message\": \"Please provide a valid Aadhaar number\",\n \"data\": null,\n \"okyc_health\": 5\n}"},{"id":"09e3e774-c535-49a0-b0f4-505cb55e6a06","name":"Rate Limit","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"aadhaar_number\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 08:56:15 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_generate_otp_5Rav9XfPRgsgxT8R7lD4\",\n \"timestamp\": 1681894510625,\n \"status\": \"success\",\n \"status_code\": 429,\n \"response_code\": 61,\n \"error\": \"Rate limited\",\n \"message\": \"OTP is already generated for the given Aadhaar number, please try again after 60sec\",\n \"data\": null,\n \"okyc_health\": 5\n}"},{"id":"8e555326-5060-453c-b8d6-a5581b23c8a6","name":"Upstream error","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"aadhaar_number\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 09:17:12 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_generate_otp_f8DrojMPEvGpu8l3R00d\",\n \"timestamp\": 1681895761957,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Upstream error\",\n \"message\": \"UIDAI servers aren't responding, please try again later\",\n \"data\": null,\n \"okyc_health\": 5\n}"},{"id":"01c3f336-667a-4e6b-a515-fad80f6d0d98","name":"Mobile number not linked","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"aadhaar_number\": \"aadhaar_number\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/generate-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 09:40:01 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_generate_otp_8X42MGCP3XvHK4FcmEAg\",\n \"timestamp\": 1681897194350,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Mobile not linked\",\n \"message\": \"Mobile number is not linked with Aadhaar number\",\n \"data\": null,\n \"okyc_health\": 5\n}"}],"_postman_id":"d673fc51-1af8-48e3-9218-4e900d6f4766"},{"name":"Aadhaar - Submit OTP","id":"f50e60ed-9b0b-47be-aeaa-274f4327af1f","protocolProfileBehavior":{"disabledSystemHeaders":{"content-type":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_PZxJnJcBghkZvzYBzQtv\",\r\n \"otp\": \"847751\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp","description":"

\"Aadhaar - Submit OTP\" API validates the OTP entered by the customer to authenticate with UIDAI. The aadhaar holder enters the OTP received on their aadhaar-linked mobile number. Once successfully validated, the aadhaar holder's details associated with the corresponding aadhaar number (such as name, address, mobile number, age, and date of birth) will be retrieved from the UIDAI Aadhaar database. The \"client_id\" generated from the \"Aadhaar - Generate OTP API\" request, along with the OTP received by the customer on their mobile number, should be passed as parameters in request body.

This API also validates the downloadable aadhaar XML file to read KYC information and authenticate it.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	client_id	String	Required	The client_id the user have received from Generate OTP - Aadhaar OKYC API response
2	otp	Integer	Required	The 6 digit OTP that is received on the registered mobile number for offline aadhaar verification

Response Details:

S. No	Key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully and a response is received. Conversely, if the value is \"failed\", it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched from the Aadhaar records
8.1	client_id	String	A uniquely generated reference ID, a customer receives from OKYC Generate-OTP
8.2	full_name	String	Full Name as per Aadhaar records
8.3	aadhaar_number	String	Aadhaar Number
8.4	dob	String	Date of Birth as per Aadhaar Records (yyyy-mm-dd)
8.5	gender	String	Gender as per aadhaar Records. If Male, it shows 'M' and if Female. it shows 'F'
8.6	address	Object	Address details as per Aadhaar records
8.6.1	country	String	Country of residence as per aadhaar records
8.6.2	dist	String	District as per aadhaar records
8.6.3	state	String	State as per aadhaar records.
8.6.4	po	String	Post Office as per aadhaar records
8.6.5	loc	String	Location as per aadhaar records
8.6.6	vtc	String	VTC (Village Town City) name as per aadhaar records
8.6.7	subdist	String	Sub-District / Taluka name as per aadhaar records
8.6.8	street	String	Street details as per aadhaar records
8.6.9	house	String	House No. as per aadhaar records
8.6.10	landmark	String	Landmark details as per aadhaar records
8.7	face_status	Boolean	If face found in the aadhaar XML file. If the value is \"true\" then it confirms the face is found and if \"false\" then it confirms the face is not found
8.8	face_score	Integer	Face score based on if face found in aadhaar XML found
8.9	zip	String	Pincode as per the aadhaar record
8.10	profile_image	String	Profile Image fetched from the shared XML file. The image file is in base64 format
8.11	has_image	String	This key parameter value confirms if aadhaar XML file has an image or not. Possible values can be \"true\" or \"false\"
8.12	raw_xml	String	AWS S3 path of aadhaar XML file
8.13	zip_data	String	AWS S3 path of aadhaar XML file in compressed format.
8.14	care_of	String	Care of (Father or Husband) person name of the aadhaar holder as per Aadhaar records
8.15	share_code	String	Share code of the aadhaar . This share is used to unlock the zipped XML file
8.16	mobile_verified	Boolean	Status of the mobile verification as per aadhaar records
8.17	reference_id	String	reference ID as per the aadhaar records
8.18	aadhaar_pdf	String	AWS S3 path of aadhaar XML file converted to PDF file

Covered Scenrios:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When empty client_id is passed	400	-1	failed	Pass the Client_id key value genearated in Generate OTP API	Client Id should be mandatory
When empty OTP is passed	400	-1	failed	Pass the OTP sent to the registered mobile number	OTP should be mandatory
When incorrect client_id is passed while submitting the OTP	400	-1	failed	Pass the Client_id key value genearated in Generate OTP API	Invalid Client Id
When correct OTP and client_id is passed	200	1	success	Successful Request
When incorrect OTP is passed	200	2	success	Invalid OTP, Please pass the valid OTP sent to the registered mobile number	Verification failed
When entering the same OTP multiple times	200	9	success	OTP Already Submitted	Verification failed
When you provide the OTP after session expired	200	9	success	OTP Session Expired	Verification failed
All other mismatch errors	200	9

","urlObject":{"path":["v2","aadhaar","okyc","submit-otp"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"942fc001-5d5d-4b52-a313-cf2334ee6254","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"client_id\",\r\n \"otp\": \"otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 10:15:39 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_submit_otp_DjsNjEU81UE0gLHuQ4eh\",\n \"timestamp\": 1681899331150,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"token\": null,\n \"client_id\": \"client_id\",\n \"full_name\": \"full_name\",\n \"aadhaar_number\": \"aadhaar_number\",\n \"dob\": \"yyyy-dd-mm\",\n \"gender\": \"F\",\n \"address\": {\n \"country\": \"India\",\n \"dist\": \"district\",\n \"state\": \"state\",\n \"po\": \"po\",\n \"loc\": \"Xxxxxxx\",\n \"vtc\": \"Xxxxxx\",\n \"subdist\": \"Xxxxxx\",\n \"street\": \"street\",\n \"house\": \"B-XX\",\n \"landmark\": \"landmark\"\n },\n \"face_status\": false,\n \"face_score\": -1,\n \"zip\": \"32XXXX\",\n \"profile_image\": \"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\",\n \"has_image\": true,\n \"raw_xml\": \"https://aadhaar-kyc-docs.s3.amazonaws.com/subex/aadhaar_xml/906520230419154537988/906520230419154537988-2023-04-19-101539207874.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5PAM3NMHW%2F20230419%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20230419T101539Z&X-Amz-Expires=432000&X-Amz-SignedHeaders=host&X-\",\n \"zip_data\": \"https://aadhaar-kyc-docs.s3.amazonaws.com/subex/aadhaar_xml/906520230419154537988/906520230419154537988-2023-04-19-101539141855.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5PAM3NMHW%2F20230419%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20230419T101539Z&X-Amz-Expires=432000&X-Amz-SignedHeaders=host&X-Amz-Sig\",\n \"care_of\": \"D/O Dhxxxxxxx Xxxxxxx\",\n \"share_code\": \"9xxxx\",\n \"mobile_verified\": false,\n \"reference_id\": \"906520230419154537988\",\n \"aadhaar_pdf\": null\n }\n}"},{"id":"93eee24b-bb22-4569-a843-6ae0caa369b6","name":"When empty client ID is passed","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"\",\r\n \"otp\": \"otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 10:22:21 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_submit_otp_VVwUVI9FiWESHr43WToK\",\n \"timestamp\": 1681899741800,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Client Id should be mandatory\",\n \"message\": \"Pass the Client_id key value genearated in Generate OTP API\",\n \"data\": null\n}"},{"id":"1cce736b-e0c4-4a68-9177-e6c3e98778ac","name":"When empty OTP is passed","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"client_id\",\r\n \"otp\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 11:00:01 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_submit_otp_F6eLGkhbkBFgp89ansia\",\n \"timestamp\": 1681902001876,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"OTP should be mandatory\",\n \"message\": \"Pass the OTP sent to the registered mobile number\",\n \"data\": null\n}"},{"id":"92a6e4b7-4b88-482f-a3a0-1932eb570fc8","name":"Invalid OTP","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"client_id\",\r\n \"otp\": \"invalid_otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 19 Apr 2023 11:01:07 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_submit_otp_GlaJ8yqmINN4Ag7J54UT\",\n \"timestamp\": 1681902066742,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid OTP, Please pass the valid OTP sent to the registered mobile number\",\n \"data\": null\n}"},{"id":"7450c2f7-f644-4783-bc4f-d752e096b0e3","name":"When incorrect Client ID is passed","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"incorrect_client_id\",\r\n \"otp\": \"otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 21 Apr 2023 07:03:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_submit_otp_W6ikrsk6gJ9tDRYwTQA1\",\n \"timestamp\": 1682060593508,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Invalid Client Id\",\n \"message\": \"Pass the Client_id key value genearated in Generate OTP API\",\n \"data\": null\n}"},{"id":"1a1c2a47-d653-44c3-a292-cd3783c7173b","name":"OTP Already Submitted","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"incorrect_client_id\",\r\n \"otp\": \"otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 21 Apr 2023 07:03:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_okyc_submit_otp_QzLdQhNHotxxxxx4clWcJH\",\n \"timestamp\": 1717657454197,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"error\": \"Verification failed\",\n \"message\": \"OTP Already Submitted\",\n \"data\": null\n}"},{"id":"d3380c4f-df32-4137-8071-445c02f90550","name":"OTP session expired","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"incorrect_client_id\",\r\n \"otp\": \"otp\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/okyc/submit-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 21 Apr 2023 07:03:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_okyc_submit_otp_sKLsBhVuKMEKbXhHrw44\",\n \"timestamp\": 1717658940891,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"error\": \"Verification failed\",\n \"message\": \"OTP Session Expired\",\n \"data\": null\n}"}],"_postman_id":"f50e60ed-9b0b-47be-aeaa-274f4327af1f"},{"name":"OKYC Health Score","id":"a470070b-805f-40c3-b491-4780de003b9f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/v2/okyc_status","description":"

API health score is a metric used to measure the overall health and performance of an application programming interface (API). It is a numerical value that provides an indication of how well an API is functioning and meeting its intended goals.

This API gives the health score of Offline Aadhaar KYC which defines its success rate . This gives the score in response which lies in between the range 0 to 10.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Score	Health Status	Description
1-3	Bad	The success rate is low.
4-6	Average	The success rate is Average.
7-10	Good	The success rate is high.

","urlObject":{"path":["v2","okyc_status"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"5cc8500d-858f-4057-9913-f9d768cc1044","name":"Successful Scenario","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/v2/okyc_status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 18 Apr 2023 09:46:07 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_okyc_health_v2_api_tGDPXyNPsr6yBpYSvYX4\",\n \"timestamp\": 1681811167206,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"okyc_health\": 5\n }\n}"}],"_postman_id":"a470070b-805f-40c3-b491-4780de003b9f"}],"id":"0f8eeedb-61ef-446f-b60a-6e42a5a0146f","description":"

What is Aadhaar OKYC?

UIDAI has launched Aadhaar Paperless Offline e-KYC Verification to allow Aadhaar number holders to voluntarily use it for establishing their identity in various applications in paperless and electronic fashion, while still maintaining privacy, security and inclusion. User gets XML document as an output.

IDcentral automates this process of offline XML verification. Businesses can use our solution to offer a platform to their end users for completing the aadhaar OKYC journey and complete the OVD (Officially valid document) verification.

To avail the service the user will have to share Aadhaar Number and OTP received on registered mobile number.

Offline Aadhaar KYC process to be completed using below APIs sequentially.

Generate OTP – This API is used to generate OTP on the Aadhaar number entered by the customer. If mobile number is linked with Aadhaar user will get an OTP.
Submit OTP – This API is used to submit the OTP received on the registered mobile number.
OKYC Health Score – This API is used to know the overall health of OKYC API.

Definition

Offline XML: Aadhaar XML is an electronic file that contains an individual's Aadhaar identification number, name, address, photograph, and other personal details. It is stored in XML format, which is a standardized format for storing and exchanging data across different systems and platforms. Aadhaar XML is used to verify an individual's identity online or to store and access personal information securely and in a standardized manner.
OVD Document: An officially valid document (OVD) is a document recognized and accepted by the Reserve Bank of India (RBI) as a valid proof of identity and address for availing financial services. OVDs include documents such as passport, PAN card, voter ID card, driving license, and Aadhaar card. These documents are issued by the government or its agencies and are considered reliable sources of information about an individual's identity and address.

\n","_postman_id":"0f8eeedb-61ef-446f-b60a-6e42a5a0146f"},{"name":"Basic Aadhaar Verification","id":"8ce6d05e-dd85-42a9-a732-02ef3e2cbc78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"\"}"},"url":"https://api.idcentral.io/idc/v2/aadhaar/aadhaar-verify","description":"

The Basic Aadhaar Verification API enables real-time verification of Aadhaar numbers. It is important to note that Aadhaar numbers are validated based on a specific sequence of digits, and not every 12-digit number is a genuine Aadhaar number.

In addition to verifying the accuracy of the Aadhaar number, this API also returns basic information such as gender, age range, the last three digits of the mobile number, and the state of registration address.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	aadhaar_number	String	Required	Unique 12-digit Aadhaar number

Response Model

S. No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
1.1	State	String	Confirms State of the Aadhaar card holder
1.2	age_band	String	It confirms the age band into which the customer falls into.
1.3	gender	String	Gender of a Aadhaar card holder
1.4	mobile	String	Registered mobile number with Aadhaar
1.5	aadhaar_number	String	Aadhaar number
1.6	aadhaar_exists	String	It confirms whether given Aadhaar number is valid or not
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
4	response_code	String	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	Integer	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	This text content explains the reason if API request has failed.
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	Staring	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid Aadhaar is entered	200	1	success	Successful Request
When incorrect Aadhaar is entered	200	2	success	We couldn't verify the given Aadhar number	verification_failed
When invalid Aadhaar is entered	400	-1	failed	Please Provide the Valid Aadhaar Number	Invalid Aadhar Number
All other mismatch errors	200	9	success

","urlObject":{"path":["v2","aadhaar","aadhaar-verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"8a06b6d1-6dd3-44cd-b05f-9ca647b7880a","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"465476564667\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/aadhaar-verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 06:00:04 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_verification_6ouM65qcQesrLzVJMylF\",\n \"timestamp\": 1682139838615,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"state\": \"Punjab\",\n \"age_band\": \"20-30\",\n \"gender\": \"FEMALE\",\n \"mobile\": \"*******577\",\n \"aadhaar_number\": \"465476564667\",\n \"aadhaar_exists\": \"true\"\n }\n}"},{"id":"ccd4dcf5-685a-4e73-902a-6418e0fc3ec7","name":"Internal Server Error","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"XXXXXXXXXXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/aadhaar-verify"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 06:00:04 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"timestamp\": \"2022-10-11T06:00:04.476+00:00\",\n \"status\": 500,\n \"error\": \"Internal Server Error\",\n \"message\": \"\",\n \"path\": \"/idc/v2/aadhaar/aadhaar-verify\"\n}"},{"id":"0decc2a2-d844-4850-ad7e-83440c72fa05","name":"Empty Aadhar","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"\"}"},"url":"https://api.idcentral.io/idc/v2/aadhaar/aadhaar-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 06:03:05 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_verification_icTdJ9jYMmKRE3W0C67n\",\n \"timestamp\": 1665468186020,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid Aadhaar number\",\n \"data\": null\n}"}],"_postman_id":"8ce6d05e-dd85-42a9-a732-02ef3e2cbc78"},{"name":"PAN Aadhaar Linking Status","id":"ab1770da-2548-4169-91e9-72a962c5a84a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"\", \"pan_number\": \"{{pan_number}}\"}"},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status","description":"

As per the circular issued by the Central Board of Direct Taxes (CBDT) in 2022, individuals who possess PAN numbers are mandated to link their PAN with Aadhaar. This API offers immediate verification of the linking status for a given combination of PAN and Aadhaar numbers.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	aadhaar_number	String	Required	Unique 12-digit Aadhaar number
2	pan	String	Required	PAN card number

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
1.1	message	String	This field confirms if the API request is successful or not and shows respective message
2	status_code	String	The http status code of the API. Refer Errors and Status Codes
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	response_code	String	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	error	String	The text content explains the reason if API request fails
6	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When user Aadhaar and PAN is successfully Linked	200	1	success	Successful Request
When given PAN is linked to another Aadhaar and given Aadhaar is not linked to any PAN	200	2	success	This PAN is linked to some other Aadhaar	Verification failed
When PAN is not valid or linked to not any Aadhaar	200	3	success	Either PAN is invalid or not linked to any Aadhar	Verification failed
When invalid Aadhaar is entered	200	4	success	Please enter a valid 12 digit Aadhaar number	Verification failed
All other mismatch errors	200	9	success

","urlObject":{"path":["v2","aadhaar","pan-linking-status"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"b824fca5-0598-495c-919c-217129fbd763","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********4341\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:45:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_SCW7tv8VQJpUFaeCysza\",\n \"timestamp\": 1665467112340,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"message\": \"Your PAN AYXXXXXX1P is already linked to given Aadhaar 37XXXXXXXX41\"\n }\n}"},{"id":"13d4fec0-754a-474b-99ad-da06e607b7e1","name":"Invalid PAN Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********4341\", \"pan_number\": \"******9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 10 Oct 2022 13:23:08 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_QsgdqQZJyYOB8WLh3CMH\",\n \"timestamp\": 1665408188956,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"f3ff32e6-f947-41db-97e4-63656dc1c6e2","name":"Pass Empty Aadhaar Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 10 Oct 2022 13:28:41 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_wuGjC7EpbhqvNN7XKEwq\",\n \"timestamp\": 1665408521576,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid Aadhaar number\",\n \"data\": null\n}"},{"id":"ff8cf548-f4b3-4133-a01a-2123cf5ee955","name":"Pass Empty PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********4341\", \"pan_number\": \"\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 10 Oct 2022 13:29:43 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_Im6hcaWUkD0uHzkrdtkV\",\n \"timestamp\": 1665408583403,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"9768db2f-f712-4dd2-b60f-ecb3ec466516","name":"Invalid Aadhar Number_Less than 12 digit","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"3782221843XXXX\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:17:57 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_MJYPEFnHn1H2nNuqYk7X\",\n \"timestamp\": 1665465477986,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid Aadhaar number\",\n \"data\": null\n}"},{"id":"2e61eb71-61f3-4141-ad87-2ae4af20eb34","name":"PAN Does Not Exist","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********7118\", \"pan_number\": \"A******01P\"}"},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:39:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_bh9aj65FS1Fo8eWNQYWR\",\n \"timestamp\": 1665466799178,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 4,\n \"error\": \"Verification failed\",\n \"message\": \"PAN does not exist\",\n \"data\": null\n}"},{"id":"b4fb95b2-7077-43cb-a7a8-9fdde7a09e92","name":"Invalid Aadhar Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"*******76119\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:43:02 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_toZPnZWjazVc9gpkxViY\",\n \"timestamp\": 1665466982301,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"Please enter a valid 12 digit Aadhaar number\",\n \"data\": null\n}"},{"id":"7404005f-3d06-41df-b167-6640816a48a0","name":"PAN Aadhar Linking Status","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********84341\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:45:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_SCW7tv8VQJpUFaeCysza\",\n \"timestamp\": 1665467112340,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"message\": \"Your PAN AYXXXXXX1P is already linked to given Aadhaar 37XXXXXXXX41\"\n }\n}"},{"id":"760dfba8-ded0-488c-ac06-9040fbce1b35","name":"PAN Linked To Some Other Aadhar","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{ \"aadhaar_number\": \"********6118\", \"pan_number\": \"*****9611P\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar/pan-linking-status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 05:49:45 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_aadhaar_status_0c0THUkYHmbdudjwxUoT\",\n \"timestamp\": 1665467386332,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"This PAN is linked to some other Aadhaar <37XXXXXXXX41> If details entered by you are correct please lodge a request under Grievances or contact Helpdesk to delink Aadhaar and link to this PAN.\",\n \"data\": null\n}"}],"_postman_id":"ab1770da-2548-4169-91e9-72a962c5a84a"}],"id":"fecf38f0-56cf-4ee5-be0c-f44e28add342","description":"

Introduction

A 12-digit unique identifier Aadhaar is an ID system which is used by Indian residents and is based on their demographic and biometric data. This personal data of an individual is collected and stored in the databases of the Unique Identification Authority of India (UIDAI). In addition to a person's personal information, it also collects their photograph, fingerprints and iris scans. With this system of information, it becomes very easy to identify an individual by simply cross-referencing their data with the data in the system.

The Aadhaar API provides Aadhar information available with UIDAI by providing Aadhaar Number.

IDcentral offers below Aadhaar API services.

Offline Aadhaar KYC
Verify PAN Aadhaar linking status
Basic Aadhaar Verification

\n","_postman_id":"fecf38f0-56cf-4ee5-be0c-f44e28add342"},{"name":"Aadhaar Plus","item":[{"name":"Create Token","id":"1aa438fd-aff5-443b-8ab5-165a846c4f5c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"popup\": false,\r\n \"redirect_url\": {{redirect_page_url}}, //optional field\r\n \"postback_url\": {{postback_page_url}} //optional field\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/token","description":"

STEP 1: Create Token

Create Token API response returns the temporary token and embedded URL which can be assigned to a single user session. The token (and the URL) are valid for 10 minutes.

In the request body parameter popup can be set to true or false

popup: true Means the application assumes that you’re loading Aadhaar Plus VIA popup. Hence on Closure, the Window closes & hands over control to the Parent.
popup: false Means the application assumes that you’re loading Aadhaar Plus VIA redirection. Hence on Closure, the Window Redirects to the Redirection URL Configured in ADMIN.

Definition

token: It is a uniquely generated key by IDC which allows clients to access aadhar details after completing Aadhaar OKYC journey or DigiLocker Journey. The token expires in 10 min.
\n
url: Unique Token based embedded URL for each user session which will take user to Aadhar Verification Page (Aadhaar OKYC or Digilocker)
\n
redirect_url: The web address to which user is to be automatically forwarded after the completion of web flow. Commonly used for tracking and maintenance pages.
\n
postback_url: The web address provided by the service or platform to which data is sent via HTTP POST request, typically used in online transactions or form submissions for processing and response handling.
\n

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	popup	Boolean	Required	Refer: token definition
2	redirect_url	String	Optional	Refer: redirect_url definition
3	postback_url	String	Optional	Refer: postback_url definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information received from createToken API
1.1	token	String	Refer: token definition
1.2	url	String	Refer: url definition
1.3	expireTimeStamp	Integer	Token Expiry Time Stamp in miliseconds. It is 10 min from the token generation time
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When token generated successfully	200	1	success	success
All other mismatch error	200	9

STEP 2: User Flow Integration

Front end Integration for Pop-up Mode

Implementing Pop - Up

Client can place \"Verify Aadhaar\" button on their platform. Use the below cod.

    Verify Aadhaar   \n\n

Generic JavaScript handler to initiate Aadhaar Plus via popup:

In JS File, you can place the below function to open PopUp window which will trigger once the user clicks on Verify Aadhaar Button.

function openPopup(idcurl) { /// idcurl = token based embedded url recieved from create Token API var idcWindow; idcWindow = window.open( idcurl, \"aadharWindow\", \"location=yes,height=570,width=520,scrollbars=yes,status=yes,left=500,top=0\" ); // Open new window }\n\n

2. Handover From IDcentral (IDC)

When User Exits or completes the Aadhar Verification Process, Status and Message will be sent to Parent page. Using these two values, your application can route the user to further steps in the user journey –

status ---
message --- <”Window Closed by User”/”Aadhar Verified Successfully”>

Generic JavaScript handler for handling handover from Aadhaar Plus Page via popup:

When user exits or completes the webflow, pop-up will get closed and IDC will send back status and message to parent window using window.opener.postMessage event. In parent window user can fetch these values using window.addEventListener event.

3. Handling Webhook

IDC logs the API response to Webhook Postback in case of two events:

User exits the session: whenever user closes and exits the session/screen
Successful Aadhaar Verification: submitting OTP post receiving in Aadhaar verification.

\n\n\n\n\n\n\n\n\n\n\n\n\n

Exit event response structure - Response Body (logged in Webhook Postback)	{ \"data\": {\"token\": \"\" }, \"status\": \"failed\", \"status_code\": 200, \"response_code\": 10, \"message_code\": null, \"message\": \"The User exited from the webflow.\", \"timestamp\": 1662667735668, \"error\": \"The User exited from the webflow.\", \"success\": false, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_tKEu0RugY6lq3wOQrAkE\" }
Submit OTP response structure - Response Body (logged in Webhook Postback)	{ \"data\": { \"token\": \"\", \"client_id\": \"TXNBV8IT7J76L\", \"full_name\": \"Xxxxxxx Xxxx\", \"aadhaar_number\": \"XXXXXXXX3469\", \"dob\": \"1996-06-10\", \"gender\": \"M\", \"address\": { \"country\": \"India\",\"dist\": \"Xxxxx\", \"state\": \"Xxxxx\", \"po\": \"\", \"loc\": \"XXXXXX XXXX\", \"vtc\": \"Haldwani Talli\", \"subdist\": \"\", \"street\": \"XXXX XXXX, \"house\": \".\", \"landmark\": \"NEAR COMMERCIAL MOTOR\" }, \"face_status\": false, \"face_score\": -1, \"zip\": \"XXXXX\", \"profile_image\": \"\", \"has_image\": true, \"raw_xml\": \"\", \"care_of\": \"S/O PANDEV JOSHI\", \"share_code\": \"2259\", \"mobile_verified\": false, \"reference_id\": \"346920220909020221475\", \"aadhaar_pdf\": null }, \"status\": \"success\", \"status_code\": 200, \"response_code\": 1, \"message_code\": \"success\", \"message\": \"Successful Request\", \"timestamp\": 1662669139228, \"error\": null, \"success\": true, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_YMuy6rQTjRFtyDJ2nQHK\" }

Exit event response structure - Response Body
(logged in Webhook Postback)

{ \"data\": {\"token\": \"\" }, \"status\": \"failed\", \"status_code\": 200, \"response_code\": 10, \"message_code\": null, \"message\": \"The User exited from the webflow.\", \"timestamp\": 1662667735668, \"error\": \"The User exited from the webflow.\", \"success\": false, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_tKEu0RugY6lq3wOQrAkE\" }

Submit OTP response structure - Response Body
(logged in Webhook Postback)

{ \"data\": { \"token\": \"\", \"client_id\": \"TXNBV8IT7J76L\", \"full_name\": \"Xxxxxxx Xxxx\", \"aadhaar_number\": \"XXXXXXXX3469\", \"dob\": \"1996-06-10\", \"gender\": \"M\", \"address\": { \"country\": \"India\",\"dist\": \"Xxxxx\", \"state\": \"Xxxxx\", \"po\": \"\", \"loc\": \"XXXXXX XXXX\", \"vtc\": \"Haldwani Talli\", \"subdist\": \"\", \"street\": \"XXXX XXXX, \"house\": \".\", \"landmark\": \"NEAR COMMERCIAL MOTOR\" }, \"face_status\": false, \"face_score\": -1, \"zip\": \"XXXXX\", \"profile_image\": \"\", \"has_image\": true, \"raw_xml\": \"\", \"care_of\": \"S/O PANDEV JOSHI\", \"share_code\": \"2259\", \"mobile_verified\": false, \"reference_id\": \"346920220909020221475\", \"aadhaar_pdf\": null }, \"status\": \"success\", \"status_code\": 200, \"response_code\": 1, \"message_code\": \"success\", \"message\": \"Successful Request\", \"timestamp\": 1662669139228, \"error\": null, \"success\": true, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_YMuy6rQTjRFtyDJ2nQHK\" }

Integration for redirection URL

Redirection to Aadhaar Plus

Generic JavaScript handler for Redirection to Aadhaar Plus page:
In JS File, you can write below function for Redirection which will trigger once you click on Verify Aadhaar Button.

        Verify Aadhaar   \n\n

Generic JavaScript handler for Redirection to Advance Aadhar page:
In JS File, you can write below function for Redirection which will trigger once you click on Verify Aadhaar Button.

function openredirectUrl(idcurl) { /// idcurl = token based embedded url recieved from create Token API window.open(idcurl, \"_self\"); }\n\n

2. Handover from IDC

When user exits or completes the webflow, user will be redirected to admin configured redirection URL with status and message set as URL Params.
Generic JavaScript handler for getting URL Params:

//call this function on initial load of page function getParams(){ //For getting message and status set in URL Params let params = new URLSearchParams(window.location.search); if(params.get('message') != null){ let idcMessage = params.get('message'); let idcStatus = params.get('status'); //Use these message and status to handle comm. From IDC Page } }\n\n

3. Handling Webhook

IDC logs the API response to Webhook Postback in case of two events:

User Exits the session: whenever user closes and exits the session/screen
Successful Aadhaar Verification: submitting OTP post receiving in aadhaar verification

\n\n\n\n\n\n\n\n\n\n\n\n\n

Exit event response structure - Response Body (logged in Webhook Postback)	{ \"data\": { \"token\": \"\" }, \"status\": \"failed\", \"status_code\": 200, \"response_code\": 10,\"message_code\": null, \"message\": \"The User exited from the webflow.\", \"timestamp\": 1662667735668, \"error\": \"The User exited from the webflow.\", \"success\": false, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_tKEu0RugY6lq3wOQrAkE\" }
Successful Aadhaar Verification response structure - Response Body (logged in Webhook Postback)	\"data\": { \"token\": \"\", \"client_id\": \"TXNBV8IT7J76L\", \"full_name\": \"MANISH JOSHI\", \"aadhaar_number\": \"XXXXXXXX3469\", \"dob\": \"1996-06-10\", \"gender\": \"M\", \"address\": { \"country\": \"India\", \"dist\": \"Nainital\", \"state\": \"Uttarakhand\", \"po\": \"\", \"loc\": \"BAREILLY ROAD\", \"vtc\": \"Haldwani Talli\", \"subdist\": \"\", \"street\": \"JOSHI VILLA\",\"house\": \".\", \"landmark\": \"NEAR COMMERCIAL MOTOR\" }, \"face_status\": false, \"face_score\": -1, \"zip\": \"263139\", \"profile_image\": \"\", \"has_image\": true, \"raw_xml\": \"\", \"care_of\": \"S/O PANDEV JOSHI\", \"share_code\": \"2259\", \"mobile_verified\": false, \"reference_id\": \"346920220909020221475\", \"aadhaar_pdf\": null }, \"status\": \"success\", \"status_code\": 200, \"response_code\": 1, \"message_code\": \"success\", \"message\": \"Successful Request\", \"timestamp\": 1662669139228, \"error\": null, \"success\": true, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_YMuy6rQTjRFtyDJ2nQHK\" }

Exit event response structure - Response Body
(logged in Webhook Postback)

{ \"data\": { \"token\": \"\" }, \"status\": \"failed\", \"status_code\": 200, \"response_code\": 10,\"message_code\": null, \"message\": \"The User exited from the webflow.\", \"timestamp\": 1662667735668, \"error\": \"The User exited from the webflow.\", \"success\": false, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_tKEu0RugY6lq3wOQrAkE\" }

Successful Aadhaar Verification response structure - Response Body
(logged in Webhook Postback)

\"data\": { \"token\": \"\", \"client_id\": \"TXNBV8IT7J76L\", \"full_name\": \"MANISH JOSHI\", \"aadhaar_number\": \"XXXXXXXX3469\", \"dob\": \"1996-06-10\", \"gender\": \"M\", \"address\": { \"country\": \"India\", \"dist\": \"Nainital\", \"state\": \"Uttarakhand\", \"po\": \"\", \"loc\": \"BAREILLY ROAD\", \"vtc\": \"Haldwani Talli\", \"subdist\": \"\", \"street\": \"JOSHI VILLA\",\"house\": \".\", \"landmark\": \"NEAR COMMERCIAL MOTOR\" }, \"face_status\": false, \"face_score\": -1, \"zip\": \"263139\", \"profile_image\": \"\", \"has_image\": true, \"raw_xml\": \"\", \"care_of\": \"S/O PANDEV JOSHI\", \"share_code\": \"2259\", \"mobile_verified\": false, \"reference_id\": \"346920220909020221475\", \"aadhaar_pdf\": null }, \"status\": \"success\", \"status_code\": 200, \"response_code\": 1, \"message_code\": \"success\", \"message\": \"Successful Request\", \"timestamp\": 1662669139228, \"error\": null, \"success\": true, \"count\": 0, \"txn_id\": \"advanced_aadhar_api_YMuy6rQTjRFtyDJ2nQHK\" }

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Aadhaar verified successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["adv-aadhar","token"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f85c9255-54f0-4af6-8a1d-319c6faf336a","name":"Token Generated Successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"popup\": false\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 08:30:38 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"05d93f66-33b4-4ab8-922c-XXXXXXXXX\",\n \"url\": \"https://api.idcentral.io/web/adv-aadhar/#/idcaadhar/05d93f66-33b4-4ab8-922c-XXXXXXXXXXX\",\n \"expireTimeStamp\": 1669279238653\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669278638653,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_AVtMBem2XLznyvCqGd1j\"\n}"}],"_postman_id":"1aa438fd-aff5-443b-8ab5-165a846c4f5c"},{"name":"Auth Token","id":"72cf2816-640a-478e-9996-153774e21221","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"{{token}}"}],"url":"https://api.idcentral.io/idc/adv-aadhar/auth","description":"

Auth Token API is used to check the status of generated Token. Generated token expires in 10 min. Auth Token API checks if token is expired or not.

Definition

token: It is a uniquely generated key by IDC which allows clients to access aadhaar details after completing Aadhaar OKYC journey or DigiLocker Journey. The token expires in 10 min.
Pop Up:
- popup: true Means the application assumes that you’re loading Aadhaar Plus VIA popup. Hence on Closure, the Window closes & hands over control to the Parent.
- popup: false Means the application assumes that you’re loading Aadhaar Plus VIA redirection. Hence on Closure, the Window Redirects to the Redirection URL Configured in ADMIN.
\n

Request: Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	token	String	Required	Refer: token definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	String	Information about token expiry
1.1	redirectUrl	String	URL where user will be redirected to after completing Advance Aadhaar journey
1.2	popup	Boolean	Refer: pop up definition
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Unique transaction reference ID

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When auth token is verified successfully	200	1	success	success
When expired token details are entered	400	-1	failed	The Request Token expired, please try with the new token.	Token Expired
All other mismatch error	200	9

","urlObject":{"path":["adv-aadhar","auth"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"070fff49-9ff5-4886-81e5-437774d6d9af","name":"Valid Token","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/adv-aadhar/auth"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 09:35:54 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"redirectUrl\": \"https://www.google.com\",\n \"popup\": false\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1669282555503,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_sHz49nii9tvo1XXXXXXXX\"\n}"},{"id":"4a5fa215-b066-44db-9d5b-1509bbad740c","name":"Expired token","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/adv-aadhar/auth"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 28 Nov 2022 16:36:21 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"The Request Token expired, please try with the new token.\",\n \"timestamp\": 1669653381443,\n \"error\": \"Token Expired\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_FGEGVKY2rayLH8rbONsQ\"\n}"}],"_postman_id":"72cf2816-640a-478e-9996-153774e21221"},{"name":"Recommend API","id":"7b5283c1-43c0-4a93-8417-954ddb53ca79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"accept","value":"*/*"},{"key":"token","value":"{{token}}","type":"text"}],"url":"https://api.idcentral.io/idc/adv-aadhar/recommend","description":"

Recommend API is used to check the recommend mode of the Aadhaar Plus. There are two Aadhaar verification modes involved.

Aadhaar OKYC Journey
DigiLocker Journey

If Primary mode has been seeing consistent failures, user will be moved to secondary channel.

Mode

Client can setup the mode as per their preference. Codes associated with modes are

1 - Aadhaar OKYC. If set, customer will only be able to do Aadhaar OKYC journey
2 - DigiLocker. If set, customer will only be able to do journey on DigiLocker UI
3 - Automated mode where Aadhaar OKYC is selected as primary channel and if it sees failure from UIDAI side, user will be automatically redirected to the DigiLocker flow.

Definition

token: It is a uniquely generated key by IDC which allows clients to access aadhaar details after completing Aadhaar OKYC journey or DigiLocker Journey. The token expires in 10 min.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	token	String	Required	Refer: token definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	key	Data Type	Description
1	data	Object	Information about recommended mode
1.1	recommended_mode	String	Refer: Mode
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When pre-set recommended mode details are fetched successfully	200	1	success	success
When invalid Token entered	400	-1	failed	Invalid Token, Please provide the valid Token ID	Invalid Token
All other mismatch error	200	9

","urlObject":{"path":["adv-aadhar","recommend"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"dd554b20-29a9-4a56-a1e0-bf5424e18258","name":"Common recommended Flow","originalRequest":{"method":"GET","header":[{"key":"accept","value":"*/*"},{"key":"token","value":"05d93f66-33b4-4ab8-922c-62b9b5d96de6","type":"text"}],"url":"https://api.idcentral.io/idc/adv-aadhar/recommend"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 08:34:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"recommended_mode\": \"3\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669278866830,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_cL80lqTau6aNQXXXXXXXX\"\n}"},{"id":"26ba7a2f-94cd-44d3-8484-0c504b9476f7","name":"Invalid Token Entered","originalRequest":{"method":"GET","header":[{"key":"accept","value":"*/*"},{"key":"token","value":"66dfb379-57c2-4710-8960-4fecd06b1c7d1","type":"text"}],"url":"https://api.idcentral.io/idc/adv-aadhar/recommend"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 19:38:18 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Invalid Token, Please provide the valid Token ID\",\n \"timestamp\": 1669750698722,\n \"error\": \"Invalid Token\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_n5LzPdlh5la5OXXXXXXX\"\n}"}],"_postman_id":"7b5283c1-43c0-4a93-8417-954ddb53ca79"},{"name":"Aadhaar OKYC - generate-request","id":"bab4540a-455b-45ba-8f26-0e74137bb583","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"346c563d-5c9e-4bed-89c3-931244f03e0a","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"378222184341\",\r\n \"mode\": \"2\",\r\n \"redirect_url\": {{redirect_page_url}}, //optional field\r\n \"postback_url\": {{postback_page_url}} //optional field\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request","description":"

Mode Selection:

If mode is set as -1 then user will be able to complete the journey with Aadhar OKYC flow. Aadhaar OKYC - Generate OTP API is used to initiate Aadhaar OKYC journey for customer where user will receive link on the registered mobile number which can be used to validate the using Aadhaar OKYC- Submit OTP API.

If mode is set as -2 then user will be able to complete the journey on DigiLocker UI. User will be redirected to DigiLocker to complete the jounrey using Aadhaar number. OTP received on registered mobile number and DigiLocker pin.

If mode is set as - 3 then based on set primary / secondary mode and their failure rates user will be redirected to.

Definition

token: It is a uniquely generated key by IDC which allows clients to access aadhaar details after completing Aadhaar OKYC journey or DigiLocker Journey. The token expires in 10 min.
\n
redirect_url: The web address to which user is to be automatically forwarded after the completion of web flow. Commonly used for tracking and maintenance pages.
\n
postback_url: The web address provided by the service or platform to which data is sent via HTTP POST request, typically used in online transactions or form submissions for processing and response handling.
\n

Request - In Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	token	String	Required	Refer: Token definition

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	User's Aadhaar Number
2	mode	String	Required	Refer: Mode selection
3	redirect_url	String	Optional	Refer: redirect_url definition
4	postback_url	String	Optional	Refer: postback_url definition

Response:

S. No	Key	Data Type	Description
1	data	Object	Information about set mode for user journey
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	otp_sent	Boolean	This key field confirms if OTP has been sent to registered mobile number or not. The OTP will be sent only when Mode is set as - 1 (Aadhaar OKYC flow)
1.3	if_number	Boolean	This key field confirms if given Aadhaar number is linked to mobile number or not. This will only be validated when Mode is set as - 1 (Aadhaar OKYC flow)
1.4	valid_aadhaar	Boolean	This key field confirms if given Aadhaar number is valid or not. This will only be validated when Mode is set as - 1 (Aadhaar OKYC flow)
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	Integer	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
11	track	String	This key field confirms about the set mode of user. If mode is selected 1. okyc or 2. digilocker or 3. based on the set mode

Scenario Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Aadhaar verified successfully	200	1	success	success
When invalid Aadhar Number is given	400	-1	failed	Please Provide the Valid Aadhaar Card Number	Invalid Aadhar Number
When resent OTP is initiated within 60 seconds	429	60	failed	Rate Limited, Please try again after 60sec	Rate Limited.
When mobile Number is not linked with Aadhaar	400	-1	failed	Mobile number not linked with aadhhar number	Invalid Mobile Number
When UID is locked	400	-1	failed	Unlock UID from UIDAI portal	UID Locked
When Aadhaar is suspended or cancelled	400	-1	failed	Please Provide the Valid Aadhaar Card Number	Invalid Aadhar Number
All other mismatch error	200	9

","urlObject":{"path":["adv-aadhar","generate-request"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"b7e5cb7a-c91f-46c3-8222-e649ff840903","name":"OKYC_Generate OTP","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"05d93f66-33b4-4ab8-922c-62b9b5d96de6","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"3782XXXXXXXX\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 08:35:30 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"aadhaar_v2_dOwndyEmIXnXXXXXXXX\",\n \"otp_sent\": true,\n \"if_number\": true,\n \"valid_aadhaar\": true\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1669278931339,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"advanced_aadhar_api_r52risl9PtXXXXXXX\",\n \"track\": \"okyc\"\n}"},{"id":"fef6573d-cb23-4943-a7eb-de7be93e66de","name":"Token Expired","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"05d93f66-33b4-4ab8-922c-62b9b5d96de6","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"357306109682\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 18:46:18 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"The Request Token expired, please try with the new token.\",\n \"timestamp\": 1669574778860,\n \"error\": \"Token Expired\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_AHYCJyqZSo6zLOpMrKwu\"\n}"},{"id":"cff93594-5288-4cb7-b244-39f178df2ccd","name":"UID is locked","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"cff5cfdb-057b-4400-b173-b92c598aa2ef","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 18:55:05 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Unlock UID from UIDAI portal\",\n \"timestamp\": 1669575305133,\n \"error\": \"UID Locked\",\n \"success\": false,\n \"txn_id\": \"advanced_aadhar_api_irn3S0NPo45RVsEBVMGQ\",\n \"track\": \"okyc\"\n}"},{"id":"0dcc9d03-96f0-43cf-8a3c-731ad09359e8","name":"Mobile not linked with Aadhaar","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"cff5cfdb-057b-4400-b173-b92c598aa2ef","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 18:55:46 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Mobile number not linked with aadhhar number\",\n \"timestamp\": 1669575346072,\n \"error\": \"Invalid Mobile Number\",\n \"success\": false,\n \"txn_id\": \"advanced_aadhar_api_P85nrQDXpaczXXXXXXXX\",\n \"track\": \"okyc\"\n}"},{"id":"d882200d-8367-4424-af1a-ff53dc7f5917","name":"Rate Limit","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"cff5cfdb-057b-4400-b173-b92c598aa2ef","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"3782XXXXXXXX\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 18:56:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 429,\n \"response_code\": 60,\n \"message_code\": null,\n \"message\": \"Rate Limited, Please try again after 60sec\",\n \"timestamp\": 1669575378049,\n \"error\": \"Rate Limited.\",\n \"success\": false,\n \"txn_id\": \"advanced_aadhar_api_vhmas0Av8ZPJXXXXXXXX\",\n \"track\": \"okyc\"\n}"},{"id":"56c03935-d77b-4a41-af78-9b9d3e40c40c","name":"Aadhar number is suspended or cancelled","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"Content-Type","value":"application/json"},{"key":"token","value":"b8272371-11b6-40d8-9b98-4f3eea73d1ff","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"222083XXXXXXXX\",\r\n \"mode\": \"3\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/generate-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 18:57:08 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Aadhaar Card Number\",\n \"timestamp\": 1669575427943,\n \"error\": \"Invalid Aadhar Number\",\n \"success\": false,\n \"txn_id\": \"advanced_aadhar_api_2A4DzSArKtFgGZAswI7k\",\n \"track\": \"okyc\"\n}"}],"_postman_id":"bab4540a-455b-45ba-8f26-0e74137bb583"},{"name":"Aadhaar OKYC - submit-otp","id":"ea621407-832e-464e-9531-9d549e4996f3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"{{token}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"TXNISVIMV5NZ1\",\r\n \"otp\": \"230153\"\r\n}"},"url":"{{base_url}}/adv-aadhar/submit-otp","description":"

The Aadhaar holder shares the received OTP. Use this OTP to get the Aadhaar holder's details associated with the corresponding aadhaar number, like name, address, mobile number, age, date of birth etc. from the Aadhaar database. The client_id generated from the \"Generate OTP\" request along with the OTP received by the customer on his Aadhaar-linked mobile phone are to be be passed as parameters. The received response will be shared with client via webhook URL.

This API is only used when Mode is set as - 1 (Aadhaar OKYC jounrey) or Mode is set as - 3 (Where primary mode is Aadhaar OKYC and UIDAI failure rate is lower than set threshold)

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	client_id	String	Required	Uniquely generated client ID for Aadhaar OKYC journey
2	otp	String	Required	Uniquely generated OTP for given Aadhaar Number

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information fetched after completing OKYC journey. Note: it will be null as data will shared over webhook with client
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Aadhaar OTP verified successfully	200	1	success	success
When invalid client_id is entered	400	-1	failed	Pass the Client_id key value genearated in Generate OTP API	Invalid Client Id
When incorrect / Invalid OTP is entered	400	-1	failed	Please pass the valid OTP sent to the registered mobile number	Invalid OTP
When empty OTP value is passed	400	-1	failed	Pass the OTP sent to the registered mobile number	OTP should be mandatory
All other mismatch error	200	9

","urlObject":{"path":["adv-aadhar","submit-otp"],"host":["{{base_url}}"],"query":[],"variable":[]}},"response":[{"id":"b10e35bb-299d-4724-9e6e-7c67c9bbd2d4","name":"OTP successfully submitted","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"05d93f66-33b4-4ab8-922c-62b9b5d96de6"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_dOwndyEmIXnXXXXXXX\",\r\n \"otp\": \"559963\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/submit-otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 08:36:33 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1669278991925,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_o3Zt1Dzm12XXXXXX\"\n}"},{"id":"79aea815-a96c-4f75-ac42-965fabea7479","name":"Invalid Client Key entered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"b8272371-11b6-40d8-9b98-4f3eea73d1ff"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"TXNISXXXXX\",\r\n \"otp\": \"230153\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 19:02:27 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Pass the Client_id key value genearated in Generate OTP API\",\n \"timestamp\": 1669575747011,\n \"error\": \"Invalid Client Id\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_Q0ijssnZJXXXXXXX\"\n}"},{"id":"22a919a1-43d4-4c99-824d-e1838796a279","name":"Incorrect OTP entered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"c074fe8b-2f03-4b3c-823b-a7647f0274bf"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_eUBjqmvXXXXXXX\",\r\n \"otp\": \"123456\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 19:03:57 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please pass the valid OTP sent to the registered mobile number\",\n \"timestamp\": 1669575833925,\n \"error\": \"Invalid OTP\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_OK6UwtUa9XXXXXXXX\"\n}"},{"id":"313cdbe0-8318-4e2e-929b-da90b8a5c797","name":"Passed Empty OTP value","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"token","value":"c074fe8b-2f03-4b3c-823b-a7647f0274bf"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_eUBjqmvQueyjESzvgrbj\",\r\n \"otp\": \"\"\r\n}"},"url":"https://api.idcentral.io/idc/adv-aadhar/submit-otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 19:04:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Pass the OTP sent to the registered mobile number\",\n \"timestamp\": 1669575870932,\n \"error\": \"OTP should be mandatory\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"advanced_aadhar_api_2MVSCU9PcIFXXXXXXXX\"\n}"}],"_postman_id":"ea621407-832e-464e-9531-9d549e4996f3"}],"id":"c63b99ca-2969-437a-a3e0-b24d4391f1a5","description":"

\"Aadhaar Plus API\" is a flagship product of IDcentral which offers seamless KYC journey to the end user. Often clients experience downtime with UIDAI service (Okyc, e-kyc). To counter these situation, IDcentral offers Aadhaar Plus solution which helps your customers experience seamless journey on your platform.

In Aadhaar Plus journey, IDcentral offers customers to complete journey using primary channel as

Aadhaar Offline KYC - where user completes journey using Aadhaar OKYC flow and if UIDAI services are having problems then system will automatically route customer to secondary channel
\n
DigiLocker - Where user completes the journey on DigiLocker platform
\n

There are some other supporting APIs as shown below.

Auth Token
Recommend API
Aadhaar Offline KYC
- Generate OTP
- Submit OTP
\n

Below are the steps to complete the Aadhaar Plus Journey

STEP 1: Configuration of Postback and Redirection URL

Please connect with IDcentral Team to setup of Postback and Redirection URL

Both these parameters are mandatory.

Postback URL is the URL to which our Webhook posts data on success completion of OKYC or DigiLocker process.
\n
Redirection URL is used only if the popup parameter is set to “false”. This is the URL to which the users are redirected to on completion of the process.
\n

STEP 2: Token generation

After setup of postback and redirection URLs. We need to create a token using \"Create Token\" API service. This API response returns the temporary token and embedded URL which can be assigned to a single user session.

The token (and the URL) are valid for 10 minutes.

STEP 3: User Flow Integration

User flow integration consists of two flows. User can choose any one for the journey.

Front end Integration for Pop-up Mode: In this flow Aadhaar Plus flow is initiated via popup on client's platform (Mobile / Website)
\n
Integration for redirection URL: In this flow user is redirected directly to the Aadhaar Plus flow outside the client's platform on browser.
\n

STEP 4: User redirection after completing the journey

User is redirected to the defined redirection URL and received verified Aadhaar details shared with client using postback URL

Definition

UIDAI - Aadhaar OKYC : Aadhaar number is a unique 12-digit number used to verify an individual’s identity. Aadhaar Verification is a crucial part of the customer onboarding process for various platforms like NBFCs, Banks, Lending companies, and insurance companies.To support businesses verify the aadhaar based on user consent, we support offline verification. To do this, you must first enter the aadhaar number provided, an OTP will be sent to the customer phone number registered with the aadhaar. Next, you must enter the OTP customer has received to validate the aadhaar to see all the details associated with the corresponding aadhaar number, like name, address, mobile number, age, date of birth etc., of the Aadhaar card holder.
DigiLocker: DigiLocker is a simple and convenient product that can share documents online, accessed anytime, anywhere. Moreover, all the documents can be authenticated by the users, legally on a par with originals, and are accepted by the government of India as a substitute for the original one if required to produce one.
Postback / Webhook URL: Webhooks are one of a few ways web applications can communicate with each other. It allows you to send real-time data from one application to another whenever a given event occurs.
Redirect URL: Redirect URL is a technique which is used to redirect your domain's visitors to a different URL. You can forward your domain name to any website, webpage, etc. which is available online.

\n","_postman_id":"c63b99ca-2969-437a-a3e0-b24d4391f1a5"},{"name":"Aadhaar UID Masking","item":[{"name":"Aadhaar UID Masking","id":"bf9d74c6-6b4d-4f0a-99e0-7bf9864dbf4d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_base64\": \"{{id_document}}\" //Use or \"id_document_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking","description":"

\"Aadhaar UID Masking\" API enables the user to upload the Aadhaar image in the format of accessible URL link or base 64 and in repsone the first 8 digits of your Aadhaar card number get replaced by asterisks and appear as “XXXX XXXX”, while the last 4 digits remain as it is. Customers can easily download the masked version via the password-protected electronic Aadhaar in a compliant manner. Other demographic details remain same.

Image quality requirement:

Minimum width 400 px
Maximum file size 5 MB

Note: URL accepts PDF also and can have both front and back image but should have maximum 2 imgaes only.

Request: The request has to be passed in body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_base64 or id_document_url	String	Required	Document image in the form of URL or Base 64 Note - If User wants to give the URL in input, id_document_url should be used and if User wants to give the base 64 in input, id_document_base64 should be used

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Number	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched from the document
8.1	document_type	String	Type of document
8.2	request_masking_status	Boolean	This indicates whether the Aadhaar number is masked in the request Aadhaar document or not
8.3	response_masking_status	Boolean	This indicates whether the Aadhaar number is masked in the response of Aadhaar document or not.
8.4	masked_aadhar_base64	String	Masked image of aadhaar in base64 format

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When masked file is generated	200	1	success	Successful request
Already masked aadhaar card	200	2	success	Given Document is already masked	Verification Error
Invalid document is uploaded	200	3	success	Given Document is Invalid. Please provide valid aadhaar card	Verification Error
When un supported file is uploaded	-1	400	failed	Please provide the supported image files( jpeg, jpg, jpe, jif, jfif, jfi and png).	Validation error
When file size exceeds max size limit	-1	400	failed	File exceeds maximumm file size 5000000 bytes and Photo size is (File Size)	Validation error
When PDF has more than 2 documents	-1	400	Failed	The provided PDF includes multiple documents, exceeding a count of two.\"	Validation error
Inaccessible URL	-1	400	failed	Image URL Unreachable	Validation error
Invalid Base 64 formal	-1	400	failed	Invalid Image Base64 format	Validation error
Invalid URL format	-1	400	failed	Invalid Image URL format	Validation error
All other mismatch errors	200	9

","urlObject":{"path":["v2","aadhaar-masking"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"fcc40671-63d2-4151-b59d-afd399e1e3da","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use or \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_CtXuE1JcMDstH0uw288N\",\n \"timestamp\": 1695627051140,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"document_type\": \"Aadhaar\",\n \"request_masking_status\": false,\n \"response_masking_status\": true,\n \"masked_aadhar_base64\":{{base64image}}"},{"id":"671e35e7-21a3-4f1e-b862-15abeb73c4d0","name":"Invalid Documents","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_YIMSftkawT4V6eufajGD\",\n \"timestamp\": 1697452757293,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification Error\",\n \"message\": \"Given Document is Invalid. Please provide valid aadhaar card\",\n \"data\": {\n \"document_type\": \"Non-Aadhaar\",\n \"request_masking_status\": \"NA\",\n \"response_masking_status\": \"NA\",\n \"masked_aadhaar_base64\": null\n }\n}"},{"id":"94bed08f-40b3-4364-889b-2a7d0de96d89","name":"Document is already masked","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_Rqg0XFdwNkrIrW0jfK3r\",\n \"timestamp\": 1697456948058,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification Error\",\n \"message\": \"Given Document is already masked\",\n \"data\": {\n \"document_type\": \"Aadhaar\",\n \"request_masking_status\": true,\n \"response_masking_status\": \"NA\",\n \"masked_aadhaar_base64\": null\n }\n\n}"},{"id":"2cede09a-45b3-4c4b-842f-1fedb17f41b2","name":"File size is greater than 5MB","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_ZFuvD1lda1WchUHr21QH\",\n \"timestamp\": 1695632551676,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"File exceeds maximumm file size 5000000 bytes and Photo size is 7930317\",\n \"data\": null\n}"},{"id":"5900996f-7ad3-4031-af3a-757b0b05a99f","name":"Unsupported image format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_ZZKXWJ09qeYHSq7iSlm9\",\n \"timestamp\": 1695632008034,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).\",\n \"data\": null\n}"},{"id":"c3fa919a-2810-47a9-96cf-9769be71f166","name":"Inaccessible URL","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_SdaBkdrqfhkJHXj872GZ\",\n \"timestamp\": 1695632602467,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Image URL Unreachable\",\n \"data\": null\n}"},{"id":"7b107011-5267-4efc-9fcf-31267fb558dc","name":"Invalid base64 format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_BsvZyC7nedki9bVzLQ00\",\n \"timestamp\": 1695633323818,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid Image Base64 format\",\n \"data\": null\n}"},{"id":"86f18f87-b9b2-49af-835c-415c3b06c690","name":"Invalid URL formal","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_document_base64\": \"{{id_document}}\" //Use \"id_document_url\" for Image in URL format\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"338"},{"key":"Date","value":"Mon, 25 Sep 2023 09:08:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_YZJhGhdiKoYropElcIYL\",\n \"timestamp\": 1695632879961,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid Image URL format\",\n \"data\": null\n}"},{"id":"3cc188eb-2a41-4ff6-ac0c-be8ee8006698","name":"Aadhaar UID Masking (Front and Back)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\": \"id_document_url\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 16 Nov 2023 13:50:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_XLUQc6TC2qP8JvyawQaC\",\n \"timestamp\": 1700142582831,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"front\": {\n \"document_type\": \"Aadhaar\",\n \"request_masking_status\": false,\n \"response_masking_status\": true,\n \"masked_aadhaar_base64\": \"masked_aadhaar_base64\"\n\t\t\t},\n \"back\": {\n \"document_type\": \"Aadhaar\",\n \"request_masking_status\": false,\n \"response_masking_status\": true,\n \"masked_aadhaar_base64\": \"masked_aadhaar_base64\"\n\t\t\t}\n }\n}"},{"id":"e9e6e32e-bcdf-42e8-a59d-7408f875d486","name":"PDF has multiple documents","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\": \"id_document_url\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 16 Nov 2023 14:07:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_O1TeiCFn3yG3r6F9fGc9\",\n \"timestamp\": 1700143650038,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"The provided PDF includes multiple documents, exceeding a count of two.\",\n \"data\": null\n}"},{"id":"4b2a5429-a2d5-4089-9704-5fc0b1970a60","name":"PDF has invalid document and valid aadhaar","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\": \"id_document_url\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/aadhaar-masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 16 Nov 2023 16:24:50 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"aadhaar_masking_v2_jYyplIaHidO90vIGx2bY\",\n \"timestamp\": 1700151873138,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Validation Error\",\n \"message\": \"Given Document is Invalid. Please provide valid aadhaar card\",\n \"data\": {\n \"front\": {\n \"document_type\": \"Aadhaar\",\n \"request_masking_status\": false,\n \"response_masking_status\": true,\n \"masked_aadhaar_base64\":\"masked_aadhaar_base64\"\n\t\t},\n \"back\": {\n \"document_type\": \"Non-Aadhaar\",\n \"request_masking_status\": \"NA\",\n \"response_masking_status\": \"NA\"\n }\n }\n}"}],"_postman_id":"bf9d74c6-6b4d-4f0a-99e0-7bf9864dbf4d"}],"id":"e313d03a-3a4e-4c14-98c4-56e3c33e8a39","description":"

Why Aadhaar masking is important?
Aadhaar card has a 12-digit unique identification number tied to an individual’s fingerprints, face and eye scan. It is a document that serves as a proof of address and identity, and aims to prevent theft and leakage in India’s welfare schemes.

While conducting Aadhaar Card verification there is a risk of misusing the personal information by fraudulent entities. These flagged privacy concerns have pushed the government to make the masked Aadhaar mandatory. In May 2019, RBI made some modifications in the master direction on KYC guidelines for regulated entities. One such modification made it mandatory for all the RBI-regulated institutions to mask clients’ Aadhaar cards as part of the Aadhaar e-KYC online process.

\n","_postman_id":"e313d03a-3a4e-4c14-98c4-56e3c33e8a39"},{"name":"AddressNet","item":[{"name":"Address Standardization","id":"95880a03-dc37-46db-984e-002164e22967","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"4-7-258, Mekala banda street, kothapeta, near naga mallaiah store, srisailam, kurnool, andhra pradesh, India, 518101\"\r\n}"},"url":"https://api.idcentral.io/idc/onboarding/structurizeaddress?country={{country_code}}","description":"

What is Structurize Address API and its benefits?

Structuring Address is the process of taking improperly formatted addresses with typographical errors and matching them with the standardized, validated version in an official or authoritative address database. The Address structuring API service takes a nonformatted address and breaks the address into identifiable
components like country, state, city, locality, and sub locality along with additional information like street, landmark, floor, etc. It standardizes the address ready to be referred. Structured address helps software systems to pass / share address data with other systems which mostly accept address structured format. It saves time and efforts to build separate system for structuring address.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	baseAddress	String	Required	Address details to be passed

(Note: Country ID to be passed in Params. The default country code as \"IN\" (ISO-3166-1 format) for India. Other country code can be added based on ISO-3166-1 format)

Response

S. No	Key	Data Type	Description
1	data	Object	Address details
1.1	address_components	Object	Address components
1.1.1	landmark	String	Landmark details mapped
1.1.2	locality	String	Locality details mapped
1.1.3	administrative_area_level_1	String	City details mapped
1.1.4	country	String	Country details mapped
1.1.5	postal_code	String	Postal code details mapped
1.1.6	route	String	Route details mapped
1.2	mapping	Object	Mapping (Note: Below series of 1.2 is mapping against the address fields mentioned above)
1.2.1	country	String	Country details
1.2.2	administrative_area_level_1	String	City details
1.2.3	administrative_area_level_2	String	City details
1.2.4	administrative_area_level_3	String	City details
1.2.5	administrative_area_level_4	String	City details
1.2.6	administrative_area_level_5	Boolean	City details
1.2.7	neighborhood	String	Neighborhood details
1.2.8	postal_code	String	Postal Code details
1.2.9	landmark	String	Landmark details
1.2.10	political	String	Political details
1.2.11	premise	String	Premise details
1.2.12	subpremise	String	Subpremise details
1.2.13	route	String	Route details
1.2.14	street_number	String	State number details
1.2.15	locality	String	Locality details
1.2.16	post-box	String	Post box number details
1.2.17	plus_code	String	Plus code details
1.2.18	sublocality_level_1	String	Sub locality details
1.2.19	floor	String	Floor details
1.2.20	o	String	House no details
2	error	String	A text content explains a reason if API request failed
3	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
6	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
7	message	String	A text content explains if API request was successful or not.
8	success	String	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
9	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Error
When address has been structured properly	200	0	success
When no address details are provided	0	0	failed	Invalid Input
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","structurizeaddress"],"host":["https://api.idcentral.io/idc"],"query":[{"key":"country","value":"{{country_code}}"}],"variable":[]}},"response":[{"id":"9e921dcf-4088-4d7f-946c-3348883273a2","name":"Successful Structured Mapping","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"4-7-258, Mekala banda street, kothapeta, near naga mallaiah store, srisailam, kurnool, andhra pradesh, India, 518101\"\r\n}"},"url":{"raw":"https://api.idcentral.io/idc/onboarding/structurizeaddress?country=IN","protocol":"https","host":["api","idcentral","io"],"path":["idc","onboarding","structurizeaddress"],"query":[{"key":"country","value":"IN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:18:54 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"responseTimestamp\": 1668939534737,\n \"data\": {\n \"address_components\": {\n \"landmark\": \"naga mallaiah store srisailam\",\n \"locality\": \"kurnool\",\n \"administrative_area_level_1\": \"andhra pradesh\",\n \"country\": \"india\",\n \"postal_code\": \"518101\",\n \"route\": \"4 7 258 mekala banda street kothapeta near\"\n },\n \"mapping\": {\n \"country\": \"country\",\n \"administrative_area_level_1\": \"State\",\n \"administrative_area_level_2\": \"City\",\n \"administrative_area_level_3\": \"District\",\n \"administrative_area_level_4\": \"Village\",\n \"administrative_area_level_5\": \"Neighborhood/Community\",\n \"neighborhood\": \"neighborhood\",\n \"postal_code\": \"postal code\",\n \"point_of_interest\": \"point of interest\",\n \"landmark\": \"landmark\",\n \"political\": \"political\",\n \"premise\": \"premise\",\n \"subpremise\": \"subpremise\",\n \"route\": \"route\",\n \"street_number\": \"street number\",\n \"locality\": \"locality\",\n \"post-box\": \"post-box\",\n \"plus_code\": \"plus code\",\n \"sublocality_level_1\": \"sublocality_level_1\",\n \"floor\": \"floor\",\n \"o\": \"Unknown\"\n }\n },\n \"error\": null,\n \"statusCode\": \"200\",\n \"response_code\": 0,\n \"status_code\": 0,\n \"message_code\": null,\n \"message\": null,\n \"success\": false,\n \"txn_id\": \"address_structurize_NKVOCtFHRncNhOYY1BmP\"\n}"},{"id":"ea77ba44-990d-4e49-bbb0-578251da7d8c","name":"Empty Address","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"\"\r\n}"},"url":{"raw":"https://api.idcentral.io/idc/onboarding/structurizeaddress?country={{country_code}}","host":["https://api.idcentral.io/idc"],"path":["onboarding","structurizeaddress"],"query":[{"key":"country","value":"{{country_code}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:21:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"failed\",\n \"responseTimestamp\": 1668939686604,\n \"data\": null,\n \"error\": \"Invalid Input\",\n \"statusCode\": null,\n \"response_code\": 0,\n \"status_code\": 0,\n \"message_code\": null,\n \"message\": null,\n \"success\": false,\n \"txn_id\": null\n}"}],"_postman_id":"95880a03-dc37-46db-984e-002164e22967"},{"name":"Compare Address","id":"4faa2519-9521-458b-8062-989e9c4acab3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"4-7-258 Mekala banda street kothapeta near naga mallaiah store srisailam kurnool andhra pradesh India 518101\",\r\n \"verificationAddress\": \"4-7-28 Meala banda street kothapet backside of naga mallaiah store srisailam kurnool andhra pradesh India 518101\"\r\n}"},"url":"https://api.idcentral.io/idc/onboarding/verifyaddress?country={{country_code}}","description":"

Address Comparision is the process of comparing physical location address to addresses in a database / address verifed from the authentic source like Government document.

Address comparision API first structures both the addresses as per address standards and compares each respective field using structurize Address API. Match score is also shared to understand the match.

Definition

Overall_match_score: It is a fuzzy match score that can range from 0 through 100% based on how close the search data and file data values match.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	baseAddress	String	Required	Address details to be passed
2	verificationAddress	String	Required	Verified address details to be passed

(Note: Country ID to be passed in Params. The default country code as \"IN\" (ISO-3166-1 format) for India. Other country code can be added based on ISO-3166-1 format)

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
2	responseTimestamp	Integer	API response receive time in milliseconds
3	data	Object	Information details after comparing the addresses
3.1	result	Object	Information details after comparing the addresses
3.1.1	base_address_tags	Object	Base address details. mainly entered by end user
3.1.1.1	landmark	String	Landmark details mapped
3.1.1.2	locality	String	Locality details mapped
3.1.1.3	administrative_area_level_1	String	City details mapped
3.1.1.4	country	String	Country details mapped
3.1.1.5	postal_code	String	Postal code details mapped
3.1.1.6	route	String	Route details mapped
3.1.2	verify_address_tags	Object	Verify address details
3.1.2.1	landmark	String	Landmark details mapped
3.1.2.2	locality	String	Locality details mapped
3.1.2.3	administrative_area_level_1	String	City details mapped
3.1.2.4	country	String	Country details mapped
3.1.2.5	postal_code	String	Postal code details mapped
3.1.2.6	route	String	Route details mapped
3.1.3	overall_match_score	Integer	Overall fuzzy Match Percentage
3.1.4	match_score_by_tag	Object	Address field wise match score
3.1.4.1	landmark	String	Landmark match percentage
3.1.4.2	locality	String	Locality match percentage
3.1.4.3	administrative_area_level_1	String	City match percentage
3.1.4.4	country	String	Country match percentage
3.1.4.5	postal_code	String	Postal Code match percentage
3.1.4.6	route	String	Route match percentage
3.1.5	mapping	Object	Mapping (Note: Below series of 3.1.5 is mapping against the address fields mentioned above)
3.1.5.1	country	String	Country details
3.1.5.2	administrative_area_level_1	String	City details
3.1.5.3	administrative_area_level_2	String	City details
3.1.5.4	administrative_area_level_3	String	City details
3.1.5.5	administrative_area_level_4	String	City details
3.1.5.6	administrative_area_level_5	Boolean	City details
3.1.5.7	neighborhood	String	Neighborhood details
3.1.5.8	postal_code	String	Postal code details
3.1.5.9	landmark	String	Landmark details
3.1.5.0	political	String	Political details
3.1.5.11	premise	String	Premise details
3.1.5.12	subpremise	String	Sub premise details
3.1.5.13	route	String	Route details
3.1.5.14	street_number	String	Street Number details
3.1.5.15	locality	String	Locality details
3.1.5.16	post-box	String	Postbox details
3.1.5.17	plus_code	String	Plus code details
3.1.5.18	sublocality_level_1	String	Sub locality details
31.1.5.19	floor	String	Floor details
3.1.5.20	o	String	House number details
4	error	String	A text content explains a reason if API request failed
5	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
6	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
7	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
8	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
9	message	String	A text content explains if API request was successful or not.
10	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status
When addresses are perfectly matched / Match percentage is 100 %	200	0	success
When addresses are partially matched	200	0	success
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","verifyaddress"],"host":["https://api.idcentral.io/idc"],"query":[{"key":"country","value":"{{country_code}}"}],"variable":[]}},"response":[{"id":"3c4fc4bb-0b6e-45ab-b2b0-a3c369525ff5","name":"Addresses Partially Matches","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"ra pradesh India 518101\",\r\n \"verificationAddress\": \"4-7-28 Meala banda street kothapet backside of naga mallaiah store srisailam kurnool andhra pradesh India 518101\"\r\n}"},"url":{"raw":"https://api.idcentral.io/idc/onboarding/verifyaddress?country=IN","protocol":"https","host":["api","idcentral","io"],"path":["idc","onboarding","verifyaddress"],"query":[{"key":"country","value":"IN"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:24:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"responseTimestamp\": 1668939845685,\n \"data\": {\n \"result\": {\n \"base_address_tags\": {\n \"sublocality_level_1\": \"ra\",\n \"administrative_area_level_1\": \"pradesh\",\n \"country\": \"india\",\n \"o\": \"\",\n \"postal_code\": \"518101\"\n },\n \"verify_address_tags\": {\n \"landmark\": \"mallaiah store srisailam\",\n \"locality\": \"kurnool\",\n \"administrative_area_level_1\": \"andhra pradesh\",\n \"country\": \"india\",\n \"postal_code\": \"518101\",\n \"route\": \"4 7 28 meal banda street kothapet backside of naga\"\n },\n \"overall_match_score\": 68.75,\n \"match_score_by_tag\": {\n \"sublocality_level_1\": 0,\n \"administrative_area_level_1\": 100,\n \"country\": 100,\n \"postal_code\": 100\n }\n },\n \"mapping\": {\n \"country\": \"country\",\n \"administrative_area_level_1\": \"State\",\n \"administrative_area_level_2\": \"City\",\n \"administrative_area_level_3\": \"District\",\n \"administrative_area_level_4\": \"Village\",\n \"administrative_area_level_5\": \"Neighborhood/Community\",\n \"neighborhood\": \"neighborhood\",\n \"postal_code\": \"postal code\",\n \"point_of_interest\": \"point of interest\",\n \"landmark\": \"landmark\",\n \"political\": \"political\",\n \"premise\": \"premise\",\n \"subpremise\": \"subpremise\",\n \"route\": \"route\",\n \"street_number\": \"street number\",\n \"locality\": \"locality\",\n \"post-box\": \"post-box\",\n \"plus_code\": \"plus code\",\n \"sublocality_level_1\": \"sublocality_level_1\",\n \"floor\": \"floor\",\n \"o\": \"Unknown\"\n }\n },\n \"error\": null,\n \"statusCode\": \"200\",\n \"response_code\": 0,\n \"status_code\": 0,\n \"message_code\": null,\n \"message\": null,\n \"success\": false,\n \"txn_id\": \"address_verification_pqvsuzToLGAWpcSXEaJl\"\n}"},{"id":"cb423a08-48c7-435d-b9c3-0448e80a48af","name":"Given addresses Match","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"baseAddress\": \"4-7-258 Mekala banda street kothapeta near naga mallaiah store srisailam kurnool andhra pradesh India 518101\",\r\n \"verificationAddress\": \"4-7-258 Mekala banda street kothapeta near naga mallaiah store srisailam kurnool andhra pradesh India 518101\"\r\n}"},"url":{"raw":"https://api.idcentral.io/idc/onboarding/verifyaddress?country={{country_code}}","host":["https://api.idcentral.io/idc"],"path":["onboarding","verifyaddress"],"query":[{"key":"country","value":"{{country_code}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:42:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"responseTimestamp\": 1668940977886,\n \"data\": {\n \"result\": {\n \"base_address_tags\": {\n \"landmark\": \"naga mallaiah store srisailam\",\n \"locality\": \"kurnool\",\n \"administrative_area_level_1\": \"andhra pradesh\",\n \"country\": \"india\",\n \"postal_code\": \"518101\",\n \"route\": \"4 7 258 mekala banda street kothapeta near\"\n },\n \"verify_address_tags\": {\n \"landmark\": \"naga mallaiah store srisailam\",\n \"locality\": \"kurnool\",\n \"administrative_area_level_1\": \"andhra pradesh\",\n \"country\": \"india\",\n \"postal_code\": \"518101\",\n \"route\": \"4 7 258 mekala banda street kothapeta near\"\n },\n \"overall_match_score\": 100,\n \"match_score_by_tag\": {\n \"landmark\": 100,\n \"locality\": 100,\n \"administrative_area_level_1\": 100,\n \"country\": 100,\n \"postal_code\": 100,\n \"route\": 100\n }\n },\n \"mapping\": {\n \"country\": \"country\",\n \"administrative_area_level_1\": \"State\",\n \"administrative_area_level_2\": \"City\",\n \"administrative_area_level_3\": \"District\",\n \"administrative_area_level_4\": \"Village\",\n \"administrative_area_level_5\": \"Neighborhood/Community\",\n \"neighborhood\": \"neighborhood\",\n \"postal_code\": \"postal code\",\n \"point_of_interest\": \"point of interest\",\n \"landmark\": \"landmark\",\n \"political\": \"political\",\n \"premise\": \"premise\",\n \"subpremise\": \"subpremise\",\n \"route\": \"route\",\n \"street_number\": \"street number\",\n \"locality\": \"locality\",\n \"post-box\": \"post-box\",\n \"plus_code\": \"plus code\",\n \"sublocality_level_1\": \"sublocality_level_1\",\n \"floor\": \"floor\",\n \"o\": \"Unknown\"\n }\n },\n \"error\": null,\n \"statusCode\": \"200\",\n \"response_code\": 0,\n \"status_code\": 0,\n \"message_code\": null,\n \"message\": null,\n \"success\": false,\n \"txn_id\": \"address_verification_VYfdXPSqyAfYYnhOFays\"\n}"}],"_postman_id":"4faa2519-9521-458b-8062-989e9c4acab3"},{"name":"Address Comparison - LatLong & String","id":"e3410deb-953a-4585-a867-52ccf08893e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"in Excepteur ullamco tempor consequat"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n -19347585.793270245,\n 67290677.06423733\n ],\n \"address_string\": \"aute aliquip\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison","description":"

Address Comparison (Lat-Long and Address) API requires address details of two locations where first location details are required in latitide and longitude format and second location details are in requires as a plain address details as string.

Once the response receives on success, the response includes,

First location address details into plain address format as string
Distance between two locations
Time required to cover the distance between given locations

Defination

Latitude: Latitudes are horizontal lines that measure distance north or south of the equator. The latitude must be specified as a decimal between -90.0 and 90.0.
Longitude: Longitudes are vertical lines that measure east or west of the meridian in Greenwich, England. The longitude must be specified as a decimal between -180.0 and 180.0.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	address_latlong	Array List	Required	Latitude and Longitude details of an address
2	address_string	String	Required	Address details as a plain string

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Address comparision results
1.1	address_string	String	Base address details
1.2	address_latlong_string	String	Landmark details mapped
1.3	distance_in_meters	Integer	Locality details mapped
1.4	duration_in_mins	Integer	Time it will take to cover from one location to another in minutes
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Address string and given lat long matches exactly.	200	1	success	Successful Request
When addresses dont match but distance and duration is mentioned	200	0	success	Successful Request
When no results are found for given addresses	200	9	failed	ZERO_RESULTS
When address string value is not passed	400	-1	failed	Please enter valid Address	Invalid Request
When lat long details are not passed	400	-1	failed	Please enter valid latitude/longitude values	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["address-comparison"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"a4eb9d4c-3e56-43bb-8071-007f457986dc","name":"Addresses matched successfully","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n 12.9154584,\n 77.69097599999999\n ],\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 10:06:07 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\",\n \"address_latlong_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\",\n \"distance_in_meters\": 0,\n \"duration_in_mins\": 0\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1672135567502,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"address_comparision_76RJoRtvlElSS9WnEZDu\"\n}"},{"id":"6b844dd5-f403-4ea1-872d-2f71e8b5b716","name":"Addreses did not match","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n 15.9154584,\n 100.69097599999999\n ],\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 10:07:20 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\",\n \"address_latlong_string\": \"ถนนทีไมมีชือ, Tambon Thung Thong, Amphoe Nong Bua, Chang Wat Nakhon Sawan 60110, Thailand\",\n \"distance_in_meters\": 5155200,\n \"duration_in_mins\": 5690\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1672135640520,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"address_comparision_tYWWkgJJiSdplSJONfUU\"\n}"},{"id":"7bf0cfac-9cb6-48fa-aec7-52ac33e5d527","name":"No result Found","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n -15.9154584,\n -100.69097599999999\n ],\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 10:16:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\",\n \"address_latlong_string\": \"-15.9154584,-100.69097599999999\",\n \"distance_in_meters\": 0,\n \"duration_in_mins\": 0\n },\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": null,\n \"message\": \"ZERO_RESULTS\",\n \"timestamp\": 1672136169064,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"address_comparision_odagTSkIeFPkoAkrDXfQ\"\n}"},{"id":"e16d8182-079b-45e0-9ea1-151592c308d6","name":"Valid Address details are required","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n -15.9154584,\n -100.69097599999999\n ],\n \"address_string\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 10:17:50 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please enter valid Address\",\n \"timestamp\": 1672136270635,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"address_comparision_UKfwlQlri7LAIcfdko8s\"\n}"},{"id":"6ee1798d-411b-4284-8869-f9e55091b762","name":"No Lat Long details provided","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n\n ],\n \"address_string\": \"02, Bellandur, Bengaluru, Karnataka 560103, India\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/address-comparison"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 10:18:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please enter valid latitude/longitude values\",\n \"timestamp\": 1672136310414,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"address_comparision_NpCIph3LjqWyEUKfe50i\"\n}"}],"_postman_id":"e3410deb-953a-4585-a867-52ccf08893e9"},{"name":"Reverse Geocoding","id":"1bda9b29-7b6b-4a71-9027-2b9a87b03740","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n ,\n \n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/reverse-geocoding","description":"

What is Reverse Geocoding?

Reverse Geocoding is the process of converting a set of coordinates, like latitude & longitude coordinates into the nearest street address and sometimes into the nearest place name or landmark. Reverse geocoders usually provide a list of the closest address candidates with each set of coordinates.

Reverse geocoding is useful in many cases, such as delivery updates, location-based advertising, emergency response systems, and movement behavior-based analysis.

Definition

Latitude: Latitudes are horizontal lines that measure distance north or south of the equator. The latitude must be specified as a decimal between -90.0 and 90.0.
Longitude: Longitudes are vertical lines that measure east or west of the meridian in Greenwich, England. The longitude must be specified as a decimal between -180.0 and 180.0.
Global_code: It is a 4 character area code and 6 character or longer local code (849VCWC8+R9).
Compound_code: Compound Code is a 6 character or longer local code with an explicit location (CWC8+R9 Mountain View, CA, USA is CWC8+R9 Mountain View CA USA).
Place_id: Place IDs uniquely identify a place in the Google Places database and on Google Maps.
Plus_code: Plus code is a geocode system for identifying any geographical area on Earth, even when a street address does not exist.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	address_latlong	Array List	Required	Latitude and longitude coordinates to be entered sequentially

Response:

S. No	Key	Data Type	Description
1	data	Object	Address details fetched based on given lat long
1.1	plus_code	Object	Geocoding details
1.1.1	compound_code	String	Refer: Compound code
1.1.2	global_code	String	Refer: Global Code
1.2	results	Object	Result object for given lat long
1.2.1	address_components	Object	Address component details like city, area, pincode, locality will be shown
1.2.1.1	long_name	Object	Complete Name of the address component
1.2.1.2	short_name	Object	Short name of the address component
1.2.1.3	types	Array List	Type of address component like pincode / city / locality etc.
1.2.2	formatted_address	String	Address based on given lat long and location type
1.2.3	geometry	Object	Geopraphic details
1.2.3.1	location	Array List	Lat, Long details will be shown
1.2.3.2	location_type	String	It refers to the angled views for the given lat long coordinates
1.2.3.3	viewport	Object	Details of anged view
1.2.3.3.1	northeast	Object	Northeast angled view lat long coordinates
1.2.3.3.2	southwest	Object	Sourthwest angled view lat long coordinates
1.2.4	place_id	String	Refer: Place_id
1.2.5	plus_code	Object	Refer: Plus_code
1.2.5.1	compound_code	String	Refer: Compound_code
1.2.5.2	global_code	String	Refer: Global_code
1.2.6	types	Array list	Type of address component like pincode / city / locality etc.
1.2.7	address_components	Object	Address component details like city, area, pincode, locality will be shown
1.2.7.1	long_name	String	Complete Name of the address component
1.2.7.2	short_name	String	Short name of the address component
1.2.7.3	types	Array list	Type of address component like pincode / city / locality etc.
1.2.8	long_name	String	Complete Name of the address component
1.2.8.1	short_name	String	Short name of the address component
1.2.8.2	types	Array List	Note: components like long_name, short_name and types will have concurrent entires for given fomratted address in the API response. Please refer to existing description for given fields
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

","urlObject":{"path":["reverse-geocoding"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"d58a55ee-8115-4aa8-b95b-692d3a142d05","name":"Successful Reverse Geocoding","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"address_latlong\": [\n 40.20260,\n -111.621959\n ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/reverse-geocoding"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 08:34:45 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"plus_code\": {\n \"compound_code\": \"693H+26M Provo, UT, USA\",\n \"global_code\": \"85GC693H+26M\"\n },\n \"results\": [\n {\n \"address_components\": [\n {\n \"long_name\": \"2335\",\n \"short_name\": \"2335\",\n \"types\": [\n \"street_number\"\n ]\n },\n {\n \"long_name\": \"Arkansas Avenue\",\n \"short_name\": \"Arkansas Ave\",\n \"types\": [\n \"route\"\n ]\n },\n {\n \"long_name\": \"Provost South\",\n \"short_name\": \"Provost South\",\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n }\n ],\n \"formatted_address\": \"2335 Arkansas Ave, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2025868,\n \"lng\": -111.6219523\n },\n \"location_type\": \"ROOFTOP\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.20393578029149,\n \"lng\": -111.6206033197085\n },\n \"southwest\": {\n \"lat\": 40.2012378197085,\n \"lng\": -111.6233012802915\n }\n }\n },\n \"place_id\": \"ChIJrY8RXaqXTYcR1uLbdpCIlFE\",\n \"plus_code\": {\n \"compound_code\": \"693H+26 Provo, UT, USA\",\n \"global_code\": \"85GC693H+26\"\n },\n \"types\": [\n \"street_address\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"Ste 200\",\n \"short_name\": \"Ste 200\",\n \"types\": [\n \"subpremise\"\n ]\n },\n {\n \"long_name\": \"2335\",\n \"short_name\": \"2335\",\n \"types\": [\n \"street_number\"\n ]\n },\n {\n \"long_name\": \"South State Street\",\n \"short_name\": \"S State St\",\n \"types\": [\n \"route\"\n ]\n },\n {\n \"long_name\": \"Provost South\",\n \"short_name\": \"Provost South\",\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n }\n ],\n \"formatted_address\": \"2335 S State St Ste 200, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2026246,\n \"lng\": -111.6219348\n },\n \"location_type\": \"ROOFTOP\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.2039735802915,\n \"lng\": -111.6205858197085\n },\n \"southwest\": {\n \"lat\": 40.2012756197085,\n \"lng\": -111.6232837802915\n }\n }\n },\n \"place_id\": \"ChIJ3RB0XaqXTYcR6cxiiwDpiko\",\n \"plus_code\": {\n \"compound_code\": \"693H+26 Provo, UT, USA\",\n \"global_code\": \"85GC693H+26\"\n },\n \"types\": [\n \"dentist\",\n \"establishment\",\n \"health\",\n \"point_of_interest\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"2335\",\n \"short_name\": \"2335\",\n \"types\": [\n \"street_number\"\n ]\n },\n {\n \"long_name\": \"South State Street\",\n \"short_name\": \"S State St\",\n \"types\": [\n \"route\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n },\n {\n \"long_name\": \"6576\",\n \"short_name\": \"6576\",\n \"types\": [\n \"postal_code_suffix\"\n ]\n }\n ],\n \"formatted_address\": \"2335 S State St, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.20265819999999,\n \"lng\": -111.6219724\n },\n \"location_type\": \"ROOFTOP\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.2039865302915,\n \"lng\": -111.6206223197085\n },\n \"southwest\": {\n \"lat\": 40.2012885697085,\n \"lng\": -111.6233202802915\n }\n }\n },\n \"place_id\": \"ChIJzQRyXaqXTYcRuxwnFYPQhPQ\",\n \"plus_code\": null,\n \"types\": [\n \"premise\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"State St @ 2301 S\",\n \"short_name\": \"State St @ 2301 S\",\n \"types\": [\n \"establishment\",\n \"point_of_interest\",\n \"transit_station\"\n ]\n },\n {\n \"long_name\": \"Spring Creek\",\n \"short_name\": \"Spring Creek\",\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n }\n ],\n \"formatted_address\": \"State St @ 2301 S, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.202209,\n \"lng\": -111.622071\n },\n \"location_type\": \"GEOMETRIC_CENTER\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.20355798029151,\n \"lng\": -111.6207220197085\n },\n \"southwest\": {\n \"lat\": 40.20086001970851,\n \"lng\": -111.6234199802915\n }\n }\n },\n \"place_id\": \"ChIJ2TDSRKqXTYcRqzg_fNReqhw\",\n \"plus_code\": {\n \"compound_code\": \"692H+V5 Provo, UT, USA\",\n \"global_code\": \"85GC692H+V5\"\n },\n \"types\": [\n \"establishment\",\n \"point_of_interest\",\n \"transit_station\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"693H+26\",\n \"short_name\": \"693H+26\",\n \"types\": [\n \"plus_code\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"693H+26 Provo, UT, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2026,\n \"lng\": -111.621959\n },\n \"location_type\": \"GEOMETRIC_CENTER\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.2039114802915,\n \"lng\": -111.6205885197085\n },\n \"southwest\": {\n \"lat\": 40.2012135197085,\n \"lng\": -111.6232864802915\n }\n }\n },\n \"place_id\": \"GhIJtRX7y-4ZREAR-xwfLc7nW8A\",\n \"plus_code\": {\n \"compound_code\": \"693H+26 Provo, UT, USA\",\n \"global_code\": \"85GC693H+26\"\n },\n \"types\": [\n \"plus_code\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"2138-2198\",\n \"short_name\": \"2138-2198\",\n \"types\": [\n \"street_number\"\n ]\n },\n {\n \"long_name\": \"Arkansas Avenue\",\n \"short_name\": \"Arkansas Ave\",\n \"types\": [\n \"route\"\n ]\n },\n {\n \"long_name\": \"Spring Creek\",\n \"short_name\": \"Spring Creek\",\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n }\n ],\n \"formatted_address\": \"2138-2198 Arkansas Ave, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2025233,\n \"lng\": -111.6221297\n },\n \"location_type\": \"GEOMETRIC_CENTER\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.2038669802915,\n \"lng\": -111.6207846697085\n },\n \"southwest\": {\n \"lat\": 40.2011690197085,\n \"lng\": -111.6234826302915\n }\n }\n },\n \"place_id\": \"ChIJMdP1QqqXTYcR_nVJitMpWM8\",\n \"plus_code\": null,\n \"types\": [\n \"route\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"Provost South\",\n \"short_name\": \"Provost South\",\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n }\n ],\n \"formatted_address\": \"Provost South, Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2150556,\n \"lng\": -111.6273187\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.2228081,\n \"lng\": -111.6173351\n },\n \"southwest\": {\n \"lat\": 40.200376,\n \"lng\": -111.6400562\n }\n }\n },\n \"place_id\": \"ChIJpShfOAWXTYcRLIoEZ7nLOaU\",\n \"plus_code\": null,\n \"types\": [\n \"neighborhood\",\n \"political\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"84606\",\n \"short_name\": \"84606\",\n \"types\": [\n \"postal_code\"\n ]\n },\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"Provo, UT 84606, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2120325,\n \"lng\": -111.6302998\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.246165,\n \"lng\": -111.5826629\n },\n \"southwest\": {\n \"lat\": 40.1831278,\n \"lng\": -111.660724\n }\n }\n },\n \"place_id\": \"ChIJH7vmP-WWTYcRWHRyuZp5mH4\",\n \"plus_code\": null,\n \"types\": [\n \"postal_code\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"Provo\",\n \"short_name\": \"Provo\",\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"Provo, UT, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.2338438,\n \"lng\": -111.6585337\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.328871,\n \"lng\": -111.5368551\n },\n \"southwest\": {\n \"lat\": 40.1857988,\n \"lng\": -111.7409621\n }\n }\n },\n \"place_id\": \"ChIJv_ELk3GSTYcR71a1ACbxkB0\",\n \"plus_code\": null,\n \"types\": [\n \"locality\",\n \"political\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"Utah County\",\n \"short_name\": \"Utah County\",\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"Utah County, UT, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 40.0966287,\n \"lng\": -111.5706786\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 40.5779141,\n \"lng\": -110.8576469\n },\n \"southwest\": {\n \"lat\": 39.7762461,\n \"lng\": -112.214178\n }\n }\n },\n \"place_id\": \"ChIJ1S-SARuWTYcRzxjbgtN-0vs\",\n \"plus_code\": null,\n \"types\": [\n \"administrative_area_level_2\",\n \"political\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"Utah\",\n \"short_name\": \"UT\",\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"Utah, USA\",\n \"geometry\": {\n \"location\": {\n \"lat\": 39.3209801,\n \"lng\": -111.0937311\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 42.001618,\n \"lng\": -109.0410581\n },\n \"southwest\": {\n \"lat\": 36.99790309999999,\n \"lng\": -114.0529979\n }\n }\n },\n \"place_id\": \"ChIJzfkTj8drTIcRP0bXbKVK370\",\n \"plus_code\": null,\n \"types\": [\n \"administrative_area_level_1\",\n \"political\"\n ]\n },\n {\n \"address_components\": [\n {\n \"long_name\": \"United States\",\n \"short_name\": \"US\",\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ],\n \"formatted_address\": \"United States\",\n \"geometry\": {\n \"location\": {\n \"lat\": 37.09024,\n \"lng\": -95.712891\n },\n \"location_type\": \"APPROXIMATE\",\n \"viewport\": {\n \"northeast\": {\n \"lat\": 71.5388001,\n \"lng\": -66.885417\n },\n \"southwest\": {\n \"lat\": 18.7763,\n \"lng\": 170.5957\n }\n }\n },\n \"place_id\": \"ChIJCzYy5IS16lQRQrfeQ5K5Oxw\",\n \"plus_code\": null,\n \"types\": [\n \"country\",\n \"political\"\n ]\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1672130085019,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"reverse_geocode_lLZGn2rwmPiWOPqmf0eJ\"\n}"}],"_postman_id":"1bda9b29-7b6b-4a71-9027-2b9a87b03740"}],"id":"1e5a6a77-6b05-411d-b065-f79a8fc7f114","description":"

Address is a very imporant component of any digital onboarding journey. AddressNet API is set of APIs that processes, changes, or manipulates addresses in order to make address data more useful, standard, complete, or valid.
AddressNet API lets you verify postal addresses programmatically.

AddressNet API consists of four APIs

Structure Address API
Compare Address API
Address Comparison API - Lat- Long
Reverse Geocoding API

\n","_postman_id":"1e5a6a77-6b05-411d-b065-f79a8fc7f114"},{"name":"Bank Account","item":[{"name":"UPI","id":"cfb371d7-6950-496a-be10-670beaa90494","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"upi_id\": \"upi_id\"\n}"},"url":"https://api.idcentral.io/idc/v2/bank/verify-upi","description":"

National Payment Corporation Of India (NPCI) developed an instant real time payment system called Unified Payment Interface (UPI) to promote digital payments in India. Every bank account holder who registers for UPI receives a unique virtual payment address (VPA). UPI is being used across all major banks, institutions and merchants to accept and transfer digital money.

This API can be used to verify if a provided VPA is correct and belongs to an active current or savings bank account. This also returns the name of the account holder.

What is VPA / UPI ID?

VPA stands for Virtual Payment Address which is basically the address to or through which you can make UPI money transfers. A VPA is a unique financial address using which you can send and/or receive money in your bank account through UPI.

Request: The UPI ID/ VPA is passed via endpoint URL.

Note: VPA / UPI ID validation structure is explained below.

Alphanumeric
Supports period (.), hyphen (-), at sign (@), and underscore (_).
- Underscore _(__) and dot (.) gets accepted before and after at sign (@), but hyphen (-) get accepted only before the at sign (@)
\n
100 character limit

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	String	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	String	Data contains the detailed information received
8.1	account_exists	Boolean	Status to validate if provided UPI ID exists and is valid. if the value is \"true\" then given UPI ID is valid and if the value is \"false\" then UPI ID not valid
8.2	upi_id	String	UPI ID passed in the request
8.3	full_name	String	Name of the UPI payment address holder. This is same as the name registered with associated bank account
8.4	remarks	String	Remarks from UPI records

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid UPI ID is entered	200	1	success	Successful Request
When invalid UPI ID is entered - correct format	200	2	success	The given UPI is invalid	Verification failed
When invalid UPI ID is entered - incorrect format	400	-1	failed	Please provide a valid UPI	Validation error

","urlObject":{"path":["v2","bank","verify-upi"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"d0601ddc-eca6-442a-a75d-033cd7f3f205","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"upi_id\": \"upi_id\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-upi"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 22 May 2023 05:28:07 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_upi_id_sEpZTUhzaiJm2WLinGJg\",\n \"timestamp\": 1684733286770,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"account_exists\": true,\n \"upi_id\": \"upi_id\",\n \"full_name\": \"full_name\",\n \"remarks\": \"\"\n }\n}"},{"id":"fe04f032-cd12-41bf-b3de-9977c1d3ba8c","name":"Invalid UPI - Correct format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"upi_id\": \"invalid_UPI\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-upi"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 22 May 2023 05:51:58 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_upi_id_uOZ4seSMsiEjM6UL4LaG\",\n \"timestamp\": 1684734823944,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The given UPI is invalid\",\n \"data\": null\n}"},{"id":"075eb771-058c-425c-9f48-27008b104d1d","name":"Invalid UPI - wrong format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"upi_id\": \"Invalid_upi_id\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-upi"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 22 May 2023 05:28:07 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_upi_id_C6KYh9obmBHoOmwAKIDW\",\n \"timestamp\": 1684734718939,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid UPI\",\n \"data\": null\n}"}],"_postman_id":"cfb371d7-6950-496a-be10-670beaa90494"},{"name":"Bank Account Verification","id":"8aa9e00c-77e8-41bd-b595-9ea7723806fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"424720XXXX0243\",\n \"ifsc\": \"BKID000XXXXX\",\n \"extended_data\": true\n \n}"},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank","description":"

Bank Account Verification API offers an instant verification of active savings and current bank account, given account number and IFSC code. This API can be used to filter out inactive or invalid bank accounts before direct deposits or payouts (loans, transfers, micro lending, EMI, credits) to individuals and vendors.

Bank Account Verification uses the IMPS network. Verification will return the account holder name for any valid IFSC of the bank where the account exists.

If client wishes to get reponse codes recieved from NPCI of the transaction, an additional parameter \"extended_data\" can be added in request body.

Definition

Extended Data - Extended Data is an additional data fields that we get along with full name in response. there can be only 2 possible values for it, either true or false.

Scenarios for Extended data-
True - When you set it as true Bank Account Verification API gives you two additional data fields, NPCI back office response code and NPCI Online response code. These response codes are populated by the beneficiary bank to know the status of the transaction.

False - When you set it as false Bank Account Verification API gives you only beneficiary name in response.

NPCI Back Office Response Code : NPCI back office response code is a code that is generated by NPCI's back-end systems in response to a transaction request or query received from a member bank or a payment service provider.

NPCI Online Response Code : Online response code is a code that is generated by NPCI's systems in real-time in response to a transaction request made by a user or a merchant.

Request -

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Bank account to be validated (6 to 40 character limit)
2	ifsc	String	Required	IFSC of the bank account to be validated (standard IFSC format - length 11, first four bank IFSC and 5th 0)
3	extended_data	Boolean	Optional	Possible values true / false. Set this as true when you Extended Data is required

Response -

S. No	key	Data Type	Description
1	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
2	timestamp	Integer	API response receive time in milliseconds
3	status	String	A text content confirms if API request was successfully completed or not. If value success then request was successfully processed and received response. and if failed then request failed due to error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	A text content explains a reason if API request failed
7	message	String	A text content explains if API request was successful or not.
8	data	Object	Information fetched from the asscoiated Bank Records
9	remarks	String	Remark from Bank records
10	account_exists	Boolean	Status to validate if provided bank account is valid and active. if value true then account exists and if false then account does not exist
11	upi_id	String	UPI id associated with account number
12	full_name	String	Full name of the account holder as per Bank records
13	Note-When extended_data is set as true. npci_bo_response_code	String	NPCI back office response code which is generated by NPCI's back-end systems
14	Note-When extended_data is set as true. npci_online_response_code	String	Online response code is a code which is generated by NPCI's systems in real-time
15	Note-When extended_data is set as true. npci_status_code	String	NPCI status code is given by the bank partner
16	Note-When extended_data is set as true. npci_status_description	String	NPCI status description describes the meaning od status code

Scenarios Covered

S. No	Scenario	Status Code	Response Code	Remarks	Message
1	Success Scenario when Extended data is true	200	1	Successful	Successful request
2	Success Scenario when Extended data is false	200	1	Successful	Successful request
3	Success Scenario when extended data is not given	200	1	Successful	Successful request
4	When Invalid Account Number is provided	200	2	INVALID ACCOUNT	Invalid Account Number
5	When Invalid IFS code is provided	200	3		Invalid IFSC
6	Beneficiary Bank Is Not Enable For P2A	200	5	IMPSERROR:IMPS Service not available for the selected bank	Beneficiary Bank Is Not Enable For P2A
7	When Account is Closed	200	6	BENEFICIARY ACCOUNT IS CLOSED	Beneficiary account is blocked/frozen
8	When Account is Blocked/frozen	200	6	BENEFICIARY ACCOUNT BLOCKED/FROZEN	Beneficiary account is blocked/frozen
9	When Account is NRE	200	7	NPCIERROR:BENEFICIARY ACCOUNT IS NRE ACCOUNT AND REVERSAL IS SUCCESSFUL	Beneficiary account is NRE account
10	No response received from IMPS	200	8		No Response Received From IMPS
11	Amount limit exceeded	500	88	AMOUNT LIMIT EXCEEDED	Internal error
12	Bank Server Down	500	99		Bank Server Down

","urlObject":{"path":["v2","bank","verify-bank"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7b74b159-7457-494e-be49-1bc92a798780","name":"Successful Scenario when Extended Data is true","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"8528012XXXXX87\",\n \"ifsc\": \"PXXXXSUPGB5\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:12:18 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_zZRPn4xZ8Vi0S3MMrDsI\",\n \"timestamp\": 1681751538005,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\":\"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"PRAVESH W/O LOKESH\",\n \"npci_bo_response_code\": \"00\",\n \"npci_online_response_code\": \"00\",\n \"npci_status_code\": null,\n \"npci_status_description\":\"\"\n }\n}"},{"id":"0275f932-4283-467a-93fd-b0050ed0e7e0","name":"Bank Server Down","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"8528012XXXXX87\",\n \"ifsc\": \"PXXXXSUPGB5\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:12:18 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_zZRPn4xZ8Vi0S3MMrDsI\",\n \"timestamp\": 1679912523884,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Verification failed\",\n \"message\": \"Bank Server Down\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": null,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"7490792d-fd2f-47ac-afe3-0a9e04b727b0","name":"Successful Scenario when Extended data is false","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXX\",\n \"ifsc\": \"PUNB0SUPGB5\",\n \"extended_data\": false\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:13:03 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_VNpk549pI5Rr2foNGVXK\",\n \"timestamp\": 1681751582891,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"PRAVESH W/O LOKESH\"\n }\n}"},{"id":"e21c94ea-7ce9-4af8-a759-c96b89c4f8a3","name":"Beneficiary Account is Blocked","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"441XXXXX\",\n \"ifsc\": \"CNXXXXXXXX\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 16:49:27 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_jFnJKujHBIlQSryv84Dt\",\n \"timestamp\": 1681750166280,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 6,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is blocked/frozen\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"npci_bo_response_code\": \"M3\",\n \"npci_online_response_code\": \"M3\",\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"e4f17f13-8076-4246-bbbf-c0593be1e55c","name":"Amount Limit Exceeded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXX\",\n \"ifsc\": \"BKID0004247\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:09:58 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_VZc8KTbTTsrwNMMdHB0o\",\n \"timestamp\": 1681751392827,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 88,\n \"error\": \"Verification failed\",\n \"message\": \"Internal error\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"e0a1e506-3e81-4aa9-a8bb-451a80f2f0c5","name":"Beneficiary Account is Closed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"2903131001186\",\n \"ifsc\": \"CNRB0002903\",\n \"extended_data\": true\n \n}"},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:11:35 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_eIMqTby8LaQ3wnXuMZMc\",\n \"timestamp\": 1681751494112,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 6,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is blocked/frozen\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"npci_bo_response_code\": \"M3\",\n \"npci_online_response_code\": \"M3\",\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"2fe21ff3-70b5-4f3d-b924-017c22826ec8","name":"Invalid Account Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXX\",\n \"ifsc\": \"CITI0000005\",\n \"extended_data\": false\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:13:50 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_bSlZOhw94AKwDLeFBVxq\",\n \"timestamp\": 1681751628785,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid Account Number\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\"\n }\n}"},{"id":"ef396f4d-5fc0-4097-b628-1c552448ca58","name":"Internal Error","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXXXX\",\n \"ifsc\": \"IDFB0041241\",\n \"extended_data\": false\n \n}"},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:14:26 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_tCpSUfHyJV2fpdK7tnMw\",\n \"timestamp\": 1681751666089,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 88,\n \"error\": \"Verification failed\",\n \"message\": \"Internal error\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\"\n }\n}"},{"id":"d8feaa9c-558c-4199-85bf-9b939964e8e4","name":"Beneficiary Bank Is Not Enable For P2A","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXXX\",\n \"ifsc\": \"BUIN0914746\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcv2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:15:28 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_bcvdhPkBegjRSwsjJWL1\",\n \"timestamp\": 1681751728115,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary Bank Is Not Enable For P2A\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"npci_bo_response_code\": \"MP\",\n \"npci_online_response_code\": \"MP\",\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"1d81b4bd-bcc1-4370-82ff-e48fb3b32cab","name":"Beneficiary account is NRE account","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"https://api.idcentral.io/idc"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXXX\",\n \"ifsc\": \"RATN0000141\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 18 Apr 2023 05:01:56 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_0qLflU3jE5xXsAb2C6N6\",\n \"timestamp\": 1681794114640,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 7,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is NRE account\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"npci_bo_response_code\": \"M4\",\n \"npci_online_response_code\": \"M4\",\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"},{"id":"58b3e8e7-6f2b-445a-9f76-8f7400109668","name":"No Response Received From IMPS","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"XXXXXXXXXX\",\n \"ifsc\": \"TREW0ARYAGB\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 18 Apr 2023 10:14:37 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_4DKlWypp3USKd0OgU9fP\",\n \"timestamp\": 1681812859721,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 8,\n \"error\": \"Verification failed\",\n \"message\": \"No Response Received From IMPS\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"PDNG\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"56b0f7af-d0f2-4cdc-9b10-ea21a9d21ec3","name":"Invalid IFS Code","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"720XXXXX2909\",\n \"ifsc\": \"TNSC0011400\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"{{apikey}}/v2/bank/verify-bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 18 Apr 2023 11:44:04 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_bank_account_E0eo4BN8hq0TtPx5WDtu\",\n \"timestamp\": 1681818241100,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid IFSC\",\n \"data\": {\n \"remarks\":\"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"MJ\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"}],"_postman_id":"8aa9e00c-77e8-41bd-b595-9ea7723806fb"},{"name":"Penny-Less BAV","id":"627796ea-a4e0-4454-8150-8d081f05de94","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"XXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less","description":"

Penny-Less Bank account verification API offers an instant verification of active savings and current bank account, given account number and IFSC code. This API can be used to filter out inactive or invalid bank accounts before direct deposits or payouts (loans, transfers, micro lending, EMI, credits) to individuals and vendors.

Penny-Less Bank account verification uses the IMPS network. Verification will return the account holder name for any valid IFSC of the bank where the account exists.

Note - Only selected banks support Penny-less Bank Account Verification and is incremental.
Please refer the list of Selected Banks (Note - This list is subject to change without any notice) for Penny-Less for selected banks.

If client wishes to get response codes received from NPCI of the transaction, an additional parameter \"extended_data\" can be added in request body.

Definition

Extended Data - Extended Data is an additional data fields that we get along with full name in response. there can be only 2 possible values for it, either true or false.

False - When you set it as false Bank Account Verification API gives you only beneficiary name in response.

NPCI Online Response Code : Online response code is a code that is generated by NPCI's systems in real-time in response to a transaction request made by a user or a merchant.

Request -

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Bank account to be validated (6 to 40 character limit)
2	ifsc	String	Required	IFSC of the bank account to be validated (standard IFSC format - length 11, first four bank IFSC and 5th 0)
3	extended_data	Boolean	Optional	Possible values can be true / false. Set this as true when you Extended Data is required. Refer to Extended data definition

Response -

S. No	key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received.
9	remarks	String	Remark from Bank records
10	account_exists	Boolean	Status to validate if provided bank account is valid and active. if value true then account exists and if false then account does not exist
11	upi_id	String	UPI id associated with account number
12	full_name	String	Full name of the account holder as per Bank records
13	Note-When extended_data is set as true. npci_bo_response_code	String	NPCI back office response code which is generated by NPCI's back-end systems
14	Note-When extended_data is set as true. npci_online_response_code	String	Online response code is a code which is generated by NPCI's systems in real-time
15	Note-When extended_data is set as true. npci_status_code	String	NPCI status code is given by the bank partner
16	Note-When extended_data is set as true. npci_status_description	String	NPCI status description describes the meaning od status code

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Sr. No	Scenario	Status Code	Response Code	Remarks	Message
1	Success Scenario when Extended data is true	200	1	Successful	Successful request
2	Success Scenario when Extended data is false	200	1	Successful	Successful request
3	Success Scenario when Extended data is not given	200	1	Successful	Successful request
4	When Invalid Account Number is provided	200	2		Invalid Account Number
5	When Invalid IFS code is provided	200	3		Invalid IFSC
6	Beneficiary Bank Is Not Enable For P2A (When given bank doesn't support Penny less)	200	5		Beneficiary Bank Is Not Enable For P2A
7	Beneficiary account is blocked/frozen	200	6		Beneficiary account is blocked/frozen
8	No Response Received From IMPS	200	8		No Response Received From IMPS
9	Bank Server Down	500	99		Bank Server Down

","urlObject":{"path":["v2","bank","penny-less"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"272d6d67-fa78-42d2-a3fb-9c447cf80503","name":"Success Scenario when Extended data is true","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 14:48:20 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_NgwzeugB2Pi8OXXXXXXX\",\n \"timestamp\": 1680101296466,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXXXXXXXXX\",\n \"npci_bo_response_code\": \"00\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"ACSC\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"cf65b4c3-2ac6-4598-9ff3-0b1aa001dc6c","name":"Success Scenario when Extended data is false","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"92XXXXXXXXX\",\r\n \"ifsc\": \"UTIXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:01:32 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_ZxDc3ma6t6W3Bxxxxxx\",\n \"timestamp\": 1680102089094,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXXXXXXXXX\"\n }\n}"},{"id":"fd7b3dba-aae2-4d8e-b6d8-ba8cf463068b","name":"Sucess Scenario when extended data is not given","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 30 Mar 2023 09:40:00 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_6qXwZ1fy1GTwfUIcgymL\",\n \"timestamp\": 1680169195868,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXXXXXXXXX\"\n }\n}"},{"id":"fd627dfb-b632-4c3a-b9c0-921bc58104c4","name":"Internal Error","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"92XXXXXXXXX\",\r\n \"ifsc\": \"UTIXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:01:32 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bank_penny_less_DhdjZ7JzpgkchsxPBMh9\",\n \"timestamp\": 1679912523884,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 88,\n \"error\": \"Verification failed\",\n \"message\": \"Internal error\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"M2\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"c0ca14f1-076f-42e4-899a-836edeec80bc","name":"Invalid IFS code","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:16:33 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_7LiZA8NV3ilwUWU9OgY7\",\n \"timestamp\": 1680102989686,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid IFSC\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"MJ\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"2fd801be-452f-4d70-b304-6d353de95c6e","name":"Beneficiary account is blocked/frozen","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:24:37 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_g1yAMsR6JXgHtGOW7zdn\",\n \"timestamp\": 1680103473414,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 6,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is blocked/frozen\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"M5\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"90214db8-79db-4bbd-b3e3-21220216ae49","name":"Benificary Bank Not Enable For P2A","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:26:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_Ld4Ims8t5AGyONuOWhXz\",\n \"timestamp\": 1680103601820,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary Bank Is Not Enable For P2A\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"MP\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"5a998e97-d82d-46ad-9ca6-8666e77e44f6","name":"No Response Received From IMPS","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:29:16 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_4bLUWNjCRtTpLUV6flm5\",\n \"timestamp\": 1680103738599,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 8,\n \"error\": \"Verification failed\",\n \"message\": \"No Response Received From IMPS\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"PDNG\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"97afdd02-a948-451a-bffa-45427c8e8205","name":"Invalid Account Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-less"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:30:33 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennyless_bav_india_82JztR0BKOQVt0GoquaB\",\n \"timestamp\": 1680103830084,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid Account Number\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"52\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"3d86f592-76c8-45bd-aa02-e81a8455805f","name":"Bank Server Down","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"8528012XXXXX87\",\n \"ifsc\": \"PXXXXSUPGB5\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:12:18 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bank_penny_less_DhdjZ7JzpgkchsxPBMh9\",\n \"timestamp\": 1679912523884,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Verification failed\",\n \"message\": \"Bank Server Down\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": null,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": null,\n \"npci_status_description\":\"\"\n }\n}"}],"_postman_id":"627796ea-a4e0-4454-8150-8d081f05de94"},{"name":"Penny-Drop BAV","id":"22c17c03-1876-4a7f-955d-122d6b7776ed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop","description":"

Penny-Drop Bank Account Verification API offers an instant verification of active savings and current bank account, given account number and IFSC code. This API can be used to filter out inactive or invalid bank accounts before direct deposits or payouts (loans, transfers, micro lending, EMI, credits) to individuals and vendors.

In Penny-Drop Bank Account Verification the bank sends a small amount, usually one penny, to the account holder's bank account. The account holder is then required to confirm the amount deposited to verify their ownership of the account. This method is often used as a security measure when linking bank accounts to third-party services, such as payment processors or money transfer services. It helps to prevent fraudulent activity by confirming that the person trying to access the account is the rightful owner.

Penny-Drop Bank Account Verification uses the IMPS network. Verification will return the account holder name for any valid IFSC of the bank where the account exists.

If client wishes to get response codes received from NPCI of the transaction, an additional parameter \"extended_data\" can be added in request body.

Definition

Extended Data - Extended Data is an additional data fields that we get along with full name in response. there can be only 2 possible values for it, either true or false.

False - When you set it as false Bank Account Verification API gives you only beneficiary name in response.

NPCI Online Response Code : Online response code is a code that is generated by NPCI's systems in real-time in response to a transaction request made by a user or a merchant.

Request -

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Bank account to be validated (6 to 40 character limit)
2	ifsc	String	Required	IFSC of the bank account to be validated (standard IFSC format - length 11, first four bank IFSC and 5th 0)
3	extended_data	Boolean	Optional	Possible values true / false. Set this as true when you Extended Data is required

Response -

S. No	key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received.
9	remarks	String	Remark from Bank records
10	account_exists	Boolean	Status to validate if provided bank account is valid and active. if value true then account exists and if false then account does not exist
11	upi_id	String	UPI id associated with account number
12	full_name	String	Full name of the account holder as per Bank records
13	Note-When extended_data is set as true. npci_bo_response_code	String	NPCI back office response code which is generated by NPCI's back-end systems
14	Note-When extended_data is set as true. npci_online_response_code	String	Online response code is a code which is generated by NPCI's systems in real-time
15	Note-When extended_data is set as true. npci_status_code	String	NPCI status code is given by the bank partner
16	Note-When extended_data is set as true. npci_status_description	String	NPCI status description describes the meaning od status code

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status Code	Response Code	Remarks	Message
1	Success Scenario when Extended data is true	200	1	Successful	Successful request
2	Success Scenario when Extended data is false	200	1	Successful	Successful request
3	Success Scenario when extended data is not given	200	1	Successful	Successful request
4	When Invalid Account Number is provided	200	2	Invalid account	Invalid Account Number
5	When Invalid IFS code is provided	200	3	Invalid IFSC Code	Invalid IFSC
6	When Account is Closed	200	6	Account Closed	Beneficiary account is blocked/frozen
7	When Account is NRE	200	7	NRE Account	Beneficiary account is NRE account
8	Bank Server Down	500	99		Bank Server Down

","urlObject":{"path":["v2","bank","penny-drop"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"a882c2d4-3c40-421a-a1eb-0a129578e169","name":"Success Scenario when Extended data is true","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:39:47 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_TuWF8VLQuLQ7TU6LZvaM\",\n \"timestamp\": 1680104382901,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXXXXXXXXX\",\n \"npci_bo_response_code\": \"00\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"ACSC\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"748cb345-3b9a-4b98-a809-3e5c931f8c7d","name":"Success Scenario when Extended data is false","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 17:30:15 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_w6k8OkxReXwVGbHZooNg\",\n \"timestamp\": 1680111011908,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"xxxxxxxxxx xxxxxxxx\"\n }\n}"},{"id":"01395590-244c-4634-9344-bd2556562ba0","name":"Successful Scenario when Extended data is not given","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXXXXXXXXX\",\r\n \"ifsc\": \"UXXXXXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 30 Mar 2023 09:53:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_3qRvRXi9HcrnP29kdVgX\",\n \"timestamp\": 1680170033618,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXXXXXXXXXXXXX\"\n }\n}"},{"id":"fdcc3dc5-dc1e-4185-99d8-365b590abe09","name":"Invalid Account Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 16:09:10 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_9d8gmvbgpKtK7dSqLpUn\",\n \"timestamp\": 1680106139772,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid Account Number\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"52\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"478d4de7-a483-4679-ab8f-11d7f552513e","name":"NRE Account","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 16:09:10 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_oheKAS0gTf110Y7xX2Pn\",\n \"timestamp\": 1680683010592,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 7,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is NRE account\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"M4\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"f791309f-4c8b-4f9c-8faa-01325294adf9","name":"Invalid IFS Code","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 15:40:22 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_9GjxDIcNapVUNf72ThFL\",\n \"timestamp\": 1680104420322,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid IFSC\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null\n }\n}"},{"id":"6d1136b5-20c5-48de-a299-1ebeaec88588","name":"No Response Received from IMPS","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\": \"0030XXXXXXXXX\",\r\n \"ifsc\": \"HDFXXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 04 Apr 2023 10:16:30 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_eglh2ZmORRiZkCQBMF57\",\n \"timestamp\": 1680603372705,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 8,\n \"error\": \"Verification failed\",\n \"message\": \"No Response Received From IMPS\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"PDNG\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"ae9f1fdc-99df-45a5-8f11-2a492d89ed8e","name":"Internal Error","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\":\"4XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank/penny-drop"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 05 Apr 2023 02:25:00 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_ioAYeVUGrIBXZdiAA5ur\",\n \"timestamp\": 1680661497403,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Verification failed\",\n \"message\": \"Internal error\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"30\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"11afd838-079f-4592-86cd-f331611b71fc","name":"Account is closed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n \"account_number\":\"XXXXXXXXX\",\r\n \"ifsc\":\"XXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/penny-drop"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 05 Apr 2023 10:34:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_D6tnQjYFWButq6i17TAu\",\n \"timestamp\": 1680690895692,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 6,\n \"error\": \"Verification failed\",\n \"message\": \"Beneficiary account is blocked/frozen\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": \"M5\",\n \"npci_online_response_code\": null,\n \"npci_status_code\": \"RJCT\",\n \"npci_status_description\": \"\"\n }\n}"},{"id":"71291c95-d697-4a50-a3ad-846842a8fd18","name":"Bank Server Down","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"account_number\": \"8528012XXXXX87\",\n \"ifsc\": \"PXXXXSUPGB5\",\n \"extended_data\": true\n \n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/bank/verify-bank"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 17 Apr 2023 17:12:18 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pennydrop_bav_india_D6tnQjYFWButq6i17TAu\",\n \"timestamp\": 1679912523884,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Verification failed\",\n \"message\": \"Bank Server Down\",\n \"data\": {\n \"remarks\": \"\",\n \"account_exists\": null,\n \"upi_id\": null,\n \"full_name\": null,\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null,\n \"npci_status_code\": null,\n \"npci_status_description\": \"\"\n }\n}"}],"_postman_id":"22c17c03-1876-4a7f-955d-122d6b7776ed"},{"name":"Mobile Number to Name","id":"764fe107-3475-472d-889b-5f99e0e30775","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"94fb7e5173513391f50e1b1be4a4f0c4","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"{{mobile_number}}\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/upi/mobile","description":"

The \"Mobile to UPI VPA\" API allows users to retrieve the account holder's name and UPI ID by providing a mobile number as input.

Request-

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	mobile_number	Number	Required	Mobile Number (10 digits)

Response -

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received.
9	account_name	Text	Account holder's name
10	account_status	Text	Valid/ Invalid
11	mobile_number	Number	Mobile Number
12	upi_id	Text	UPI ID linked to mobile number

Scenarios Covered-

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status Code	Response Code	Message
1	Successful Scenario	200	1	Successful request
2	When no UPI is linked to given mobile number	200	2	No linked UPI ID for the given mobile number
3	When mobile number is invalid	400	-1	Please enter valid mobile number

","urlObject":{"path":["v2","upi","mobile"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"4fe576d3-3021-43fa-8c49-7235756f88ef","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"94fb7e5173513391f50e1b1be4a4f0c4","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"{{mobile_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/upi/mobile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin,Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"Server","value":""},{"key":"X-Powered-By","value":""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Thu, 07 Dec 2023 05:59:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"mobile_number_to_name_NriyvXZ2QCFGGBY5DlRC\",\n \"timestamp\": 1701928789587,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"account_name\": \"account_name\",\n \"account_status\": \"valid\",\n \"mobile_number\": \"mobile_number\",\n \"upi_id\": \"xyz@upi\"\n }\n}"},{"id":"3c777df4-a687-465e-967e-89236a91cdfc","name":"Invalid Mobile Number (more or less than 10 digits)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"{{mobile_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/upi/mobile"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin,Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"Server","value":""},{"key":"X-Powered-By","value":""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Thu, 07 Dec 2023 07:55:01 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"mobile_number_to_name_VMgUs7O8p5TIas75kYgy\",\n \"timestamp\": 1701935701545,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Invalid mobile number\",\n \"message\": \"Please enter valid mobile number\",\n \"data\": null\n}"},{"id":"2a147e8b-2dc1-427e-93c6-49edead7a388","name":"No UPI linked to Mobile Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"{{mobile_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/upi/mobile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin,Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"Server","value":""},{"key":"X-Powered-By","value":""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Thu, 07 Dec 2023 07:57:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"mobile_number_to_name_ejhHVwyCe8gbqNZuanFY\",\n \"timestamp\": 1701935830125,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"No linked UPI ID for the given mobile number\",\n \"data\": {\n \"account_status\": \"invalid\",\n \"mobile_number\": \"mobile_number\"\n }\n}"},{"id":"1cb8fd3d-0364-493a-8f97-b5fa6af53f80","name":"Invalid Mobile Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"{{mobile_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/upi/mobile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin,Accept-Encoding"},{"key":"Content-Encoding","value":"gzip"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"Server","value":""},{"key":"X-Powered-By","value":""},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"Content-Type","value":"application/json"},{"key":"Date","value":"Thu, 07 Dec 2023 07:57:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"mobile_number_to_name_ejhHVwyCe8gbqNZuanFY\",\n \"timestamp\": 1701935830125,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"The provided mobile number is not valid.\",\n \"data\": {\n \"account_status\": \"invalid\",\n \"mobile_number\": \"mobile_number\"\n }\n}"}],"_postman_id":"764fe107-3475-472d-889b-5f99e0e30775"}],"id":"5bb8051b-5cbf-43af-8082-043f1c719771","description":"

Verifying the beneficiary bank account details ensures that the right details are available to you to process payments. It may sometimes be mandatory to verify the beneficiary bank accounts to process online payments in sectors such as securities, mutual funds, and so on. This API, ensures that the transfers are successfully made to the beneficiary accounts. It minimises failed or transfer reversals from the bank. You can verify beneficiary bank account details using the dashboard or integrate using the bank account verification API.

IDcentral offers four methods in which bank account can be verified using API services

UPI
Bank Account Verification
Penny-Less BAV
Penny-Drop BAV

\n","_postman_id":"5bb8051b-5cbf-43af-8082-043f1c719771"},{"name":"CKYC","item":[{"name":"search","id":"cc45293a-28c4-48dd-a3b3-063792c202e9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"in Excepteur ullamco tempor consequat"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"fi_code\": \"incididunt in ex\",\n \"id_no\": \"qui sunt ullamco\",\n \"unique_request_id\": \"Lorem reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/search","description":"

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Parameter	Meaning
fi_code	Financial Institution code for the CKYC account
id_no	PAN number of the customer
unique_request_id	Unique identifier for the request

","urlObject":{"path":["kyc","ckyc","search"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"18fd2144-15b8-49a0-a646-454689d5b729","name":"OK","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"fi_code\": \"3536616\",\n \"id_no\": \"ABCDE1234F\",\n \"unique_request_id\": \"12245\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/search"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"search_response\": {\r\n \"ckyc_number\": \"{CKYC Number Here}\",\r\n \"name\": \"MR VIKRAM KUMAR \",\r\n \"fathers_name\": \"Mr VIJAY KUMAR\",\r\n \"age\": \"35\",\r\n \"image_type\": \"jpg\",\r\n \"photo\": \"{Base64 Value of Image}\",\r\n \"kyc_date\": \"05-04-2018\",\r\n \"updated_date\": \"05-04-2018\",\r\n \"remarks\": \"\"\r\n }\r\n}\r\n"}],"_postman_id":"cc45293a-28c4-48dd-a3b3-063792c202e9"},{"name":"download","id":"4135e1e9-2e62-40ee-822b-9562c4e45344","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"in Excepteur ullamco tempor consequat"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"dolor\",\n \"date_of_birth\": \"veniam magna\",\n \"fi_code\": \"enim sit dolor nisi\",\n \"unique_request_id\": \"consequat veniam reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download","urlObject":{"path":["kyc","ckyc","download"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"e85f000c-0752-4242-b2a0-16f4f670fd1d","name":"OK","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"123456\",\n \"date_of_birth\": \"23-05-1987\",\n \"fi_code\": \"123456\",\n \"unique_request_id\": \"123\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\r\n \"success\": true,\r\n \"download_response\": {\r\n \"personal_details\": {\r\n \"ckyc_number\": \"\",\r\n \"type\": \"INDIVIDUAL/CORP/HUF etc\",\r\n \"kyc_type\": \"normal/ekyc/minor\",\r\n \"prefix\": \"MR\",\r\n \"first_name\": \"VIJAY\",\r\n \"middle_name\": \"\",\r\n \"last_name\": \"KUMAR\",\r\n \"full_name\": \"MR VIJAY KUMAR\",\r\n \"maiden_prefix\": \"\",\r\n \"maiden_first_name\": \"\",\r\n \"maiden_middle_name\": \"\",\r\n \"maiden_last_name\": \"\",\r\n \"maiden_full_name\": \"\",\r\n \"father_spouse_flag\": \"father/spouse\",\r\n \"father_prefix\": \"Mr\",\r\n \"father_first_name\": \"VIKRAM\",\r\n \"father_middle_name\": \"\",\r\n \"father_last_name\": \"KUMAR\",\r\n \"father_full_name\": \"Mr VIKRAM KUMAR\",\r\n \"mother_prefix\": \"Mrs\",\r\n \"mother_first_name\": \"\",\r\n \"mother_middle_name\": \"\",\r\n \"mother_last_name\": \"\",\r\n \"mother_full_name\": \"\",\r\n \"gender\": \"M\",\r\n \"dob\": \"{}\",\r\n \"pan\": \"{}\",\r\n \"perm_address_line1\": \"B1 2ND FLOOR\",\r\n \"perm_address_line2\": \"PURVA SUNSHINE\",\r\n \"perm_address_line3\": \"HSR LAYOUT SECTOR 2\",\r\n \"perm_address_city\": \"BANGALORE\",\r\n \"perm_address_dist\": \"BANGALORE\",\r\n \"perm_address_state\": \"KA\",\r\n \"perm_address_country\": \"IN\",\r\n \"perm_address_pincode\": \"560102\",\r\n \"perm_current_same\": \"Y/N\",\r\n \"corr_address_line1\": \"B1 2ND FLOOR\",\r\n \"corr_address_line2\": \"PURVA SUNSHINE\",\r\n \"corr_address_line3\": \"HSR LAYOUT SECTOR 2\",\r\n \"corr_address_city\": \"BANGALORE\",\r\n \"corr_address_dist\": \"BANGALORE\",\r\n \"corr_address_state\": \"KA\",\r\n \"corr_address_country\": \"IN\",\r\n \"corr_address_pincode\": \"560102\",\r\n \"mobile_no\": \"{}\",\r\n \"email\": \"{}@GMAIL.COM\",\r\n \"date\": \"05-04-2018\",\r\n \"place\": \"Bangalore\"\r\n },\r\n \"id_details\": [\r\n {\r\n \"type\": \"PAN\",\r\n \"id_no\": \"{}\",\r\n \"ver_status\": true\r\n }\r\n ],\r\n \"images\": [\r\n {\r\n \"image_type\": \"PHOTO\",\r\n \"type\": \"jpg/pdf\",\r\n \"data\": \"{BASE64}\"\r\n },\r\n {\r\n \"image_type\": \"PAN\",\r\n \"type\": \"jpg/pdf\",\r\n \"data\": \"{BASE64}\"\r\n },\r\n {\r\n \"image_type\": \"AADHAAR/PASSPORT/VOTER/DL\",\r\n \"type\": \"jpg/pdf\",\r\n \"data\": \"{BASE64}\"\r\n },\r\n {\r\n \"image_type\": \"SIGNATURE\",\r\n \"type\": \"jpg/pdf\",\r\n \"data\": \"{BASE64}\"\r\n }\r\n ]\r\n}\r\n\r\n}\r\n"},{"id":"b64ad40d-637e-4f72-96d6-5842b4b1382b","name":"Created","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"dolor\",\n \"date_of_birth\": \"veniam magna\",\n \"fi_code\": \"enim sit dolor nisi\",\n \"unique_request_id\": \"consequat veniam reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download"},"status":"Created","code":201,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"09d4336b-b8a7-4206-8b43-32f49ee27e61","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"dolor\",\n \"date_of_birth\": \"veniam magna\",\n \"fi_code\": \"enim sit dolor nisi\",\n \"unique_request_id\": \"consequat veniam reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"57ff476c-03fe-4df7-8f2b-71b1193d5229","name":"Forbidden","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"dolor\",\n \"date_of_birth\": \"veniam magna\",\n \"fi_code\": \"enim sit dolor nisi\",\n \"unique_request_id\": \"consequat veniam reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download"},"status":"Forbidden","code":403,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"b5debf38-0d0a-48bd-aac8-31e3b2285795","name":"Not Found","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"in Excepteur ullamco tempor consequat"}],"body":{"mode":"raw","raw":"{\n \"ckyc_no\": \"dolor\",\n \"date_of_birth\": \"veniam magna\",\n \"fi_code\": \"enim sit dolor nisi\",\n \"unique_request_id\": \"consequat veniam reprehenderit\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/kyc/ckyc/download"},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"4135e1e9-2e62-40ee-822b-9562c4e45344"}],"id":"ad12e8e3-1c89-455b-8922-b8852a1e9116","description":"

What is cKYC?

Central Know Your Customer (CKYC) is an initiative of the India Government where a centralized registry of KYC records of customers in the financial sector is maintained. Central Registry of Securitization Asset Reconstruction and Security Interest of India (CERSAI) is introduced to centralize and digitize customer KYC documents to reduce repeated KYC verification.

It works by uploading customers/individual’s KYC data and images into the CKYC-R through the financial institution and retrieving the unique 14 digit CKYC number. A CKYC automated solution that assists the financial institution in meeting the Guidelines and prerequisites of CERSAI, RBI, IRDA, and PFRDA rules.

CKYC search and download API can be used to check if the user details are present on the CKYC (CERSAI) repository. If details are present, those documents can be used to do the KYC of the user.

CKYC Search and download can be performed using one of the IDs mentioned below:

PAN
Aadhaar
Passport
Voter ID
Driving License
CKYC number

Document Type

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	ID Number
PAN	10 digit PAN number of that person. Example: \"AAAAA1111A\".
Aadhaar	A combination of 4 details: 'last 4 digits of AADHAAR', 'Name as on AADHAAR', 'Date of birth as on AADHAAR in dd-mm-yyyy format' and Gender: Male 'M', Female 'F' or Other 'T'). Example: \"XXXX
Passport	A valid Passport number of the customer.
Voter ID	A valid Voter ID number of the customer.
Driving License	A valid Driving Licence number of the customer.
CKYC ID	A valid 14 digit CKYC number of the customer.

Prerequisites

Financial institutions should whitelist IDcentral static IP in CKYC portal to allow IDcentral to access CERSAI repository on behalf of FI.
Financial institutions should share the privateKey shared with CERSAI and the fiCode with IDcentral.
- (Please Note - FI Code will be different for Live and Testbed Portal.)
\n

\n","_postman_id":"ad12e8e3-1c89-455b-8922-b8852a1e9116"},{"name":"DigiLocker","item":[{"name":"createToken","id":"af1f6d69-0ff1-4a5b-8b8f-1ac20b00952f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"nameMatchRequired\": false,\r\n \"popup\": true,\r\n \"redirectUrl\": {{redirect_page_url}}, //optional field\r\n \"postbackUrl\": {{postback_page_url}} //optional field\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/token","description":"

CreateToken is a request to start the user journey, with which you can get user consent and then fetch the document from user’s digilocker.

Below are the steps to complete the createToken and associated journey.

STEP-1: Initiate Session: This API creates a session in which DigiLocker journey can be completed with other APIs in the flow. An authorization token will be generated by DigiLocker. This token token will be valid for 10 min. In API response client will receive authrorization URL from DigiLocker
STEP-2: Share URL with User: Client needs to share the received authorization URL with end user
STEP-3: User Consent: if client has set up 'popup: true' in CreateToken request then client can open the DigiLocker UI screen in his platfrom (Mobile/Website) and if 'popup: false' then user will be redirected to DigiLocker UI screen on default broswer set browser.
- User needs Enter either your mobile number or Aadhaar Number linked with your DigiLocker on the screen.
- Enter your password and PIN for DigiLocker.
- DigiLocker will send an OTP on registered mobile mobile number gievn aadhaar number.
- Enter the OTP on the UI to login successfully.
- Accept the terms and give consent to IDcentral to access your documents from DigiLocker.
- After giving consent, a DigiLocker generated token can be used to access the remaining APIs
\n

Note: User consent authorization journey is must to access the remaining APIs.

Definitions:

token: It is an unqiely generated id by DigiLocker when session is initiated. This token is unique to the session and can be used to validate the end user by completing jounrey on DigiLocker UI. The access token that can be used to call the DigiLocker APIs. This token is valid for 10 min.
\n
popup: Popup is a functionality when A window that suddenly appears (pops up) when you select an option with a mouse or press a special function key. If a client has set up 'popup: true' in CreateToken API request then client can open the DigiLocker UI screen in his platfrom (Mobile/Website) and if 'popup: false' then user will be redirected to DigiLocker UI Screenin browser.
\n
URL: This is a uniquely generated user authorization link by DigiLocker. This URL will be used by user to complete the consent journey where user authorises IDC to access the documents from DigiLocker.
\n
nameMatchRequired: This key param confirms whether name match in the API response as a key value to to be shown or not. If \"nameMatchRequired\": false then name match with the name from digiLocker and user endter name will not occur and if \"nameMatchRequired\": true then nameMatch key value field will be added in the API response.
\n
redirectUrl: The web address to which user is to be automatically forwarded after the completion of web flow. Commonly used for tracking and maintenance pages.
\n
postbackUrl: The web address provided by the service or platform to which data is sent via HTTP POST request, typically used in online transactions or form submissions for processing and response handling.
\n

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	nameMatchRequired	Boolean	Optional	Refer: nameMatchRequired definition
2	popup	Boolean	Required	Refer: popup definition
3	redirectUrl	String	Optional	Refer: redirectUrl definition
4	postbackUrl	String	Optional	Refer: postbackUrl definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information received from DigiLocker
1.1	token	String	ReferL token definition
1.2	url	String	Refer: URL definition
1.3	expireTimeStamp	Integer	Token Expiry Time Stamp in miliseconds. It is 10 min from the token generation time
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
7	message	String	A text content explains if API request was successful or not.
8	timestamp	Integer	API response receive time in milliseconds
9	error	String	A text content explains a reason if API request failed
10	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When token is successfully generated	200	1	success	Successful Request
When DigiLocker access is given to the API key	401	71	failed	Please Contact Administrator for Access	No Access
All other mismatch error	200	9

","urlObject":{"path":["digi","token"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7edcf3b3-3736-4700-a0a8-ecea052f4461","name":"Token Created Successfully","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"nameMatchRequired\": false,\r\n \"popup\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:41:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"9035ba60-eaba-4165-aed9-6a49499c1585\",\n \"url\": \"https://api.idcentral.io/web/digilocker/#/getDocument/9035ba60-eaba-4165-aed9-6a49499c1585\",\n \"expireTimeStamp\": 1669272717374\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"statusCode\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1669272117374,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"digilocker_get_document_ksvEJkWyvCeZWJdl67UP\"\n}"},{"id":"446e6c92-53ec-456c-8398-04b3617ff9ea","name":"No access","originalRequest":{"method":"POST","header":[{"key":"api-key","value":""},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"nameMatchRequired\": false,\r\n \"popup\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/token"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 26 Nov 2022 19:21:53 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 401,\n \"statusCode\": 401,\n \"response_code\": 71,\n \"message_code\": null,\n \"message\": \"Please Contact Administrator for Access\",\n \"timestamp\": 1669490513884,\n \"error\": \"No Access\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_5cHOjQ72D2nfDxnHiBVu\"\n}"},{"id":"ba992041-6ea2-446d-bfab-05fd606b018d","name":"createToken","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"94fb7e5173513391f50e1b1be4a4f0c4"},{"key":"isNameMatchRequiered","value":"false","disabled":true},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"nameMatchRequired\": false,\r\n \"popup\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/token"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 30 Mar 2023 11:05:37 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"8d3d97d4-35df-49b9-9b7d-e0eacc3d8831\",\n \"url\": \"https://api.idcentral.io/web/digilocker/#/getDocument/8d3d97d4-35df-49b9-9b7d-e0eacc3d8831\",\n \"expireTimeStamp\": 1680174937140\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"statusCode\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1680174337140,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"digilocker_get_document_Y86dJHHs22frBN0Gq4zm\"\n}"}],"_postman_id":"af1f6d69-0ff1-4a5b-8b8f-1ac20b00952f"},{"name":"getDocument","id":"27a32dad-6f9a-4e1c-b7cc-d42c7966ec49","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) token

\n","key":"token","value":"30a0fe10-d5a3-4572-b4c0-9e733b48cec2"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{api-key}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data","description":"

getDocument API fetches a list of government-issued documents for the user, given their access token. Includes all relevant details for each document in the list, including the unique document URI, document type and the issuing authority.

Definition

encryptionKey: An encryption key is a random string of bits created explicitly for scrambling and unscrambling data. Encryption keys are designed with algorithms intended to ensure that every key is unpredictable and unique. In DigiLocker flow, when user has given consent and using the unique token, client can initiate the getDocument API. In response, there will be encryption key which will be used to download the document along with keyName value.
keyName: it is a uniquey generated ID by DigiLocker for each DocType. It is generated when user authorised IDC to access the DigiLocker document. It is unique to all the available documents in user's Digilocker. The keyName value isused in downloadfile API along with encryptionKey if client wishes to download any specific document.
token: It is an unqiely generated id by DigiLocker when session is initiated. This token is unique to the session and can be used to validate the end user by completing jounrey on DigiLocker UI. The access token that can be used to call the DigiLocker APIs. This token is valid for 10 min.

Request: In Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	token	String	Required	Refer: Token definition

Response:

S. No	Key	Data Type	Description
1	data	Object	Information received from DigiLocker
1.1	token	String	Refer: token definition
1.2	encryptionKey	String	Refer: encryptionKey definition
1.3	timestamp	Integer	API response receive time in milliseconds
1.4	docTypes	List of String	Refer: DocType definition
1.5	response	List of Objects	The documents list received from Digilocker
1.6	s3Detail	Object	The document file S3 bucket name and key details to retrieve the document in PDF format
1.7	raw_xml	String	S3 URL link to get raw xml file
1.8	pdf_data	String	S3 URL link to get pdf file
1.9	docType	String	Refer: DocType definition
1.10	data	Integer	Detailed information about the Document
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
7	message	String	A text content explains if API request was successful or not.
8	timestamp	Integer	API response receive time in milliseconds
9	error	String	A text content explains a reason if API request failed
10	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
11	txn_id	string	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When documents details are successfully fetched using valid token Id	200	1	success	Successful Request
When generated token has expired	400	-1	failed	The Request Token expired, please try with the new token.	Token Expired
Invalid Token Id is given	400	-1	failed	Invalid Token, Please provide the valid Token ID	Invalid Token
User has not completed the Digilocker web flow	400	-1	failed	Authentication required, Please go through Digilocker Web flow to get the digilocker access.	Please go through Digilocker UI flow first
All other mismatch error	200	9

","urlObject":{"path":["digi","data"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"5cbef91b-4257-4798-86cb-aad57f689d37","name":"Fetched Documents Successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499c1585"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:46:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"9035ba60-eaba-4165-aed9-6a49499XX\",\n \"encryptionKey\": \"6N+d/OgUa2l1Tgl2nP8m3RqF8gNuM6XKf39zbVBsuW0=\",\n \"timestamp\": 1669272344336,\n \"docTypes\": [\n \"ADHAR\",\n \"SSCER\",\n \"VACER\",\n \"DRVLC\",\n \"TWIPC\",\n \"LPGSV\",\n \"PANCR\",\n \"RVCER\"\n ],\n \"response\": [\n {\n \"s3Detail\": null,\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"ADHAR\",\n \"data\": {\n \"CertificateData\": {\n \"KycRes\": {\n \"code\": \"6242e65b6346479ab814f3b3c1763e7f\",\n \"ret\": \"Y\",\n \"ts\": \"2022-11-24T12:15:22.378+05:30\",\n \"ttl\": \"2023-11-24T12:15:22\",\n \"txn\": \"UKC:1eeb861e520b4000799c5fcf9578887420221124121459\",\n \"Rar\": \"PjVIaHRSRHBueWNDaHNoK0xJT0psVGp6Q3NnPT08L1NpZ25hdHVyZVZhbHVlPjwvU2lnbmF0dXJlPjwvQXV0aFJlcz4=\",\n \"UidData\": {\n \"tkn\": \"0100227494JWdXLK0YP6vQUY1Q+D0HfLWUWEAfunsTANw3wLG6ILW11q4ZPK3QSgwNv5aJJk\",\n \"uid\": \"xxxxxxxx4341\",\n \"Poi\": {\n \"dob\": \"18-12-XXXX\",\n \"gender\": \"M\",\n \"name\": \"XXXXX XXXXXXXXXX XXXXXXXXXX\"\n },\n \"Poa\": {\n \"country\": \"India\",\n \"dist\": \"XXXX\",\n \"loc\": \"Asade,XXX\",\n \"pc\": \"XXXXXX\",\n \"state\": \"XXXXX\",\n \"vtc\": \"XXXX\"\n },\n \"LData\": {\n \"country\": \" \",\n \"dist\": \"XX\",\n \"lang\": \"XX\",\n \"loc\": \"आसदे,भादस\",\n \"name\": \"XXXXX XXXXXXX XXXXXX\",\n \"pc\": \"XXXXXXXX\",\n \"state\": \"XXXX\",\n \"vtc\": \"असडे\"\n },\n \"Pht\": \"/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQk+tFFOxBI3SnI3bNFFQUiQk4qvcnClcZypoopolmdK62sGc8tgYxknOf04/UVLbjMeR7g0UVotiG9SeUfORTSOBRRSGWbb734VK3Y0UVL3GhpPHSkzgGiipKRVHLt9KMh0wT0ooqkS9z//Z\"\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/TR/2001/REC-xml-c14n-\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsiha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/0ldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/xmlenc#sha256\"\n },\n \"DigestValue\": \"JXsi/mZCWMwc0xQsqD9UDxucL7xphvVbNXPebMI=\"\n }\n },\n \"SignatureValue\": \"Eda0PKq0hcL8vfNygYh1smPTX/6eFFQafhT+/IVlFxdEqMyfGQbihs+ZI6/6oixEvIhGtlkSQdgvp+jg82P+hpLorVX3p3xljBr0DjcJIW8rDhY1snCvpbt78W4pajRDgRxDibmQv1JhoOmGkyKp78jlszvsHJZAoAhg2+HxaLOJ/dNck9QRgVeaKNse7R0r\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS UIDAI 01,2.5.4.5=#13406231396138376661653761653965663535666631363662356363363235373030653238643832646137366264353366303932,OU=Technology Centre,O=UIDAI,C=IN\",\n \"X509Certificate\": \"MIIG7jCCBdagAwIBAgIEAv5vUzANBgkqhkiG9w0BAQsFADCB4jELMAkGA1UEBhMCSU4xLTArBgNVBAoTJENhcHJpY29ybiBJZGVudGl0eSBTZXJ2aWNlcyBQdnQgTHRkLjEdMBsGA1UECxMUQ2VydGlmeWluZyBBdXRob3JpdHkxDzANBgNVBBETBjEcmUxOzA5BgNVBDMTMlVJREFJIFRlY2ggQ2VudHJlLCBBYWRoYXIgQ29\"\n }\n }\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"886e7fb-a2af-8f28a62f0a38\",\n \"s3Url\": \"s3://idc-digilocker-data/886e7fb1-e05-8f28a62f0a38\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"SSCER\",\n \"data\": {\n \"issueDate\": \"\",\n \"issuedAt\": \"\",\n \"language\": \"99\",\n \"name\": \"Secondary School Certificate Examination- Statement of Marks\",\n \"number\": \"\",\n \"status\": \"A\",\n \"type\": \"SSCER\",\n \"validFromDate\": \"\",\n \"IssuedBy\": {\n \"Organization\": {\n \"code\": \"\",\n \"name\": \"XXXXXXX of Secondary and Higher Secondary Education\",\n \"tin\": \"\",\n \"type\": \"SG\",\n \"uid\": \"\",\n \"Address\": {\n \"country\": \"IN\",\n \"district\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"line1\": \"XXXX\",\n \"line2\": \"\",\n \"locality\": \"\",\n \"pin\": \"\",\n \"state\": \"XXXXXXXXX\",\n \"type\": \"\",\n \"vtc\": \"XXXXXX\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"category\": \"\",\n \"disabilityStatus\": \"\",\n \"dob\": \"\",\n \"email\": \"\",\n \"gender\": \"\",\n \"maritalStatus\": \"\",\n \"motherName\": \"XXXXX\",\n \"name\": \"XXXXXXX XXXXXXXXXXX XXXXXXXXXX\",\n \"phone\": \"\",\n \"religion\": \"\",\n \"swd\": \"\",\n \"swdIndicator\": \" \",\n \"title\": \"\",\n \"uid\": \"\",\n \"Address\": {\n \"country\": \"IN\",\n \"district\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"locality\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"type\": \"\",\n \"vtc\": \"\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"School\": {\n \"code\": \"11.10.026\",\n \"name\": \"\"\n },\n \"Examination\": {\n \"month\": \"XXXX\",\n \"name\": \"SECONDARY SCHOOL CERTIFICATE EXAMINATION\",\n \"year\": \"XXXX\"\n },\n \"Performance\": {\n \"cgpa\": \"\",\n \"cgpaMax\": \"\",\n \"grade\": \"XXXXXXXXX\",\n \"marksMax\": \"XXX\",\n \"marksTotal\": \"XXX\",\n \"percentage\": \" XX.38\",\n \"result\": \"PASS\",\n \"resultDate\": \"\",\n \"updateDate\": \"\",\n \"Subjects\": {\n \"Subject\": {\n \"code\": \"38\",\n \"gp\": \"\",\n \"gpMax\": \"\",\n \"grade\": \"A\",\n \"marksMax\": \"\",\n \"marksMaxPractical\": \"\",\n \"marksMaxTheory\": \"\",\n \"marksPractical\": \"\",\n \"marksTheory\": \"\",\n \"marksTotal\": \"\",\n \"name\": \"ENVIRONMENT EDUCATION\"\n }\n }\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/TR/2001/REC-xml-c14n-20010315#WithC\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/x#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2dsig#sha1\"\n },\n \"DigestValue\": \"p/a0N+7V32we8gJSFTSxs=\"\n }\n },\n \"SignatureValue\": \"O4OS31WWNO979FPcIFhkxLBepqNZXhKJJvRpqngrHfARqL7wL0NPHFof/jXxcj194P7TNz\\nkkv4Nz9qhq3DkBzp1ZJo4qwIuN0h8wfVFl4yaPDkbmkWAkPH+diM40Pudn0xoL8DjPjS6pBnTsdZ\\nCxhELkHVjOsNNtgtHQw3BPt7c58ILTCmC0EgKMOFrK\\nt4zx4fyOj0+F7+iK9IAobPXOK/ycTSVLXVnxbA==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"D OF SEC. AND H.SEC EDUCATION PUNE,C=IN\",\n \"X509Certificate\": \"MIIFfDCCBJJ8ikRBfwslrSBTvfoVXLC+MnzKBorRyQnjTLjR85ew==\"\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"57c381b7-40fb-4da0-b0ca-d880434aa3b0\",\n \"s3Url\": \"s3://idc-digilocker-data/57c381b7-40fb-4da0-b0ca-d880434aa3b0\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"VACER\",\n \"data\": {\n \"id\": \"58248647676\",\n \"\": \"{\\\"@context\\\":[\\\"https://www.w3.org/2018/credentials/v1\\\",\\\"https://cowin.gov.in/yXt-T7haCUA\\\"}}\"\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"be7d58cb-65eb-4502-8f9c-a67fc0ed0571\",\n \"s3Url\": \"s3://icb-65eb-4502-8f9c-a67fc0ed0571\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"DRVLC\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"Driving License\",\n \"type\": \"DRVLC\",\n \"number\": \"XX12 XXXXXXXX20\",\n \"issuedAt\": \"RTO,XXXX\",\n \"issueDate\": \"21-08-2XXX\",\n \"expiryDate\": \"20-08-2XXX\",\n \"validFromDate\": \"\",\n \"status\": \"Active\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Ministry of Road Transport and Highways\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"\",\n \"title\": \"\",\n \"name\": \"XXXXXXX XXXXXXXXXXX\",\n \"dob\": \"18-12-XXXXX\",\n \"swd\": \"XXXXXX\",\n \"swdIndicator\": \"\",\n \"gender\": \"\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"present\",\n \"line1\": \"A/P XXXXXXXXX\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Address2\": {\n \"type\": \"permanent\",\n \"line1\": \"XXXXXXXX XXXXXXX XXXXXX\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"JPEG\",\n \"\": \"//2Q==\"\n }\n }\n },\n \"CertificateData\": {\n \"DrivingLicense\": {\n \"Categories\": {\n \"Category\": {\n \"code\": \"NT\",\n \"abbreviation\": \"LMV\",\n \"description\": \"LIGHT MOTOR VEHICLE\",\n \"issueDate\": \"\",\n \"endorseDate\": \"\"\n }\n }\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.or1/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/0sa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org0/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.001/04/xmlenc#sha256\"\n },\n \"DigestValue\": \"jpFXZxnTIsWtoQgaHXbYDqbn0E=\"\n }\n },\n \"SignatureValue\": \"5sQ==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS =\"\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"4cb08d7d-2e66-446b-b7ea-c20feabe62c1\",\n \"s3Url\": \"s3://idc-digilocker-data/4cb0-c20feabe62c1\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"TWIPC\",\n \"data\": null\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"cfa8bfd1-a159-4b80-bc8372\",\n \"s3Url\": \"s3://idc-digilo159-4b80-b8c8-5796e45c8372\"\n },\n \"docType\": \"LPGSV\",\n \"data\": null\n },\n \n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"44c87dc7-4f23-457b-99c2-713913f66715\",\n \"s3Url\": \"s3://idc-digilocker-data/44c-457b-99c2-713913f66715\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"PANCR\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"PAN Card\",\n \"type\": \"PANCR\",\n \"number\": \"XXXXXXX\",\n \"issuedAt\": \"\",\n \"issueDate\": \"\",\n \"validFromDate\": \"\",\n \"status\": \"A\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Income Tax Department\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"1eeb861e520b4000799c5fcf95788874\",\n \"title\": \"\",\n \"name\": \"XXXXXXXXX XXXXXXXXX BHARAM\",\n \"dob\": \"18-12-1992\",\n \"swd\": \"\",\n \"swdIndicator\": \"\",\n \"gender\": \"MALE\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"permanent\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"PAN\": {\n \"verifiedOn\": \"24-11-2022 12:16:14\"\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/04/xmlenc#sha256\"\n },\n \"DigestValue\": \"RQzkI0DNyDV/emtEvEI0/+ngHz20+rqoJNPgAcwvrzs=\"\n }\n },\n \"SignatureValue\": \"qy40i3HfQ8m5+QcJm+P9PUuScp7X6I4aNe2JNcCPvlYD155kXnkVKgX5GhAVY9VgPxteRIQ==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS Nb11fdb41868b343a6f0469581bdb9fd2a2e4cb59e7797a43,houseIdentifier=6 CGO COMPLEX\",\n \"X509Certificate\": \"MIHA7qhlCpPnW5anWuyPlHKVtBynFxIOVpu39vJgh+Lavmec0LOWowkd2QGyjvGDozAnOKmNPM0e2VCP4Nnllh9YzcZ+DjKcyc+xsRf2mqPImAC6rzm7Rd2Btq4fb9+xgNQ==\"\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"6d71c2-bab9-487bd8f2e5e6\",\n \"s3Url\": \"s3://idc-digilocker-data/6d784f827bd8f2e5e6\"\n },\n \"raw_xml\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscerde0e0057-1474-4f25-810c\",\n \"pdf_data\": \"https://idc-digilocker-data.s3.ap-south-1.amazonaws.com/sscer5712f0b4-99d4-4347-aaf6-8c9a02a699ab.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230926T080331Z&X-Amz-SignedHeaders=host&X-A\",\n \"docType\": \"RVCER\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"Registration of Vehicles\",\n \"type\": \"RVCER\",\n \"number\": \"XXXXXXXX\",\n \"issuedAt\": \"XXXXX, XXXXXXX\",\n \"issueDate\": \"19-06-2013\",\n \"validFromDate\": \"\",\n \"status\": \"A\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Ministry of Road Transport and Highways\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"\",\n \"title\": \"\",\n \"name\": \"XXXXXXX SSSSSSSSSS\",\n \"dob\": \"\",\n \"swd\": \"XXXXXXXXXX\",\n \"swdIndicator\": \"\",\n \"gender\": \"\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"permanent\",\n \"line1\": \"XXXXXXXXXXXX XXXXXXXXXXX XXXXXXXX\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"VehicleRegistration\": {\n \"statusDate\": \"24-11-XXXX\",\n \"financer\": \"\",\n \"normsDesc\": \"Not Available\",\n \"ownerSerialNo\": \"1\",\n \"taxUpto\": \"\",\n \"BlacklistStatus\": \"\",\n \"nocDetails\": \"\",\n \"Insurance\": {\n \"policyNo\": \"XXXXXXXX\",\n \"validTill\": \"21-09-2023\",\n \"companyName\": \"Kotak Mahindra General Insurance\"\n },\n \"PUCCertificate\": {\n \"certificateNo\": \"\",\n \"validTill\": \"\"\n },\n \"Vehicle\": {\n \"engineNo\": \"XXXXXXXXXXXXXXXX\",\n \"chasisNo\": \"XXXXXXXXXXXXXX\",\n \"make\": \"XXXXXXX XXXXXXR INDIA (P) LTD\",\n \"model\": \"XXXXX XXXXXX XXX\",\n \"mfgDate\": \"6/XXXX\",\n \"class\": \"M-Cycle/XXXXXX(2WN)\",\n \"category\": \"XXX\",\n \"bodyType\": \"SOLO\",\n \"color\": \"GREY\",\n \"seatCapacity\": \"2\",\n \"standingCapacity\": \"\",\n \"sleeperCapacity\": \"\",\n \"fuelDesc\": \"PETROL\",\n \"cylinder\": \"1\",\n \"cubicCapacity\": \"109.00\",\n \"grossWeight\": \"\",\n \"unladenWeight\": \"111\",\n \"wheelbase\": \"\",\n \"fitTill\": \"18-06-2028\"\n }\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/04/sha256\"\n },\n \"DigestValue\": \"g1ku1NekqJamyhtUb+mUQMwogY=\"\n }\n },\n \"SignatureValue\": \"fc1ZrBQS2aEq+cKd2NIB2NVmshJ1AfPQ==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS NATIONAL E-GOVERNANCE DIVISION,serialNumber=0f30cbN\",\n \"X509Certificate\": \"MIIGUTCCBTmgAwI2VCP4Nnllh9YzcZ+DjKcyc+xsRf2mqPImAC6rzm7Rd2Btq4fb9+xgNQ==\"\n }\n }\n }\n }\n }\n ],\n \"namMatchResponse\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"statusCode\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1669272344336,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"digilocker_get_document_JvQ98iS7injsu3JWyPdC\"\n}"},{"id":"68255103-66a9-43d0-b7f6-28a7337dccea","name":"Missing user content","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499c1585"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:46:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 401,\n \"statusCode\": 401,\n \"response_code\": 71,\n \"message_code\": null,\n \"message\": null,\n \"timestamp\": 1701942279927,\n \"error\": \"User consent is missing for the issued document.\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_1QD6jcBZWHmD6ENnrtYa\"\n}"},{"id":"568a1923-f2e9-4a08-950d-fefc19297316","name":"Token Expired","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499c1585"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 26 Nov 2022 19:24:54 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"The Request Token expired, please try with the new token.\",\n \"timestamp\": 1669490694334,\n \"error\": \"Token Expired\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_as5Mf7p0aw9I7CHt3I1P\"\n}"},{"id":"1917dcf8-2e11-46db-8c26-f1122f5ed661","name":"Invalid Token ID is given","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 26 Nov 2022 19:25:37 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Invalid Token, Please provide the valid Token ID\",\n \"timestamp\": 1669490737730,\n \"error\": \"Invalid Token\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_Rm0ocAMkMBRvbv27TQDR\"\n}"},{"id":"8e2a0b67-11bf-4296-b089-236845412fd6","name":"Incomplete Web Flow","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"8d2e2a41-c143-4c1f-8418-abc7e0bcfbae"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sat, 26 Nov 2022 19:26:43 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Authentication required, Please go through Digilocker Web flow to get the digilocker access.\",\n \"timestamp\": 1669490803943,\n \"error\": \"Please go through Digilocker UI flow first\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_o8eLyUKbpowatkJNom4P\"\n}"},{"id":"d54f434f-a080-4bba-a9b9-15ae5b29337c","name":"getDocument - XML","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"8d3d97d4-35df-49b9-9b7d-e0eacc3d8831"},{"key":"Accept","value":"application/xml","type":"text"},{"key":"api-key","value":"94fb7e5173513391f50e1b1be4a4f0c4","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"OK","code":200,"_postman_previewlanguage":"xml","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/xml"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 30 Mar 2023 11:09:05 GMT"}],"cookie":[],"responseTime":null,"body":"\n \n 8d3d97d4-35df-49b9-9b7d-e0eacc3d8831\n B2WHSuuu1U1U4ki/ZhMQ68BvtFDVVlwF0hUagC7/N9s=\n 1680174536734\n \n ADHAR\n SSCER\n HSCER\n DRVLC\n PANCR\n \n \n \n \n ADHAR\n \n \n \n ec30b6f288784aa7ada1ca0147c9368f\n Y\n 2023-03-30T16:39:42.630+05:30\n 2024-03-29T16:39:42\n UKC:2b24a21590799458f75c8c91fc72095020230330163919\n \n 01002274drVhn4Xg8eBpjkTicYye9ZfHZokr8/zacxXZQSkmuNPcnAx7VUPNvOqyaRELnAY8\n xxxxxxxx9065\n \n 02-01-1996\n F\n Upasana Gupta\n \n \n D/O Dharmendra Gupta\n India\n Kota\n B-48\n Deoli Arab Road\n Borkhera\n 324001\n Rajasthan\n Pratap Nagar Special\n Kota\n \n \n D/O धर्मेन्द्र गुप्ता\n \n कोटा\n बी-48\n 06\n देवली अरब मार्ग\n बोरखेड़ा\n उपासना गुप्ता\n 324001\n राजस्थान\n प्रताप नगर स्पेशल\n कोटा\n \n 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\n \n \n \n \n \n \n http://www.w3.org/2001/10/xml-exc-c14n#\n \n \n http://www.w3.org/2000/09/xmldsig#rsa-sha1\n \n \n \n \n \n http://www.w3.org/2000/09/xmldsig#enveloped-signature\n \n \n \n http://www.w3.org/2001/04/xmlenc#sha256\n \n Fc68LBENMoTXdtI+6bI15dA/JHS51n8gycI+XwhAseo=\n \n \n WUfHexLCH/8+XDVcy+jfiYKFuwdIZxm6KvbPx89GbHKcg6gT/fo2kkigaIkzhLjeVqmwuFxIGTRacIRL4jXx6dER4DvBne3lJvgDKa5kj+qDqqUGCkOtisCJTkDVJCWEIrSwMC//7UYEAzAcz1JemUOp7kvag6rRGhe5p5EJHByDGxUtM2SXTo95x4en1/2jgA5mlE5L7OtVIDIQ8FoOGL4O0oqvz6ZlSsyYzFQTw2EzE0CAbI8SSYLL+HigClqO7In0iLSXpbgCz2a6w5roI24BdfEQMBktg3NbdY3cbTtykXoo0kWZ/anpK5PC5aHis5d76NC2BwBOTbvIdYP6RQ==\n \n \n CN=SafeScrypt sub-CA for RCAI Class 2 2014,OU=Sub-CA,O=Sify Technologies Limited,C=IN\n MIIFNzCCBB+gAwIBAgIFGeOxJAEwDQYJKoZIhvcNAQELBQAwgekxCzAJBgNVBAYTAklOMSIwIAYDVQQKExlTaWZ5IFRlY2hub2xvZ2llcyBMaW1pdGVkMR0wGwYDVQQLExRDZXJ0aWZ5aW5nIEF1dGhvcml0eTEQMA4GA1UEERMHNjAwIDExMzETMBEGA1UECBMKVGFtaWwgTmFkdTE0MDIGA1UECRMrTm8uNCwgUmFqaXYgR2FuZGhpIFNhbGFpLCBUYXJhbWFuaSwgQ2hlbm5haTEdMBsGA1UEMxMUSUkgRmxvb3IsIFRpZGVsIFBhcmsxGzAZBgNVBAMTElNhZmVTY3J5cHQgQ0EgMjAxNDAeFw0xNDAzMDYwNDMwMDBaFw0yNDAzMDUwNDMwMDBaMHQxCzAJBgNVBAYTAklOMSIwIAYDVQQKExlTaWZ5IFRlY2hub2xvZ2llcyBMaW1pdGVkMQ8wDQYDVQQLEwZTdWItQ0ExMDAuBgNVBAMTJ1NhZmVTY3J5cHQgc3ViLUNBIGZvciBSQ0FJIENsYXNzIDIgMjAxNDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMdLWmI2QwuMUaDmmA9sA31KCi+x3jTbmvx6+dPrqjeaN2/41l6XExq6i9g5AjK4XSwQM6pmtpi3VgUDQYud/v9my5BNasTc3GGVKfsMMCMZaSxa9JFs6BCIztjOP6Q+nKamNqiIleGCH1EFt5dlRooks0XCtTvYmzaLu72pY9/7w8yopPDDFRcAkiRP/+jEiMF3XrT+ksMkwAa2izFaWFQskxApPVZbJV007GL861c4vNeIIWMpaUPeJAWaRkC0RvuSdW19/dM3wA4pp45fwunlYao10hQwEgvN9rvT44rFmT5UYsSfEOfOSinWiemObzOdQ+h8UtcbhCcHOlsoUp8CAwEAAaOCAVgwggFUMBIGA1UdEwEB/wQIMAYBAf8CAQAwDgYDVR0PAQH/BAQDAgEGMBMGA1UdIwQMMAqACEw+jj2YAqV+MBEGA1UdDgQKBAhDDjdX6SfZCDArBgNVHREEJDAipCAwHjEcMBoGA1UEAxMTU0FGRVNDUllQVE9OTElORV8xNTA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3JsLnNhZmVzY3J5cHQuY29tL1NhZmVTY3J5cHRDQTIwMTQuY3JsMIGDBggrBgEFBQcBAQR3MHUwSwYIKwYBBQUHMAKGP2h0dHBzOi8vd3d3LnNhZmVzY3J5cHQuY29tL2RydXBhbC9kb3dubG9hZC9TYWZlU2NyeXB0Q0EyMDE0LmNlcjAmBggrBgEFBQcwAYYaaHR0cDovL29jc3Auc2FmZXNjcnlwdC5jb20wEgYDVR0gBAswCTAHBgVggmRkAjANBgkqhkiG9w0BAQsFAAOCAQEAj0h3yH3B0yBhS3Ye8CS1ZdPlpTUFuyX3Fx7EEoM1TB8R1IznKBrlKCxRs9kZ2XX23Td0plriJgnATTEfAxZou4KwIs0cAtWSSQpL3AquW4/PzuYTOVCUt9cAPXziqQISVoIqWcJjsg8fIXAffumLDHvZD/0qPq6xhZvFX1hfUv2wA6LSITB9VB4YzV5OyPm+SM1BFkq3HA07YY8rfLtCfDbF6y79HV49bVESK0ZWNZqofMS9mvYM8xgAADpefe4ICh9TetGIOg3XL0vgX13MzLOy4xM/tDkRPkNXuuUZ7n1jUwGkz8LJAOAc59zr2QI/DzAoEaeeBUrlNJZUCZoFAA==\n \n \n \n \n \n \n \n idc-digilocker-data\n ba2cc198-cd2f-4bb7-95de-4e4bd01f5307\n s3://idc-digilocker-data/ba2cc198-cd2f-4bb7-95de-4e4bd01f5307\n \n SSCER\n \n 99\n Class X Marksheet\n SSCER\n 1148023\n \n \n \n A\n \n \n Central Board of Secondary Education\n \n \n \n CG\n

\n \n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n UPASANA GUPTA\n 02-01-1996\n DHARMENDRA GUPTA\n \n MENKA GUPTA\n \n \n \n \n \n

\n permanent\n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n \n EMMANUEL MISSION SCHOOL TALWANDI KOTA RAJ\n 03669\n \n A\n \n \n \n \n \n March\n 2012\n \n \n QUAL\n \n \n \n 8\n \n \n 01-01-1970\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n idc-digilocker-data\n 728a4ddc-999c-450f-af30-61329269b80b\n s3://idc-digilocker-data/728a4ddc-999c-450f-af30-61329269b80b\n \n HSCER\n \n 99\n Class XII Marksheet\n HSCER\n 1649107\n \n \n \n A\n \n \n Central Board of Secondary Education\n \n \n \n CG\n

\n \n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n UPASANA GUPTA\n \n DHARMENDRA GUPTA\n \n MENKA GUPTA\n Female\n \n \n \n \n

\n permanent\n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n \n EMMANUEL MISSION SCHOOL TALWANDI KOTA RAJ\n 03669\n \n A\n \n \n \n \n \n MARCH\n 2014\n \n \n PASS\n \n \n \n \n \n \n 01-01-1970\n \n \n INFORMATICS PRAC.\n 065\n 049\n \n 030\n \n 079\n \n \n \n C1\n \n \n \n \n \n \n \n \n idc-digilocker-data\n dcd3af8b-4aef-4d97-8c54-1ad83f6cb340\n s3://idc-digilocker-data/dcd3af8b-4aef-4d97-8c54-1ad83f6cb340\n \n DRVLC\n \n 99\n Driving License\n DRVLC\n RJ20 20210008091\n REGIONAL TRANSPORT OFFICE, KOTA\n 30-08-2021\n 01-01-2036\n \n Active\n \n \n Ministry of Road Transport and Highways\n \n \n \n CG\n

\n \n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n UPASANA GUPTA\n 02-01-1996\n DHARMENDRA GUPTA\n \n \n \n \n \n \n

\n present\n Ladpura,Kota,RJ, 324001\n \n \n \n \n \n \n \n \n IN\n

\n \n permanent\n Ladpura,Kota,RJ, 324001\n \n \n \n \n \n \n \n \n IN\n \n \n JPEG<>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\n \n \n \n \n \n \n \n \n NT\n LMV\n LIGHT MOTOR VEHICLE\n \n \n \n \n \n \n \n \n \n http://www.w3.org/2001/10/xml-exc-c14n#\n \n \n http://www.w3.org/2000/09/xmldsig#rsa-sha1\n \n \n \n \n \n http://www.w3.org/2000/09/xmldsig#enveloped-signature\n \n \n \n http://www.w3.org/2001/04/xmlenc#sha256\n \n wMrc2xNUWrWXTbHRQ//AHyM43LayQe0dXvR31C2Q2UM=\n \n \n k/c19R3Qs1DsZamUCoAJisyiDWL695QnwgMJVDhW5U6BSaihneIqpISasihvmpZO7HMQr4Im+WD7iZ+ygq+Fn7eBXbZqVpj6Csf3yTkUOklOXAyk3SNb9gD139xvr0/VqJ5fct1lM4/is2chLGikVBUoI5KviBzzR1Q03WkAzHqj0qqUVQyU7AJB0lLhJMBGZAwOiRGYqhlZ+VZLq7BaabnKiGXW9yPpx2lrQhuTMuRB1L0InU9mHr05xQEbCOdwFpHbvvJOyzzzlO/O8NZy4XzxxlDP/GbEAOxcY3xe/FGue+D5erDRzSmi5StCbvwbsFTpVf7E9YxK99urwFMCGA==\n \n \n CN=DS NATIONAL E-GOVERNANCE DIVISION,serialNumber=0f30cb67333f634db11fdb41868b343a6f0469581bdb9fd2a2e4cb59e7797a43,houseIdentifier=6 CGO COMPLEX,street=ELECTRONICS NIKETAN,CGO COMPLEX,NEW DELHI,NEW DELHI,ST=Delhi,postalCode=110003,OU=MINISTRY OF ELECTRONICS AND INFORMATION TECHNOLOGY,O=NATIONAL E-GOVERNANCE DIVISION,C=IN\n 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\n \n \n \n \n \n \n \n idc-digilocker-data\n 2e3778dc-5a5b-48f1-ad88-6aeeca10a224\n s3://idc-digilocker-data/2e3778dc-5a5b-48f1-ad88-6aeeca10a224\n \n PANCR\n \n 99\n PAN Card\n PANCR\n CLGPG4650M\n \n \n \n A\n \n \n Income Tax Department\n \n \n \n CG\n

\n \n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n 2b24a21590799458f75c8c91fc720950\n \n UPASANA GUPTA\n 02-01-1996\n \n \n FEMALE\n \n \n \n \n

\n permanent\n \n \n \n \n \n \n \n \n \n IN\n

\n \n \n \n \n \n \n \n 16-03-2023 13:54:45\n \n \n \n \n \n http://www.w3.org/2001/10/xml-exc-c14n#\n \n \n http://www.w3.org/2000/09/xmldsig#rsa-sha1\n \n \n \n \n \n http://www.w3.org/2000/09/xmldsig#enveloped-signature\n \n \n \n http://www.w3.org/2001/04/xmlenc#sha256\n \n 0ihGgTgpUl8cE/AxDD30dML8w0uGqAtaUoxqrp30y18=\n \n \n xTkkoy8SGZiByld9q7NF8viiXnP8AYoOX7iraP9ca7ABPbhbcMkuHvwbHbsPPCVza7IgIAXM6SkuqmWtO9aibSxd9dAiQ/do4eqgHnV3C4U2meFdzC6vSXXMkJtLJ1A4xynUunu9bEpp1hmn2k6VZbqxjXn6TfMbfNLpG6T0bi40s8ikAmROc3Tg0RtS1V7Ty5IsDmhVvf/iEMWy+TkQhboq07dWisWUWkY1mE4t/NcwRtUQFpc3aj8TDHIqAb2Lf/vfm6JZUL8tBUVufGp9mB/1nIuLmryxicDzNy67oDMHMfj2bt4TAa6NaZsAWwjB9WTnfpREzY2C7/1D576TIw==\n \n \n CN=DS NATIONAL E-GOVERNANCE DIVISION,serialNumber=0f30cb67333f634db11fdb41868b343a6f0469581bdb9fd2a2e4cb59e7797a43,houseIdentifier=6 CGO COMPLEX,street=ELECTRONICS NIKETAN,CGO COMPLEX,NEW DELHI,NEW DELHI,ST=Delhi,postalCode=110003,OU=MINISTRY OF ELECTRONICS AND INFORMATION TECHNOLOGY,O=NATIONAL E-GOVERNANCE DIVISION,C=IN\n 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\n \n \n \n \n \n \n \n\nsuccess\n200\n200\n1\n\nSuccessful Request\n1680174536734\n\ntrue\ndigilocker_get_document_kGHnMRxSZRbb183xOZRp\n"},{"id":"d35938d3-534f-4249-a6ff-5d965d8b5110","name":"getDocument -json","originalRequest":{"method":"GET","header":[{"description":"(Required) token","key":"token","value":"8d3d97d4-35df-49b9-9b7d-e0eacc3d8831"},{"key":"Accept","value":"application/json","type":"text"},{"key":"api-key","value":"94fb7e5173513391f50e1b1be4a4f0c4","type":"text"}],"url":"https://api.idcentral.io/idc/digi/data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 30 Mar 2023 11:10:06 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": \"8d3d97d4-35df-49b9-9b7d-e0eacc3d8831\",\n \"encryptionKey\": \"NdDZlHdBJO0Bf35fLI433E7t2L4DvJzpvJdiYdjn82M=\",\n \"timestamp\": 1680174597710,\n \"docTypes\": [\n \"ADHAR\",\n \"SSCER\",\n \"HSCER\",\n \"DRVLC\",\n \"PANCR\"\n ],\n \"response\": [\n {\n \"s3Detail\": null,\n \"docType\": \"ADHAR\",\n \"data\": {\n \"CertificateData\": {\n \"KycRes\": {\n \"code\": \"ec30b6f288784aa7ada1ca0147c9368f\",\n \"ret\": \"Y\",\n \"ts\": \"2023-03-30T16:39:42.630+05:30\",\n \"ttl\": \"2024-03-29T16:39:42\",\n \"txn\": \"UKC:2b24a21590799458f75c8c91fc72095020230330163919\",\n \"UidData\": {\n \"tkn\": \"01002274drVhn4Xg8eBpjkTicYye9ZfHZokr8/zacxXZQSkmuNPcnAx7VUPNvOqyaRELnAY8\",\n \"uid\": \"xxxxxxxx9065\",\n \"Poi\": {\n \"dob\": \"02-01-1996\",\n \"gender\": \"F\",\n \"name\": \"Upasana Gupta\"\n },\n \"Poa\": {\n \"co\": \"D/O Dharmendra Gupta\",\n \"country\": \"India\",\n \"dist\": \"Kota\",\n \"house\": \"B-48\",\n \"lm\": \"Deoli Arab Road\",\n \"loc\": \"Borkhera\",\n \"pc\": \"324001\",\n \"state\": \"Rajasthan\",\n \"street\": \"Pratap Nagar Special\",\n \"vtc\": \"Kota\"\n },\n \"LData\": {\n \"co\": \"D/O धर्मेन्द्र गुप्ता\",\n \"country\": \" \",\n \"dist\": \"कोटा\",\n \"house\": \"बी-48\",\n \"lang\": \"06\",\n \"lm\": \"देवली अरब मार्ग\",\n \"loc\": \"बोरखेड़ा\",\n \"name\": \"उपासना गुप्ता\",\n \"pc\": \"324001\",\n \"state\": \"राजस्थान\",\n \"street\": \"प्रताप नगर स्पेशल\",\n \"vtc\": \"कोटा\"\n },\n \"Pht\": \"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\"\n }\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/04/xmlenc#sha256\"\n },\n \"DigestValue\": \"Fc68LBENMoTXdtI+6bI15dA/JHS51n8gycI+XwhAseo=\"\n }\n },\n \"SignatureValue\": \"WUfHexLCH/8+XDVcy+jfiYKFuwdIZxm6KvbPx89GbHKcg6gT/fo2kkigaIkzhLjeVqmwuFxIGTRacIRL4jXx6dER4DvBne3lJvgDKa5kj+qDqqUGCkOtisCJTkDVJCWEIrSwMC//7UYEAzAcz1JemUOp7kvag6rRGhe5p5EJHByDGxUtM2SXTo95x4en1/2jgA5mlE5L7OtVIDIQ8FoOGL4O0oqvz6ZlSsyYzFQTw2EzE0CAbI8SSYLL+HigClqO7In0iLSXpbgCz2a6w5roI24BdfEQMBktg3NbdY3cbTtykXoo0kWZ/anpK5PC5aHis5d76NC2BwBOTbvIdYP6RQ==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=SafeScrypt sub-CA for RCAI Class 2 2014,OU=Sub-CA,O=Sify Technologies Limited,C=IN\",\n \"X509Certificate\": \"MIIFNzCCBB+gAwIBAgIFGeOxJAEwDQYJKoZIhvcNAQELBQAwgekxCzAJBgNVBAYTAklOMSIwIAYDVQQKExlTaWZ5IFRlY2hub2xvZ2llcyBMaW1pdGVkMR0wGwYDVQQLExRDZXJ0aWZ5aW5nIEF1dGhvcml0eTEQMA4GA1UEERMHNjAwIDExMzETMBEGA1UECBMKVGFtaWwgTmFkdTE0MDIGA1UECRMrTm8uNCwgUmFqaXYgR2FuZGhpIFNhbGFpLCBUYXJhbWFuaSwgQ2hlbm5haTEdMBsGA1UEMxMUSUkgRmxvb3IsIFRpZGVsIFBhcmsxGzAZBgNVBAMTElNhZmVTY3J5cHQgQ0EgMjAxNDAeFw0xNDAzMDYwNDMwMDBaFw0yNDAzMDUwNDMwMDBaMHQxCzAJBgNVBAYTAklOMSIwIAYDVQQKExlTaWZ5IFRlY2hub2xvZ2llcyBMaW1pdGVkMQ8wDQYDVQQLEwZTdWItQ0ExMDAuBgNVBAMTJ1NhZmVTY3J5cHQgc3ViLUNBIGZvciBSQ0FJIENsYXNzIDIgMjAxNDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAMdLWmI2QwuMUaDmmA9sA31KCi+x3jTbmvx6+dPrqjeaN2/41l6XExq6i9g5AjK4XSwQM6pmtpi3VgUDQYud/v9my5BNasTc3GGVKfsMMCMZaSxa9JFs6BCIztjOP6Q+nKamNqiIleGCH1EFt5dlRooks0XCtTvYmzaLu72pY9/7w8yopPDDFRcAkiRP/+jEiMF3XrT+ksMkwAa2izFaWFQskxApPVZbJV007GL861c4vNeIIWMpaUPeJAWaRkC0RvuSdW19/dM3wA4pp45fwunlYao10hQwEgvN9rvT44rFmT5UYsSfEOfOSinWiemObzOdQ+h8UtcbhCcHOlsoUp8CAwEAAaOCAVgwggFUMBIGA1UdEwEB/wQIMAYBAf8CAQAwDgYDVR0PAQH/BAQDAgEGMBMGA1UdIwQMMAqACEw+jj2YAqV+MBEGA1UdDgQKBAhDDjdX6SfZCDArBgNVHREEJDAipCAwHjEcMBoGA1UEAxMTU0FGRVNDUllQVE9OTElORV8xNTA/BgNVHR8EODA2MDSgMqAwhi5odHRwOi8vY3JsLnNhZmVzY3J5cHQuY29tL1NhZmVTY3J5cHRDQTIwMTQuY3JsMIGDBggrBgEFBQcBAQR3MHUwSwYIKwYBBQUHMAKGP2h0dHBzOi8vd3d3LnNhZmVzY3J5cHQuY29tL2RydXBhbC9kb3dubG9hZC9TYWZlU2NyeXB0Q0EyMDE0LmNlcjAmBggrBgEFBQcwAYYaaHR0cDovL29jc3Auc2FmZXNjcnlwdC5jb20wEgYDVR0gBAswCTAHBgVggmRkAjANBgkqhkiG9w0BAQsFAAOCAQEAj0h3yH3B0yBhS3Ye8CS1ZdPlpTUFuyX3Fx7EEoM1TB8R1IznKBrlKCxRs9kZ2XX23Td0plriJgnATTEfAxZou4KwIs0cAtWSSQpL3AquW4/PzuYTOVCUt9cAPXziqQISVoIqWcJjsg8fIXAffumLDHvZD/0qPq6xhZvFX1hfUv2wA6LSITB9VB4YzV5OyPm+SM1BFkq3HA07YY8rfLtCfDbF6y79HV49bVESK0ZWNZqofMS9mvYM8xgAADpefe4ICh9TetGIOg3XL0vgX13MzLOy4xM/tDkRPkNXuuUZ7n1jUwGkz8LJAOAc59zr2QI/DzAoEaeeBUrlNJZUCZoFAA==\"\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"d23e9f3a-669e-4c21-9d88-b4ce67bc4dce\",\n \"s3Url\": \"s3://idc-digilocker-data/d23e9f3a-669e-4c21-9d88-b4ce67bc4dce\"\n },\n \"docType\": \"SSCER\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"Class X Marksheet\",\n \"type\": \"SSCER\",\n \"number\": \"1148023\",\n \"issuedAt\": \"\",\n \"issueDate\": \"\",\n \"validFromDate\": \"\",\n \"status\": \"A\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Central Board of Secondary Education\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"\",\n \"title\": \"\",\n \"name\": \"UPASANA GUPTA\",\n \"dob\": \"02-01-1996\",\n \"swd\": \"DHARMENDRA GUPTA\",\n \"swdIndicator\": \"\",\n \"motherName\": \"MENKA GUPTA\",\n \"gender\": \"\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"permanent\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"School\": {\n \"name\": \"EMMANUEL MISSION SCHOOL TALWANDI KOTA RAJ\",\n \"code\": \"03669\",\n \"regionName\": \"\",\n \"regionCode\": \"A\"\n },\n \"Examination\": {\n \"name\": \"\",\n \"centerCode\": \"\",\n \"admitCardId\": \"\",\n \"month\": \"March\",\n \"year\": \"2012\"\n },\n \"Performance\": {\n \"result\": \"QUAL\",\n \"marksTotal\": \"\",\n \"marksMax\": \"\",\n \"percentage\": \"\",\n \"cgpa\": \"8\",\n \"cgpaMax\": \"\",\n \"resultDate\": \"\",\n \"updateDate\": \"01-01-1970\",\n \"Subjects\": {\n \"Subject\": {\n \"name\": \"\",\n \"code\": \"\",\n \"marksTheory\": \"\",\n \"marksMaxTheory\": \"\",\n \"marksPractical\": \"\",\n \"marksMaxPractical\": \"\",\n \"marksTotal\": \"\",\n \"marksMax\": \"\",\n \"gp\": \"\",\n \"gpMax\": \"\",\n \"grade\": \"\"\n }\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"2e001440-db24-48bf-b13f-4cae325d95d9\",\n \"s3Url\": \"s3://idc-digilocker-data/2e001440-db24-48bf-b13f-4cae325d95d9\"\n },\n \"docType\": \"HSCER\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"Class XII Marksheet\",\n \"type\": \"HSCER\",\n \"number\": \"1649107\",\n \"issuedAt\": \"\",\n \"issueDate\": \"\",\n \"validFromDate\": \"\",\n \"status\": \"A\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Central Board of Secondary Education\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"\",\n \"title\": \"\",\n \"name\": \"UPASANA GUPTA\",\n \"dob\": \"\",\n \"swd\": \"DHARMENDRA GUPTA\",\n \"swdIndicator\": \"\",\n \"motherName\": \"MENKA GUPTA\",\n \"gender\": \"Female\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"permanent\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"School\": {\n \"name\": \"EMMANUEL MISSION SCHOOL TALWANDI KOTA RAJ\",\n \"code\": \"03669\",\n \"regionName\": \"\",\n \"regionCode\": \"A\"\n },\n \"Examination\": {\n \"name\": \"\",\n \"centerCode\": \"\",\n \"admitCardId\": \"\",\n \"month\": \"MARCH\",\n \"year\": \"2014\"\n },\n \"Performance\": {\n \"result\": \"PASS\",\n \"marksTotal\": \"\",\n \"marksMax\": \"\",\n \"percentage\": \"\",\n \"cgpa\": \"\",\n \"cgpaMax\": \"\",\n \"resultDate\": \"\",\n \"updateDate\": \"01-01-1970\",\n \"Subjects\": {\n \"Subject\": {\n \"name\": \"INFORMATICS PRAC.\",\n \"code\": \"065\",\n \"marksTheory\": \"049\",\n \"marksMaxTheory\": \"\",\n \"marksPractical\": \"030\",\n \"marksMaxPractical\": \"\",\n \"marksTotal\": \"079\",\n \"marksMax\": \"\",\n \"gp\": \"\",\n \"gpMax\": \"\",\n \"grade\": \"C1\"\n }\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"8e58c33a-3c6e-43fd-bb80-e5df0ba03e95\",\n \"s3Url\": \"s3://idc-digilocker-data/8e58c33a-3c6e-43fd-bb80-e5df0ba03e95\"\n },\n \"docType\": \"DRVLC\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"Driving License\",\n \"type\": \"DRVLC\",\n \"number\": \"RJ20 20210008091\",\n \"issuedAt\": \"REGIONAL TRANSPORT OFFICE, KOTA\",\n \"issueDate\": \"30-08-2021\",\n \"expiryDate\": \"01-01-2036\",\n \"validFromDate\": \"\",\n \"status\": \"Active\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Ministry of Road Transport and Highways\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"\",\n \"title\": \"\",\n \"name\": \"UPASANA GUPTA\",\n \"dob\": \"02-01-1996\",\n \"swd\": \"DHARMENDRA GUPTA\",\n \"swdIndicator\": \"\",\n \"gender\": \"\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"present\",\n \"line1\": \"Ladpura,Kota,RJ, 324001\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Address2\": {\n \"type\": \"permanent\",\n \"line1\": \"Ladpura,Kota,RJ, 324001\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"JPEG\",\n \"\": \"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\"\n }\n }\n },\n \"CertificateData\": {\n \"DrivingLicense\": {\n \"Categories\": {\n \"Category\": {\n \"code\": \"NT\",\n \"abbreviation\": \"LMV\",\n \"description\": \"LIGHT MOTOR VEHICLE\",\n \"issueDate\": \"\",\n \"endorseDate\": \"\"\n }\n }\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/04/xmlenc#sha256\"\n },\n \"DigestValue\": \"wMrc2xNUWrWXTbHRQ//AHyM43LayQe0dXvR31C2Q2UM=\"\n }\n },\n \"SignatureValue\": \"k/c19R3Qs1DsZamUCoAJisyiDWL695QnwgMJVDhW5U6BSaihneIqpISasihvmpZO7HMQr4Im+WD7iZ+ygq+Fn7eBXbZqVpj6Csf3yTkUOklOXAyk3SNb9gD139xvr0/VqJ5fct1lM4/is2chLGikVBUoI5KviBzzR1Q03WkAzHqj0qqUVQyU7AJB0lLhJMBGZAwOiRGYqhlZ+VZLq7BaabnKiGXW9yPpx2lrQhuTMuRB1L0InU9mHr05xQEbCOdwFpHbvvJOyzzzlO/O8NZy4XzxxlDP/GbEAOxcY3xe/FGue+D5erDRzSmi5StCbvwbsFTpVf7E9YxK99urwFMCGA==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS NATIONAL E-GOVERNANCE DIVISION,serialNumber=0f30cb67333f634db11fdb41868b343a6f0469581bdb9fd2a2e4cb59e7797a43,houseIdentifier=6 CGO COMPLEX,street=ELECTRONICS NIKETAN,CGO COMPLEX,NEW DELHI,NEW DELHI,ST=Delhi,postalCode=110003,OU=MINISTRY OF ELECTRONICS AND INFORMATION TECHNOLOGY,O=NATIONAL E-GOVERNANCE DIVISION,C=IN\",\n \"X509Certificate\": \"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\"\n }\n }\n }\n }\n },\n {\n \"s3Detail\": {\n \"bucketName\": \"idc-digilocker-data\",\n \"keyName\": \"9b85f2d4-eeca-4cd4-bddc-9ec110cf0111\",\n \"s3Url\": \"s3://idc-digilocker-data/9b85f2d4-eeca-4cd4-bddc-9ec110cf0111\"\n },\n \"docType\": \"PANCR\",\n \"data\": {\n \"language\": \"99\",\n \"name\": \"PAN Card\",\n \"type\": \"PANCR\",\n \"number\": \"CLGPG4650M\",\n \"issuedAt\": \"\",\n \"issueDate\": \"\",\n \"validFromDate\": \"\",\n \"status\": \"A\",\n \"IssuedBy\": {\n \"Organization\": {\n \"name\": \"Income Tax Department\",\n \"code\": \"\",\n \"tin\": \"\",\n \"uid\": \"\",\n \"type\": \"CG\",\n \"Address\": {\n \"type\": \"\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n }\n }\n },\n \"IssuedTo\": {\n \"Person\": {\n \"uid\": \"2b24a21590799458f75c8c91fc720950\",\n \"title\": \"\",\n \"name\": \"UPASANA GUPTA\",\n \"dob\": \"02-01-1996\",\n \"swd\": \"\",\n \"swdIndicator\": \"\",\n \"gender\": \"FEMALE\",\n \"maritalStatus\": \"\",\n \"religion\": \"\",\n \"phone\": \"\",\n \"email\": \"\",\n \"Address\": {\n \"type\": \"permanent\",\n \"line1\": \"\",\n \"line2\": \"\",\n \"house\": \"\",\n \"landmark\": \"\",\n \"locality\": \"\",\n \"vtc\": \"\",\n \"district\": \"\",\n \"pin\": \"\",\n \"state\": \"\",\n \"country\": \"IN\"\n },\n \"Photo\": {\n \"format\": \"\"\n }\n }\n },\n \"CertificateData\": {\n \"PAN\": {\n \"verifiedOn\": \"16-03-2023 13:54:45\"\n }\n },\n \"Signature\": {\n \"SignedInfo\": {\n \"CanonicalizationMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/10/xml-exc-c14n#\"\n },\n \"SignatureMethod\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#rsa-sha1\"\n },\n \"Reference\": {\n \"URI\": \"\",\n \"Transforms\": {\n \"Transform\": {\n \"Algorithm\": \"http://www.w3.org/2000/09/xmldsig#enveloped-signature\"\n }\n },\n \"DigestMethod\": {\n \"Algorithm\": \"http://www.w3.org/2001/04/xmlenc#sha256\"\n },\n \"DigestValue\": \"0ihGgTgpUl8cE/AxDD30dML8w0uGqAtaUoxqrp30y18=\"\n }\n },\n \"SignatureValue\": \"xTkkoy8SGZiByld9q7NF8viiXnP8AYoOX7iraP9ca7ABPbhbcMkuHvwbHbsPPCVza7IgIAXM6SkuqmWtO9aibSxd9dAiQ/do4eqgHnV3C4U2meFdzC6vSXXMkJtLJ1A4xynUunu9bEpp1hmn2k6VZbqxjXn6TfMbfNLpG6T0bi40s8ikAmROc3Tg0RtS1V7Ty5IsDmhVvf/iEMWy+TkQhboq07dWisWUWkY1mE4t/NcwRtUQFpc3aj8TDHIqAb2Lf/vfm6JZUL8tBUVufGp9mB/1nIuLmryxicDzNy67oDMHMfj2bt4TAa6NaZsAWwjB9WTnfpREzY2C7/1D576TIw==\",\n \"KeyInfo\": {\n \"X509Data\": {\n \"X509SubjectName\": \"CN=DS NATIONAL E-GOVERNANCE DIVISION,serialNumber=0f30cb67333f634db11fdb41868b343a6f0469581bdb9fd2a2e4cb59e7797a43,houseIdentifier=6 CGO COMPLEX,street=ELECTRONICS NIKETAN,CGO COMPLEX,NEW DELHI,NEW DELHI,ST=Delhi,postalCode=110003,OU=MINISTRY OF ELECTRONICS AND INFORMATION TECHNOLOGY,O=NATIONAL E-GOVERNANCE DIVISION,C=IN\",\n \"X509Certificate\": \"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\"\n }\n }\n }\n }\n }\n ],\n \"namMatchResponse\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"statusCode\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1680174597710,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"digilocker_get_document_w6xiGm9YPa6vAdkqkTWH\"\n}"}],"_postman_id":"27a32dad-6f9a-4e1c-b7cc-d42c7966ec49"},{"name":"downloadFile","id":"2613b54b-421e-4e6c-96b2-30f8be77d697","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) encryptionKey

\n","key":"encryptionKey","value":"BWTC5WOTDfCNs5MgoC6KhMbI8rjq+fwJnZElxzcIjyk="},{"description":"

(Required) keyName

\n","key":"keyName","value":"2671461f-db7f-4bdb-a9b3-354a96c498e6"},{"key":"api-key","value":"{{api-key}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/download","description":"

downloadFile API will get the document that the user has consented to share with you, made available as a file URL to download. All docs other than Aadhaar, can be fetched with this API.

To get the document file, Ciient needs to pass the \"encryptionKey\" & \"keyName\" values. A a requested document will be displayed upon successful

Definition

encryptionKey: An encryption key is a random string of bits created explicitly for scrambling and unscrambling data. Encryption keys are designed with algorithms intended to ensure that every key is unpredictable and unique. In DigiLocker flow, when user has given consent and using the unique token, client can initiate the getDocument API. In response, there will be encryption key which will be used to download the document along with keyName value.
keyName: it is a uniquey generated ID by DigiLocker for each DocType. It is generated when user authorised IDC to access the DigiLocker document. It is unique to all the available documents in user's Digilocker. The keyName value isused in downloadfile API along with encryptionKey if client wishes to download any specific document.

Request: In Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	encryptionKey	String	Required	Refer: encryptionKey definition
2	keyName	String	Required	Refer: keyName definition

Response: For successful request, the given document will be displayed and can be downloaded.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When given doc is downloaded successfully	200	1	success
When Expired invalid keyName is entered	400	-1	failed	Please provide the valid keyName	Invalid keyName
When invalid encryption key is entered	400	-1	failed	Please provide the encryptionKey	Invalid encryptionKey
All other mismatch error	200	9

","urlObject":{"path":["digi","download"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"5dfc1b8a-1f66-48bb-90c6-4f2530cf5570","name":"downloadFile","originalRequest":{"method":"GET","header":[{"description":"(Required) encryptionKey","key":"encryptionKey","value":"G+eFWO/j2+9WQ99/a0uKAmVMhL1EOHn4WlhTfIJYJcM="},{"description":"(Required) keyName","key":"keyName","value":"6a0baaaf-5e4c-4d5b-a088-7e90bdb14b26"}],"url":"https://api.idcentral.io/idc/idc/digi/download"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""},{"id":"37567670-70a4-4ef8-9af0-06e8ef2ca8a5","name":"Incorrect Key Name entered","originalRequest":{"method":"GET","header":[{"description":"(Required) encryptionKey","key":"encryptionKey","value":"BWTC5WOTDfCNs5MgoC6KhMbI8rjq+fwJnZElxzcIjyk="},{"description":"(Required) keyName","key":"keyName","value":"2671461f-db7f-4bdb-a9b3-354a96c498e6"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/download"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 08:12:29 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid keyName\",\n \"timestamp\": 1669536749004,\n \"error\": \"Invalid keyName\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_uvkyLQSHmCf8dQlkwLtp\"\n}"},{"id":"9fae2835-f270-4ef8-864e-38f3f9fd6f8d","name":"Invalid Encrpytion Key entered","originalRequest":{"method":"GET","header":[{"description":"(Required) encryptionKey","key":"encryptionKey","value":"1J30yXPW8Kf6YRlQ0bwLUFwr2wdQjKtYFuRftDIma/sk="},{"description":"(Required) keyName","key":"keyName","value":"841d4213-0017-4c92-9a10-fb00ac310379"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"url":"https://api.idcentral.io/idc/digi/download"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 19:04:39 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the encryptionKey\",\n \"timestamp\": 1669748679478,\n \"error\": \"Invalid encryptionKey\",\n \"success\": false,\n \"txn_id\": \"digilocker_get_document_paG40h0etasXnWOI2U6J\"\n}"}],"_postman_id":"2613b54b-421e-4e6c-96b2-30f8be77d697"},{"name":"addDocument","id":"719c1350-9936-4cc4-acdb-ce98db4faa31","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) docType

\n","key":"docType","value":"IN-PAN"},{"description":"

(Required) token

\n","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499c1585"},{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\n /*\"dlNumber\": \"eu\",*/\n \"panFullName\": \"Full Name\",\n \"panNumber\": \"Number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/data","description":"

If user wishes to update the details on DigiLocker like PAN number, Driving License, addDocument API will be used to make that update. This API's accessible only when the requested token is valid and it's successfully authenticated with users Digilocker account. The updated details date will be shown, next time when user fetch the details from DigiLocker.

Definition

token: It is an unqiely generated id by DigiLocker when session is initiated. This token is unique to the session and can be used to validate the end user by completing jounrey on DigiLocker UI. The access token that can be used to call the DigiLocker APIs. This token is valid for 10 min.

Applicable Documents to Add:

Currently we support only the below mentioned documents to add in digilocker.
Refer the below Table to get the applicable Documents list with Doc ID's.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Name	docType
PAN Card	IN-PAN
Driving License	IN-DL

Request: In Headers

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	token	String	Required	Refer: token definition
2	docType	String	Required	docType details to be added

Request: In Body (raw format)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	Required	Description
dlNumber	String	Mandatory only for adding driving license	Pass the unique driving license number
panFullName	String	Mandatory only for adding Pan Card	Pass the Pan Holder Name as per the Pan Card
panNumber	String	Mandatory only for adding Pan Card	Pass the PAN card unique number as per the Pan Card

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
	data	Object	Information about update docType details
1	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
2	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
3	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
	message	String	A text content explains if API request was successful or not.
	timestamp	Integer	API response receive time in milliseconds
	error	String	A text content explains a reason if API request failed
	success		This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
6	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Note: In Response, when 'status' key value as \"Success\". You can perform the getDocument API to get the updated list of documents in digiLocker. for the updated document, the last updated date will be mentioned)

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Document is added successfully	200	1	success	Successful Request
When incorrect DL details are given	400	-1	failed	Please provide the valid driving license number	Invalid Request
When invalid PAN details are given	400	-1	failed	Please provide us the panNumber when the docType value as IN-PAN	Invalid Request
When invalid Token is provided	400	-1	failed	Invalid Token, Please provide the valid Token ID	Invalid Request
All other mismatch error	200	9

","urlObject":{"path":["digi","data"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7cccb3b6-a66c-46e9-ba1e-0632113aa0a9","name":"PAN Doc Added Successfully","originalRequest":{"method":"POST","header":[{"description":"(Required) docType","key":"docType","value":"IN-PAN"},{"description":"(Required) token","key":"token","value":"9035ba60-eaba-4165-aed9-6a49499c1585"},{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"1db9893a02cca5cb1f5eab2ef8da42e6","type":"text"}],"body":{"mode":"raw","raw":"{\n \"panFullName\": \"{{full_name}}\",\n \"panNumber\": \"{{pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/data"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:51:28 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"statusCode\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1669272688046,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"digilocker_add_document_bGKawBuIa8MgbZYGLnIL\"\n}"},{"id":"8c1a734f-6a1f-402c-b6e5-20e176329df7","name":"Invalid DL details are provided","originalRequest":{"method":"POST","header":[{"description":"(Required) docType","key":"docType","value":"IN-DL"},{"description":"(Required) token","key":"token","value":"65f4f7a9-2f8e-4c1a-b740-ce27de9032bb"},{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"panFullName\": \"XXXXXX D XXXXXX\",\n \"panNumber\": \"AYXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 09:09:23 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid driving license number\",\n \"timestamp\": 1669540164207,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"digilocker_add_document_CwwG9WQB35wb8Km9Qkip\"\n}"},{"id":"4c841f18-f9ea-4ee5-95f1-0dec17527ab0","name":"Invalid PAN details are provided","originalRequest":{"method":"POST","header":[{"description":"(Required) docType","key":"docType","value":"IN-PAN"},{"description":"(Required) token","key":"token","value":"65f4f7a9-2f8e-4c1a-b740-ce27de9032bb"},{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"panFullName\": \"bciueq932yr\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 09:10:39 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide us the panNumber when the docType value as IN-PAN\",\n \"timestamp\": 1669540239765,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"digilocker_add_document_NJrZlyCxSaT6a9g7LCXA\"\n}"},{"id":"c9430719-3b35-40ec-9be9-dfcdbf00371d","name":"Invalid Token ID is provided","originalRequest":{"method":"POST","header":[{"description":"(Required) docType","key":"docType","value":"IN-PAN"},{"description":"(Required) token","key":"token","value":"65f4f7a9-2f8e-4c1a-b740-ce27de9032bbb"},{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"panFullName\": \"XXXXX D XXXXXX\",\n \"panNumber\": \"AYXXXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/digi/data"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 09:12:02 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"statusCode\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Invalid Token, Please provide the valid Token ID\",\n \"timestamp\": 1669540322121,\n \"error\": \"Invalid Token\",\n \"success\": false,\n \"txn_id\": \"digilocker_add_document_xapm9Wcl9qmaE5n5ULYT\"\n}"}],"_postman_id":"719c1350-9936-4cc4-acdb-ce98db4faa31"}],"id":"012eafd9-f6df-451a-bf46-d8e01fd3e4c4","description":"

What is DigiLocker?

DigiLocker is a document wallet provided by the Ministry of Electronics and Information Technology (MeitY), Government of India under its Digital India initiative. DigiLocker provides an account in the cloud to every Aadhaar holder to access authentic documents/certificates such as driving license, vehicle registration, and academic mark sheet in digital format from the original issuers of these certificates as per Rule 9A of the Information Technology Rules, 2016. Documents can also be uploaded by citizens, for storage on DigiLocker. It also provides 1GB of storage space to each account to upload scanned copies of legacy documents.

DigiLocker is a simple and convenient product that can share documents online, accessed anytime, anywhere. Moreover, all the documents can be authenticated by the users, legally on a par with originals, and are accepted by the government of India as a substitute for the original one if required to produce one.

This is widely used in the industry as a genuine substitute to offline verification of one's Aadhaar. These documents are issued directly by the registered issuers such as Income Tax Department, CBSE, Registrar Office, etc.

What are the APIs involved in DigiLocker flow?

Generate Token
Authenticate DigiLocker account
Get Documents
Download File
Add Documents

Here is how to use a IDC - DigiLocker Service to verify client KYC funciton

STEP 1: Generate a Token

First, we need to create the token using \"createToken\" API service.

This API response returns the webpage URL and unique token to access digiLocker account.

STEP 2: Authenticate DigiLocker account

To get the access of user digiLocker account we have to redirect the user to this web-flow authentication process.

Please follow the below steps to implement the web-flow in your platform.

Import the SDK in form of script in the head of the document

< script src=\"https://api.idcentral.io/web/idcdigi/idc-digi.js\" crossorigin=\"anonymous\" >

< head>\n< script src=\"https://api.idcentral.io/web/idcdigi/idc-digi.js\" crossorigin=\"anonymous\">< /script >\n< /head> \n\n

2. Add the below elements in your HTML body.

\n\n

< button type=\"button\" id=\"idc-get-document-btn\" onclick=\"getToken()\" >  \nGet Documents From Digilocker< /button> \n\n

Note: It is mandatory to mention the given ids to the button.

\n\n

3.Add the below script in the head of the document

\n\n

< script> \nfunctiongetToken(){\n  letdata=document.getElementById('token-input').value;\nloadIdcDigi(data);\n}\nasyncfunctiongetData(){\n  letdata=awaitgetDocumentToken();\n}\ngetData();\n< /script>\n\n

STEP 3:Get Documents

\n\n

This Steps can be performed only after the successful authentication in web-flow to get the list of issued documents from user digiLocker account.

\n\n

STEP 4:Download File

\n\n

This Steps can be performed to get the Document file in PDF format using the required document keyName and the encryptionKey which is received in the above step.

\n\n

STEP 5:Add Documents

\n\n

This Steps can be performed only after the successful authentication in web-flow.

\n\n

This process allows you to add the new documents/certificates in user digiLocker account.

","_postman_id":"012eafd9-f6df-451a-bf46-d8e01fd3e4c4"},{"name":"Document Extraction","item":[{"name":"OCR","id":"f6ac3ceb-03d2-423b-b45a-bb5bfbea2d6c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr","description":"

IDcentral's OCR API enables the extraction of information from various ID cards through scanning or uploading a picture. This process is completed within seconds and accurately provides data that can be readily filled in the appropriate fields, resulting in a faster and error-free form-filling experience and smoother customer onboarding. This API accepts the image file in the form of either a URL linking to an image or a base64-encoded image.

What is OCR?

An Optical Character Recognition (OCR) API helps you transcribe text from image files and PDF documents and receive the extracted data in a JSON file format. OCR scans images of documents, invoices, receipts, recognizes and extracts text from them, and transcribes it into a format for interpretation by the machines. OCR APIs are built on OCR technology but what differentiates them is that they are trained to extract data from specific documents, this training allows them to be more accurate in extracting data from those specific document types.

Definition

MRZ: Machine readable zone (MRZ), is basically a document holder’s personal information in an encoded format to maintain confidentiality. It is 2 or 3 lines of coded information, a series of characters, numbers and separators whose initial objective was to speed up the automatic reading of a person’s personal data.

Supported Documents and Constraints:

As of now, we support the following types of documents for extracting data from image files to JSON format.

India:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	Aadhaar
VID	Voter Id
PAN	PAN
DL	Driving License
PSPT	Passport

Nepal:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
CTZ	Citizenship Certificate
VID	Voter Id
PAN	PAN
DL	Driving License
PSPT	Passport

Maldives:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID
PSPT	Passport
WP	Work Permit

Indonesia:

\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID

Lesotho:

\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID

Senegal:

\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID

Cambodia:

\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID

Supported file formats: In this OCR API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
File size should not exceed 5 MB.
Country Code to be in ISO-3166-1 format (eg. for India it is 'IN').

country_id: The default country code according to ISO-3166-1 alpha-2. For instance, IN for India.

document_type: The document code of the selected document type in supported documents table.

Note - This API accepts any combination of formats. For instance, user can give front image in the base 64 format and back image in accesible URL format and vice versa.

Request: The request has to be passed in body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	country_id	String	Required	Code of country
2	document_type	String	Required	Type of document
3	verify_document_type	String	Optional	Possible values are \"yes\" or \"no\". If the user sets it to yes and the document_type doesn't match with the uploaded document, it will give invalid document and if the user sets it to no it will give the OCR details irrespective of the document_type (It only gives the detail corresponding to document type and uploaded document) Note: Default value is \"no\"
4	document_front_url or document_front_base64	String	Required	Document image in the form URL or Base 64 Note - If User wants to give the URL in input, document_front_url should be used and if User wants to give the base 64 in input, document_front_base64 should be used
5	document_back_url or document_back_base64	String	Optional	Document image in the form URL or Base 64 Note - If User wants to give the URL in input, document_back_url should be used and if User wants to give the base 64 in input, document_back_base64 should be used

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\", it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Number	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched when the OCR is performed

OCR Model for NID: OCR Model for Aadhaar Card:

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is perfomed
1.1	ocrs	Object	Front Side Image details
1.1.1	name	String	Name of the document holder extracted from DOC
1.1.2	id_number	String	The unique Id number of the document extracted from the DOC.
1.1.3	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints:
1.1.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD:MM:YYYY
1.1.5	gender	String	Gender information extracted from the DOC.
1.1.6	address	String	address extracted from the DOC.
1.1.7	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')
1.2	ocrsBackImage	Object	Back side image details
1.2.1	name	String	name of the document holder extracted from DOC
1.2.2	id_number	String	The unique Id number of the document extracted from the DOC.
1.2.3	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints
1.2.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD: MM: YYYY
1.2.5	gender	String	Gender information extracted from the DOC.
1.2.6	address	String	Address extracted from the DOC.
1.2.7	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')

OCR Model for DL:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is perfomed
1.1	ocrs	Object	Front Side Image details
1.1.1	name	String	name of the document holder extracted from DOC
1.1.2	dob	String	Date of birth of document holder
1.1.3	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints
1.1.3	id_number	String	DL number

OCR Model for Pan Card:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is perfomed
1.1	ocrs	Object	Front Side Image details
1.1.1	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints
1.1.2	name	String	name of the document holder extracted from OCR
1.1.3	father_name	String	Father's name of the document holder
1.1.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD: XX MM: XX YYYY: XXXX
1.1.6	id_number	String	PAN of the document holder
1.1.7	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')

OCR Model for Voter ID:

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is performed
1.1	document_type	String	Voter ID front Image details
1.2	full name	String	full name with value and confidence
1.3	age	Number	Age of the document holder with value and confidence
1.4	care_of	String	Father's Name / Spouse Name details with value and confidence score on extracted data
1.5	dob	String	Date of birth of the document holder with value and confidence
1.6	doc	String	DOC of the document holder with value and confidence
1.7	gender	Number	gender of the document holder with value and confidence
1.8	id_number	Number	VID Number of the document holder with value and confidence
1.9	document_type	String	Voter ID back Image details
1.10	address	Object	Address Details with value and confidence score in the range 0-100
1.10.1	first_line	String	Address first line
1.10.2	second_line	String	Address second line
1.10.3	locality	String	Address locality
1.10.4	landmark	String	Address landmark
1.10.5	house_number	String	Address house number
1.10.6	district	String	Address district
1.10.7	city	String	Address City
1.10.8	state	String	Address state
1.10.9	country	String	Address country
1.10.10	zip	String	Address zip code
1.11	epic_number	Object	epic number with value and confidence score on extracted data
1.12	dob	Object	DOB details with value and confidence score on extracted data
1.13	doi	Object	DOI details with value and confidence score on extracted data
1.14	gender	Object	Gender details with value and confidence score on extracted data
1.15	age	Object	Age details with value and confidence score on extracted data

OCR Model for Passport:

(Note: IDcentral Passport OCR API supports passports of 150+ countries)

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is performed
1.1	front	Object	Document Front Side details
1.1.1	ocr	Object	OCR details
1.1.1.1	document_type	Object	Document Type details with value and content details on extracted data
1.1.1.2	place_of_issue	Object	Place of issue details with value and content details on extracted data
1.1.1.3	nationality	Object	Nationality details with value and content details on extracted data
1.1.1.4	last_name	Object	Last Name details with value and content details on extracted data
1.1.1.5	date_of_birth	Object	DOB details with value and content details on extracted data
1.1.1.7	date_of_issue	Object	DOI details with value and content details on extracted data
1.1.1.8	sex	Object	Gender details with value and content details on extracted data
1.1.1.9	country_region	Object	Country details with value and content details on extracted data
1.1.1.10	date_of_expiration	Object	DOE details with value and content details on extracted data
1.1.1.11	place_of_birth	Object	Place of Birth details with value and content details on extracted data
1.1.1.12	first_name	Object	First Name details with value and content details on extracted data
1.1.2	mrz	Object	MRZ details from Passport
1.1.3	sex	Object	Gender details with value and content details on extracted data
1.1.4	date_of_expiration	Object	DOE details with value and content details on extracted data
1.1.5	country_region	Object	Country details with value and content details on extracted data
1.1.6	id_number	String	Passport Number details with value and content details on extracted data
1.1.7	nationality	Object	Nationality details with value and content details on extracted data
1.1.8	last_name	Object	Last Name details with value and content details on extracted data
1.1.9	date_of_birth	Object	DOB details with value and content details on extracted data
1.1.10	first_name	Object	First Name details with value and content details on extracted data

Scenarios Covered

Scenario	Status Code	Response Code	Status	Message	Error
When system has successfully captured the details	200	1	success	Successful Request
When low quality document is uploaded	200	2	success	Document is blurred or of low quality	Verification failed
Unable to detect Face; Blurred Image	200	3	success	Unable to detect Face; Blurred Image	Verification failed
When API is unable to validate the document	200	4	success	Unable to validate document	Verification failed
When invalid doc type is selected	400	-1	failed	The Document type provided in request is not valid/not supported by IDC system. Please provide the valid document type	Validation Error
When invalid country_id is provided	400	-1	failed	The Country code provided in request is not valid/not supported by IDC system. Please provide the valid country_id	Validation Error
When country_id is empty	400	-1	failed	country_id is empty	Validation Error
when invalid or incorrect image is provided	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png	Validation Error
When file size is more than 5 MB	400	-1	failed	File exceeds maximum file size 5000000 bytes and DSC00203.JPG size is 21233664	Validation Error
Inaccessible URL	400	-1	failed	Image URL Unreachable	Validation Error
Invalid Image URL format	400	-1	failed	Invalid Image URL format	Validation Error
Invalid Image Base64 format	400	-1	failed	Invalid Image Base64 format	Validation Error
Any other mismatch error	200	9	success

","urlObject":{"path":["v2","ocr"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"2b6b70d3-d4ed-497a-8d4e-2e3efa61c82d","name":"NID-Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_nid_ocr_v2_YmfkYBlwipOBUqrIFixN\",\n \"timestamp\": 1695613669751,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"ocrs\": {\n \"name\": {{name}},\n \"id_number\": \"XXXX XXXX XXXX\",\n \"id_type\": \"IN-NID\",\n \"date_of_birth\": \"DD: 09 MM: 09 YYYY: 19XX\",\n \"gender\": \"MALE\",\n \"address\": \"\",\n \"extracted_country\": \"IN\"\n },\n \"ocrsBackImage\": {\n \"name\": \"\",\n \"id_number\": \"\",\n \"id_type\": \"IN-NID\",\n \"date_of_birth\": \"\",\n \"gender\": \"\",\n \"address\": {{Address}},\n \"extracted_country\": \"IN\"\n }\n }\n}"},{"id":"f859cafd-159b-43d7-9b25-5d75af23a0f2","name":"PAN-Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"PAN\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_pan_ocr_v2_WweHWCoA61R7S8D6vcLz\",\n \"timestamp\": 1695610966079,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"ocrs\": {\n \"id_type\": \"IN-PAN\",\n \"name\": \"{{name}}\",\n \"father_name\": \"{{father's name}}\",\n \"date_of_birth\": \"DD: 17 MM: XX YYYY: 19XX\",\n \"id_number\": \"{{PAN Number}}\",\n \"extracted_country\": \"IN\"\n },\n \"ocrsBackImage\": {\n \"id_type\": \"IN-PAN\",\n \"name\": \"{{name}}\",\n \"father_name\": \"{{father's name}}\",\n \"date_of_birth\": \"DD: XX MM: XX YYYY: 19XX\",\n \"id_number\": \"{{PAN number}}\",\n \"extracted_country\": \"IN\"\n }\n }\n}"},{"id":"d893b1bd-7f0f-40bb-be93-958af7c94b38","name":"VID-Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"VID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_vid_ocr_v2_LJY2FJRZT3HfaEb0kHI7\",\n \"timestamp\": 1695613273093,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": [\n [\n {\n \"document_type\": \"voterid_front\",\n \"full_name\": {\n \"value\": \"XXXXXXXXX\",\n \"confidence\": 91.0\n },\n \"age\": {\n \"value\": \"\",\n \"confidence\": 0.0\n },\n \"care_of\": {\n \"value\": \"XXXXXX\",\n \"confidence\": 93.0\n },\n \"dob\": {\n \"value\": \"XXXX-XX-05\",\n \"confidence\": 92.0,\n \"yob\": false\n },\n \"doc\": {\n \"value\": \"XXXX-01-01\",\n \"confidence\": 0.0,\n \"yob\": false\n },\n \"gender\": {\n \"value\": \"X\",\n \"confidence\": 93.0\n },\n \"id_number\": {\n \"value\": \"XXXXXXXX\",\n \"confidence\": 91.0\n }\n }\n ],\n [\n {\n \"document_type\": \"voterid_back\",\n \"address\": {\n \"value\": \"{{Address}}\",\n \"confidence\": 71.0,\n \"first_line\": \"\",\n \"second_line\": \"\",\n \"locality\": \"\",\n \"landmark\": \"\",\n \"house_number\": \"\",\n \"district\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"country\": null,\n \"zip\": \"\"\n },\n \"zip\": {\n \"value\": \"XXXXXX\",\n \"confidence\": 71.0\n },\n \"epic_number\": {\n \"value\": \"XXXXXXX\",\n \"confidence\": 91.0\n },\n \"dob\": {\n \"value\": \"1800-01-01\",\n \"confidence\": 0.0,\n \"yob\": false\n },\n \"doi\": {\n \"value\": null,\n \"confidence\": 0.0,\n \"yob\": false\n },\n \"gender\": {\n \"value\": \"\",\n \"confidence\": 0.0\n },\n \"age\": {\n \"value\": \"\",\n \"confidence\": 0.0\n }\n }\n ]\n ]\n}"},{"id":"84ad7a28-b0b4-48be-ad14-8c4fd6499b1f","name":"DL-Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"DL\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_dl_ocr_v2_BJBjwDq8q7pQ0QRJqcaB\",\n \"timestamp\": 1695613930958,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"ocrs\": {\n \"name\": \"XXXX XXXXX XXXX\",\n \"dob\": \"\",\n \"id_type\": \"IN-DL\",\n \"id_number\": \"XXXXXXXXXXXXXX\"\n },\n \"ocrsBackImage\": null\n }\n}"},{"id":"9a7c7ba0-e3b9-4a4e-9033-c72112ecb362","name":"PSPT-Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"PSPT\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_pspt_ocr_v2_R9eod4yK15eBdNyGXT1X\",\n \"timestamp\": 1695614178995,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"front\": {\n \"ocr\": {\n \"document_type\": {\n \"value\": \"P\",\n \"content\": \"P\"\n },\n \"id_number\": {\n \"value\": \"G XXXXXXX\",\n \"content\": \"G XXXXXX\"\n },\n \"place_of_issue\": {\n \"value\": \"XXXX\",\n \"content\": \"XXXX\"\n },\n \"nationality\": {\n \"value\": \"IND\",\n \"content\": \"INDIAN\"\n },\n \"last_name\": {\n \"value\": \"XXXX\",\n \"content\": \"XXXX\"\n },\n \"date_of_birth\": {\n \"value\": \"XXXX-03-10\",\n \"content\": \"10/03/XXXX\"\n },\n \"date_of_issue\": {\n \"value\": \"XXXX-10-13\",\n \"content\": \"13/10/XXXX\"\n },\n \"sex\": {\n \"value\": \"M\",\n \"content\": \"M\"\n },\n \"country_region\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"date_of_expiration\": {\n \"value\": \"XXXX-10-12\",\n \"content\": \"12/10/XXXX\"\n },\n \"place_of_birth\": {\n \"value\": \"XXXXXXX XXXXXX\",\n \"content\": \"XXXXXXX XXXXX\"\n },\n \"first_name\": {\n \"value\": \"XXXXXXXX KUMAR\",\n \"content\": \"XXXXXXXX KUMAR\"\n }\n },\n \"mrz\": {\n \"sex\": {\n \"value\": \"M\",\n \"content\": \"M\"\n },\n \"date_of_expiration\": {\n \"value\": \"XXXX-10-12\",\n \"content\": \"\"\n },\n \"country_region\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"id_number\": {\n \"value\": \"XXXXXXXX\",\n \"content\": \"XXXXXXX\"\n },\n \"nationality\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"last_name\": {\n \"value\": \"XXXXX\",\n \"content\": \"XXXXXX\"\n },\n \"date_of_birth\": {\n \"value\": \"XXXX-XX-XX\",\n \"content\": \"\"\n },\n \"first_name\": {\n \"value\": \"XXXXXXX KUMAR\",\n \"content\": \"XXXXXXX KUMAR\"\n }\n },\n \"barcode\": null\n },\n \"back\": null\n }\n}"},{"id":"12097817-d31f-4c94-8bd1-00d8a2fe8377","name":"Low quality document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_nid_ocr_v2_Zrw0LufYUjMSpxUD8XpI\",\n \"timestamp\": 1695616079570,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Document is blurred or of low quality\",\n \"data\": null\n}"},{"id":"33e6584f-3f2f-4aff-93ac-5319b5a7a49e","name":"Unable to Validate the document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_vid_ocr_v2_55bO0EpWM4gdTWgHJ0hK\",\n \"timestamp\": 1695625473481,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 4,\n \"error\": \"Verification failed\",\n \"message\": \"Unable to validate document\",\n \"data\": null\n}"},{"id":"b721a2f0-39d0-4f78-b54a-3f283fe4fcff","name":"Unsupported image file","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_vid_ocr_v2_IPVjlZK2cwYX1kmzNkW8\",\n \"timestamp\": 1695620947656,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png)\",\n \"data\": null\n}"},{"id":"b28ddb5e-1bbf-488b-818e-0b40ddd7cdc6","name":"Invalid document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"id_pan_ocr_v2_ZVu498ClsjPaEK41oDCi\",\n \"timestamp\": 1695617853455,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"The Document type provided in request is not valid/not supported by IDC system. Please provide the valid document type\",\n \"data\": null\n}"},{"id":"31be7411-0015-4de9-8b57-24a9e562dbe5","name":"Empty Country ID","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"_vid_ocr_v2_xyvD2wqF7RC9ZrOAgero\",\n \"timestamp\": 1695618473921,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"country_id is empty\",\n \"data\": null\n}"},{"id":"2d59144e-3ef8-4a8f-ab16-7c7246ea2cef","name":"Inaccessible URL","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Length","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_vid_ocr_v2_hX6c3iqjydexM3e2V7NR\",\n \"timestamp\": 1695620743397,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Input Error\",\n \"message\": \"Validation Error\",\n \"data\": null\n}"},{"id":"4464267b-e85a-4c1f-8cfc-002906b9fa46","name":"Invalid Image URL","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_pan_ocr_v2_WCTPiG669it1nAr90zD1\",\n \"timestamp\": 1695611269949,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid Image URL format\",\n \"data\": null\n}"},{"id":"31d65568-3c1b-42c3-8d16-0533edfb85a8","name":"Invalid base 64 format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"country_id\": \"IN\",\r\n \"document_type\": \"NID\",\r\n \"verify_document_type\": \"no\",\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/ocr"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"326"},{"key":"Date","value":"Mon, 25 Sep 2023 10:07:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_pan_ocr_v2_sN7FlRDhOG0DBskW0cS2\",\n \"timestamp\": 1695612500034,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid Image Base64 format\",\n \"data\": null\n}"}],"_postman_id":"f6ac3ceb-03d2-423b-b45a-bb5bfbea2d6c"},{"name":"Long Form Document Extraction","id":"9ea05e15-77f9-4b85-b64e-7c60a9eb84cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","src":"/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"},{"key":"doc_type","value":"\"bank_statement\"","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction","description":"

The \"Long Document Extraction API\" allows users to retrieve structured data from lengthy documents. This API accepts input file in PDF format for rental agreement and bank statement and in PDF,PNG,JPEG formats for invoice, with a maximum file size of 10 MB.

List of Documents we are supporting as of now:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
rental_agreement	Rental Agreement
bank_statement	Bank Statement
invoice	Invoice

Request: The request has to be passed in form data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key	Data Type	Required	Description
file	file	Required	Rental Agreement, bank statement in PDF format. Invoice in PDF,PNG, or JPEG format.
doc_type	Text	Required	Type of Document

Response (Rental Agreement):

S.No	Key	Data Type	Description
1	txn_id	Text	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	Text	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Text	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	Text	This text content explains the reason if API request has failed
7	message	Text	This field confirms if the API request is successful or not and shows respective message
8	data	Text	Data contains the detailed information received
8.1	document_type	Text	Type of document for which OCR is to be performed
8.2	lessor_name	Text	Name of lessor according to document
8.3	lessee_name	Text	Name of lessee according to document
8.4	lessor_address	Text	Address of lessor according to document
8.5	lessee_address	Text	Address of lessee according to document
8.6	property_address	Text	Adress of property to be rented
8.7	lease_start_date	Text	Start date of lease according to document
8.8	lease_end_date	Text	End date of lease according to document
8.9	monthly_rent	Number	Rent to be given monthly according to document
8.10	lease_deposit	Number	Initial deposit according to document

Response(Bank Statement):

S.No	Key	Data Type	Description
1	txn_id	Text	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	Text	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Text	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	Text	This text content explains the reason if API request has failed
7	message	Text	This field confirms if the API request is successful or not and shows respective message
8	data	Text	Data contains the detailed information received
8.1	document_type	Text	Type of document for which OCR is to be performed
8.2	account_holder	Text	Name of the account holder
8.3	statement_start_date	Text	Start date of the bank statement
8.4	statement_end_date	Text	End date of the bank statement
8.5	average_balance_3months	Number	Average balance of 3 months
8.6	average_balance_6months	Number	Average balance of 6 months
8.7	recurring_credits	Number	Recurring credit amount
8.8	recurring_debits	Number	Recurring debit amount
8.9	atm_withdrawals_by_month	Number	ATM Withdrawal

Response(Invoice):

S.No	Key	Data Type	Description
1	txn_id	Text	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	Text	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Text	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	Text	This text content explains the reason if API request has failed
7	message	Text	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received. The information is followed by a confidence number that indicates confidence of extraction.
8.1	invoice_number	Object	The invoice number as per the document is extracted if available.
8.2	invoice_date	Text	The date on which the invoice is issued as mentioned in the document in DD-MM-YYYY format.
8.3	invoice_due_date	Text	Due date for the issued invoice as per the document if available in DD-MM-YYYY format.
8.4	invoicer	Text	The name of the vendor from whom the invoice is issued.
8.5	invoicer_address	Text	The address of the vendor who issued the invoice.
8.6	invoicer_email	Text	The email-id of the vendor who issued the invoice if available in document.
8.7	invoicer_phone	Text	The phone number of the vendor who issued the invoice if available in document.
8.8	invoicer_tax_number	Text	The GST number of the vendor who issued the invoice if available in document.
8.9	invoicer_pan_number	Text	The PAN of the vendor who issued the invoice if available in document.
8.10	invoice_to	Text	The name of the receiver to whom the invoice is addressed to.
8.11	invoice_to_address	Text	Address of the receiver to whom the invoice is addressed to.
8.12	total_invoice_value	Text	Total payable amount as mentioned in the document.
8.13	currency	Text	Currency in which the invoice is written if available in document.
8.14	line_items	Object	List of item names along with its total value(price) as per the document.
8.14.1	item	Text	Description of the item present in invoice.
8.14.2	total_value	Number	The total price of the particular item as mentioned in document.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When system successfully captures the details	200	1	success	Successful Request
When a non invoice document is uploaded when the request has doc_type \"invoice:.	200	2	success	Unsupported document. Please submit an invoice document.	Verification error
When uploaded an invoice more than 5 pages, when the request doc_type is \"invoice\".	400	-1	failed	Please ensure your file contains fewer than 5 pages and try again.	Validation error
When size of the file uploaded exceeds 10MB	400	-1	failed	File exceeds maximum file size 10485760 bytes and name.pdf size is 12276923 bytes\"	Invalid request
When given \"doc_type is invalid\"	400	-1	failed	Invalid doc_type	Input Error
When \"doc_type\" is not given	400	-1	failed	doc_type not found in request	Input Error
When bank statement is not supported, when doc_type is \"bank_statement\".	400	-1	failed	Document not supported	Input Error
When the input file uploaded is invalid MIME type.	400	-1	failed	Please provide the supported MIME types (image/jpeg, image/png and application/pdf)	Validation error

","urlObject":{"path":["v2","document-extraction"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"9503fb0f-1c99-4790-8738-d09eacae8a48","name":"Long Form Document Extraction","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/2017-18 Rajshekar Agreement.pdf"],"value":null},{"key":"doc_type","value":"\"rental_agreement\"","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"264"},{"key":"Date","value":"Wed, 17 May 2023 14:47:32 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_p3u8EyPYc49RYEvNI15a\",\n \"timestamp\": 1684126085786,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"document_type\": \"Lease Agreement\",\n \"lessor_name\": \"full_name\",\n \"lessee_name\": \"lessee_name.\",\n \"lessor_address\": \"lessor_address\",\n \"lessee_address\": \"lessee_address\",\n \"property_address\": \"NA\",\n \"lease_start_date\": \"01/03/2017\",\n \"lease_end_date\": \"01/03/2018\",\n \"monthly_rent\": \"INR 12,700\",\n \"lease_deposit\": \"INR 70,000\"\n }\n}"},{"id":"3259442a-c93b-436e-a707-ccc63e2f159d","name":"Bank Statement - Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","value":null},{"key":"doc_type","value":"bank_statement","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_N22GE3x9qyLUjv42F6JI\",\n \"timestamp\": 1700218900961,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"account_holder\": \"{{Account holder name}}\",\n \"statement_start_date\": \"2023-01-01\",\n \"statement_end_date\": \"2023-05-01\",\n \"average_balance_3months\": {\n \"2023q1\": 2503.82,\n \"2023q2\": 350.01\n },\n \"average_balance_6months\": {\n \"2023h1\": 1952.02\n },\n \"recurring_credits\": [],\n \"recurring_debits\": [],\n \"atm_withdrawals_by_month\": {}\n }\n}"},{"id":"4eb8ea95-4030-44fa-b903-900046a62a41","name":"Invoice - Successful scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"],"value":null},{"key":"doc_type","value":"invoice","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_JkkzJrj1ltva4LZuxHVm\",\n \"timestamp\": 1710310551682,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"invoice_number\": null,\n \"invoice_date\": {\n \"value\": \"DD-MM-YYYY\",\n \"confidence\": 99.688705\n },\n \"invoice_due_date\": null,\n \"invoicer\": {\n \"value\": \"Abc Corp.Ltd\",\n \"confidence\": 99.09403\n },\n \"invoicer_address\": {\n \"value\": \"abc street, xyz\",\n \"confidence\": 85.691635\n },\n \"invoicer_email\": null,\n \"invoicer_phone\": {\n \"value\": \"XXXXXXXXXX\",\n \"confidence\": 96.65245\n },\n \"invoicer_tax_number\": {\n \"value\": \"XXXXXXXXXXXXXX\",\n \"confidence\": 99.53993\n },\n \"invoicer_pan_number\": {\n \"value\": \"XXXXXXXXXXX\",\n \"confidence\": 99.29132\n },\n \"invoice_to\": {\n \"value\": \"XYZ Ltd\",\n \"confidence\": 99.380455\n },\n \"invoice_to_address\": {\n \"value\": \"abcd, Pin: 100999, ...\",\n \"confidence\": 98.12981\n },\n \"total_invoice_value\": {\n \"value\": \"XXXX.00\",\n \"confidence\": 99.922066\n },\n \"currency\": {\n \"value\": \"INR\",\n \"confidence\": 100.0\n },\n \"line_items\": [\n {\n \"item\": {\n \"value\": \"STANDEE\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"32xx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"BUSINESS CARD ( 1 NAMES ) 100 NOS\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"3xxx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"PEN WITH LOGO PRINTING\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"3xxx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"NOTE BOOK\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"xx.200.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"xxxxxxxxxx\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"1xxxx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"BROCHURExxxxx\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"1xxx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"BROCHUxxxx\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"1xxxxxx.00\",\n \"confidence\": 70.0\n }\n },\n {\n \"item\": {\n \"value\": \"Cxxxxxxxxxxxx\",\n \"confidence\": 70.0\n },\n \"total_value\": {\n \"value\": \"3xxxx.00\",\n \"confidence\": 70.0\n }\n }\n ]\n }\n}"},{"id":"9ab34bdc-58e3-4c2d-b2e8-0edce90c05a8","name":"Invoice - unsupported document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"],"value":null},{"key":"doc_type","value":"invoice","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_Le0VTrAixHVbbroVYeF4\",\n \"timestamp\": 1710312473002,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification error\",\n \"message\": \"Unsupported document. Please submit an invoice document.\",\n \"data\": null\n}"},{"id":"75205ea8-3d08-4883-90e0-48440de8c5ca","name":"Invoice - exceeded no.of pages","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","filesNotInWorkingDirectory":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"],"value":null},{"key":"doc_type","value":"invoice","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_i3vPWJTUS1FlnRaaWW4v\",\n \"timestamp\": 1710315525637,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please ensure your file contains fewer than 5 pages and try again.\",\n \"data\": null\n}"},{"id":"396a0dbd-4fa0-4df2-999e-10a6db4a3f37","name":"Exceeded file size","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","value":null},{"key":"doc_type","value":"","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_AqZtr5XrjD59lrSIP1JH\",\n \"timestamp\": 1710320148667,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Invalid Request\",\n \"message\": \"File exceeds maximum file size 10485760 bytes and name.pdf size is 12276923 bytes\",\n \"data\": null\n}"},{"id":"528be7ed-9264-48b0-aca1-27869cb43cbf","name":"doc_type not found in request","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","src":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"]},{"key":"doc_type","value":"","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:43:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_CtVQa3qCtyabfJas4mxI\",\n \"timestamp\": 1700221439334,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Input Error\",\n \"message\": \"doc_type not found in request\",\n \"data\": null\n}"},{"id":"de4f7e01-0712-4b02-b5ea-07b55a1bd351","name":"Invalid doc_type","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","src":["/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"]},{"key":"doc_type","value":"invalid","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:46:35 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_F2PSKHjJHjDnr1oHzAsq\",\n \"timestamp\": 1700221595307,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Input Error\",\n \"message\": \"Invalid doc_type\",\n \"data\": null\n}"},{"id":"1bd1e867-491e-403c-b4f0-923ac22c59e2","name":"Unsupported MIME type","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","key":"file","fileNotInWorkingDirectoryWarning":"This file isn't in your working directory. Teammates you share this request with won't be able to use this file. To make collaboration easier you can setup your working directory in Settings.","src":"/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/Citi Bank-3-Pages (1).pdf"},{"key":"doc_type","value":"invalid","type":"text"}]},"url":"https://api.idcentral.io/idc/v2/document-extraction"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 17 Nov 2023 11:46:35 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"long_form_document_extraction_D4uJrlCEvbvnAK9yGbWW\",\n \"timestamp\": 1710395480962,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide the supported MIME types (image/jpeg, image/png and application/pdf).\",\n \"data\": null\n}"}],"_postman_id":"9ea05e15-77f9-4b85-b64e-7c60a9eb84cc"},{"name":"Advanced Document Reader","id":"e10bec18-4826-48ed-982d-529daf0877e3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"document_front_base64\",\n \"document_back_base64\": \"document_back_base64\"\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader","description":"

\"Advanced Document Reader API\" allows users to access a robust standalone software solution aimed at optimizing and strengthening the identity verification process. This offers full automation for extracting and validating personal information from passports, ID cards, driver's licenses, visas, and a wide range of other identity documents.This API accepts the image file in the form of either a URL linking to an image or a base64-encoded image.

As of now, we support the list of documents and it is incremental.

Supported file formats: In this OCR API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
File size should not exceed 5 MB.

Note - This API accepts any combination of formats. For instance, user can give front image in the base 64 format and back image in accesible URL format and vice versa.

Request: The request has to be passed in the body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	document_front_url or document_front_base64	String	Required	Document image in the form URL or Base 64 Note - If User wants to give the URL in input, document_front_url should be used and if User wants to give the base 64 in input, document_front_base64 should be used
2	document_back_url or document_back_base64	String	Optional	Document image in the form URL or Base 64 Note - If User wants to give the URL in input, document_back_url should be used and if User wants to give the base 64 in input, document_back_base64 should be used

Response:

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Number	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\", it confirms that the request has failed due to an error
4	status_code	Number	The http status code of the API. Refer Errors and Status Codes
5	response_code	Number	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched when the OCR is performed
8.1	document_identity	String	details of document
8.2	document_name	String	name of the document
8.3	doc_issue_country_code	String	Country code of the issuing country
8.4	doc_issue_country_name	String	Name of the issuing country
8.5	mrz_present	Bollean	If MRZ is present or not.
8.6	camera_exposure	Number	Camera Exposure
8.7	recognition_probability	Number	Probability of the document recognition
9	ocr_data	Object	OCR fetched data

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When system has successfully captured the details	200	1	success	Successful Request
When invalid document is uploaded	200	2	success	Invalid Document	Verification failed
When file size is more than 5 MB	400	-1	failed	File exceeds maximum file size 5MB and {file name} size is {{file size}}	Validation Error
Invalid Image format	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png)	Validation Error
No access to URL	400	-1	failed	Image URL Unreachable	Validation Error
Invalid URL format	400	-1	failed	Invalid Image URL format	Validation error
Any other mismatch error	200	9	success

","urlObject":{"path":["v2","advanced-document-reader"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"8b3f66d8-21a7-4ea4-b5d5-708f27e96d8b","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advnaced_document_reader_aCn7h55mPiAC3brt38ZD\",\n \"timestamp\": 1696917064222,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"document_identity\": {\n \"document_name\": \"Maldives - Id Card #1 Side B\",\n \"doc_issue_country_code\": \"MDV\",\n \"doc_issue_country_name\": \"Maldives\",\n \"mrz_present\": false,\n \"camera_exposure\": 5,\n \"recognition_probability\": 0.7720088958740233\n },\n \"ocr_data\": {\n \"address\": \"XXXXXXX\",\n \"age\": \"XX\",\n \"blood_group\": \"O+\",\n \"date_of_birth\": \"6/6/XXXX\",\n \"date_of_expiry\": \"10/9/XXX\",\n \"document_name\": \"Maldives - Id Card #1 Side B\",\n \"given_names\": \"Aas\",\n \"issuing_state_code\": \"MDV\",\n \"issuing_state_name\": \"Maldives\",\n \"regcert_regnumber\": \"XXXXX\",\n \"remainderterm\": \"0\",\n \"sex\": \"M\",\n \"surname_and_given_names\": \"XXXX XXXXX\"\n },\n \"images\": {\n \"signature\": \"XXXXXX\",\n \"portrait\": \"\"\n }\n }\n}"},{"id":"4f5b0ee0-8d82-460d-841a-e16e48673ec7","name":"Invalid Document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_document_reader_X6Gf079rHDe3pBO6l2pC\",\n \"timestamp\": 1696998345138,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid Document\",\n \"data\": null\n}"},{"id":"f277fd6f-62d9-4c63-acec-291453622994","name":"When image size exceeds maximum size limit","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_document_reader_WGgDME1Ve4ocykGN4pTG\",\n \"timestamp\": 1697019361255,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"File exceeds maximum file size 5242880 bytes and {file name} size is 6614340\",\n \"data\": null\n}"},{"id":"3a1daa68-14f2-41dc-af67-41a0aa740820","name":"Invalid Image format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_document_reader_DNZSeoCgf9VNVCPXm411\",\n \"timestamp\": 1697019581629,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png)\",\n \"data\": null\n}"},{"id":"a7e98908-f4b1-4efe-9626-5056f6f1cad7","name":"Unreachable Image URL","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_document_reader_TYXFbyZkKXS19kbXMkU7\",\n \"timestamp\": 1697019966625,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Image URL Unreachable\",\n \"data\": null\n}"},{"id":"0365c92b-f9e2-454e-ae96-411deadf5ab7","name":"Invalid Image URL format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\n}"},"url":"https://api.idcentral.io/idc/v2/advanced-document-reader"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Mon, 16 Oct 2023 10:03:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_document_reader_ikcrhcZyrkgb9stHsics\",\n \"timestamp\": 1697019539311,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid Image URL format\",\n \"data\": null\n}"}],"_postman_id":"e10bec18-4826-48ed-982d-529daf0877e3"}],"id":"d3511c6a-044d-447d-b184-c01a47babaab","description":"

The process of document extraction involves identifying data relationships within a document, represented as key-value pairs. For instance, when processing an Aadhaar card document, the algorithm identifies all the form fields and pairs the corresponding field names with their respective values.

\n","event":[{"listen":"prerequest","script":{"id":"e926122a-fa1d-4b9e-8708-f108db83b972","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7b1726c4-61ea-4463-b62e-4952adfecc7c","type":"text/javascript","exec":[""]}}],"_postman_id":"d3511c6a-044d-447d-b184-c01a47babaab"},{"name":"Driving License","item":[{"name":"Driving License","id":"97cf0e9a-f936-4a9e-bcd3-b7116110a2ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\r\n\"id_number\": \"MH12 XXXXXXXXXXXXXX\",\r\n\"dob\": \"1992-04-18\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/driving-license","description":"

This API will verify the legitimacy of a Driving Licence. You will need to pass the Driving Licence Number to verify the status of the licence.
On successful validation, the API will return the complete Driving Licence details including name, address and photograph.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Driving license number to be passed
2	dob	String	Required	Pass the dob updated in Driving license records (i.e format yyyy-MM-dd)

Response:

S. No	Key	Data Type	Description
1	data	Object	Data as per the Driving License records
1.1	client_id	String	Unique client id of the transaction
1.2	license_number	String	Driving License number passed in request
1.3	state	String	State Value as per the Driving License Record
1.4	name	String	Name Value as per the Driving License Records
1.5	permanent_address	String	Permanent Address of the DL owner as per the Driving License Records
1.6	permanent_zip	String	Zip URL of the DL owner as per the Driving License Records
1.7	temporary_address	String	Temporary Address of the DL owner as per the Driving License Records
1.8	temporary_zip	String	Temporary Address ZIP file URL of the DL owner as per the Driving License Records
1.9	citizenship	String	Citizenship of the DL owner as per the Driving License Records
1.10	ola_name	String	The OLA Name as per the Driving License Records
1.11	ola_code	String	The OLA code as per the Driving License Records
1.12	gender	String	Gender of the DL owner as per the Driving License Records (M - Male, F- Female)
1.13	father_or_husband_name	String	Father or Husband Name of the DL owner as per the Driving License Records
1.14	dob	String	Date of Birth of the DL owner as per the Driving License Records
1.15	doe	String	DL expiry Date as per the Driving License Records
1.16	transport_doe	String	Transport DOE as per the Driving License Records
1.17	doi	String	Date of DL issued as per the Driving License Records
1.18	transport_doi	String	Transport DOI as per the Driving License Records
1.19	profile_image	String	Profile Image URL of the DL owner as per the Driving License Records
1.20	has_image	Boolean	Indicates the Profile Image exist or not.
1.21	blood_group	String	Blood Group of the DL owner as per the Driving License Records (Blood Group U indicates that \"unavailable\")
1.22	vehicle_classes	Array List	The class of the Vehicle as per the Driving License records. Refer: Driving Licence Categories and Class of Vehicles in India
1.23	less_info	Boolean	Any Misc info details. If available then value as 'true' and if not available 'false'.
1.24	additional_check	Array List	Any misc information
1.25	initial_doi	String	The DL initially issues Date as per the Driving License records
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When DL details are fetched successfully	200	1	success	Successful Request
When invalid DL ID is provided	200	9	success	UNPROCESSABLE ENTITY
When no DL ID is provided	400	-1	failed	Please provide the valid driving license number	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["driving-license"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f71c44c4-2ed1-4660-b008-93b8b9d4277e","name":"DL details fetched successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n\"id_number\": \"MH12 2XXXXXXXXXX\",\r\n\"dob\": \"YYYY-MM-DD\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/driving-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 12:01:20 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"license_chLFIyylyoXXXXXXXXXX\",\n \"license_number\": \"MH12 2XXXXXXXXXX\",\n \"state\": \"Maharashtra\",\n \"name\": \"PXXXXXXX BXXXXX\",\n \"permanent_address\": \"A/P XXXXX, XXXXX TAL XXXXX, DIST XXXX.\",\n \"permanent_zip\": \"XXX108\",\n \"temporary_address\": \"A/P XXXXXX, XXXXX TAL XXXXX, DIST XXXX.\",\n \"temporary_zip\": \"A/P XXXX, XXXXX TAL XXXXX, DIST XXXX.\",\n \"citizenship\": \"\",\n \"ola_name\": \"RTO,PUNE\",\n \"ola_code\": \"\",\n \"gender\": \"X\",\n \"father_or_husband_name\": \"XXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"doe\": \"YYYY-MM-DD\",\n \"transport_doe\": \"1900-01-01\",\n \"doi\": \"2015-08-21\",\n \"transport_doi\": \"1900-01-01\",\n \"profile_image\": \"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\",\n \"has_image\": true,\n \"blood_group\": \"\",\n \"vehicle_classes\": [\n \"LMV\",\n \"MCWG\"\n ],\n \"less_info\": false,\n \"additional_check\": [],\n \"initial_doi\": \"YYYY-MM-DD\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1668945678684,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_driving_license_q78PVIgIQSXXXXXXXXXX\"\n}"},{"id":"cae59aeb-98c3-4fc6-b4d3-62a5316a8089","name":"Invalid DL ID","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n\"id_number\": \"MH12 XXXXXXXXX\",\r\n\"dob\": \"1992-12-18\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/driving-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 12:02:31 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"license_ppgpyefgSaqbdbKvcjdg\",\n \"license_number\": \"MH12 2016000142\",\n \"state\": null,\n \"name\": null,\n \"permanent_address\": null,\n \"permanent_zip\": null,\n \"temporary_address\": null,\n \"temporary_zip\": null,\n \"citizenship\": null,\n \"ola_name\": null,\n \"ola_code\": null,\n \"gender\": null,\n \"father_or_husband_name\": null,\n \"dob\": \"1992-02-18\",\n \"doe\": null,\n \"transport_doe\": null,\n \"doi\": null,\n \"transport_doi\": null,\n \"profile_image\": null,\n \"has_image\": false,\n \"blood_group\": null,\n \"vehicle_classes\": [],\n \"less_info\": false,\n \"additional_check\": [],\n \"initial_doi\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": null,\n \"message\": \"UNPROCESSABLE ENTITY\",\n \"timestamp\": 1668945749751,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_driving_license_bOZjaucEitzTM8JVHjzy\"\n}"},{"id":"4d8b451d-9763-4792-a346-80f5357557b1","name":"Entered Empty DL field","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"body":{"mode":"raw","raw":"{\r\n\"id_number\": \"\",\r\n\"dob\": \"1992-12-18\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/driving-license"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 12:03:03 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid driving license number\",\n \"timestamp\": 1668945783669,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_driving_license_CmSt43bQZDzXWee7RXfy\"\n}"}],"_postman_id":"97cf0e9a-f936-4a9e-bcd3-b7116110a2ef"},{"name":"Driving License V2","id":"e5456691-d483-466e-ad9e-f8821b6a10f4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXXXX\",\r\n \"dob\": \"DD-MM-YYYY\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/driving-license","description":"

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Driving license number to be passed
2	dob	String	Required	Pass the dob updated in Driving license records (i.e format DD-MM-YYYY)

Response:

S. No	Key	Data Type	Description
1	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
2	timestamp	Integer	API response receive time in milliseconds
3	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	A text content explains a reason if API request failed
7	message	String	A text content explains if API request was successful or not.
8	data	Object	Data as per the Driving License records
8.1	license_number	String	Driving License number passed in request
8.2	state	String	State Value as per the Driving License Record
8.3	name	String	Name Value as per the Driving License Records
8.4	permanent_address	String	Permanent Address of the DL owner as per the Driving License Records
8.5	permanent_zip	String	Zip URL of the DL owner as per the Driving License Records
8.6	temporary_address	String	Temporary Address of the DL owner as per the Driving License Records
8.7	temporary_zip	String	Temporary Address ZIP file URL of the DL owner as per the Driving License Records
8.8	citizenship	String	Citizenship of the DL owner as per the Driving License Records
8.9	ola_name	String	The OLA Name as per the Driving License Records
8.10	ola_code	String	The OLA code as per the Driving License Records
8.11	gender	String	Gender of the DL owner as per the Driving License Records (M - Male, F- Female)
8.12	father_or_husband_name	String	Father or Husband Name of the DL owner as per the Driving License Records
8.13	dob	String	Date of Birth of the DL owner as per the Driving License Records
8.14	doe	String	DL expiry Date as per the Driving License Records
8.15	transport_doe	String	Transport DOE as per the Driving License Records
8.16	doi	String	Date of DL issued as per the Driving License Records
8.17	transport_doi	String	Transport DOI as per the Driving License Records
8.18	profile_image	String	Profile Image URL of the DL owner as per the Driving License Records
8.19	has_image	Boolean	Indicates the Profile Image exist or not.
8.20	blood_group	String	Blood Group of the DL owner as per the Driving License Records (Blood Group U indicates that \"unavailable\")
8.21	vehicle_classes	Array List	The class of the Vehicle as per the Driving License records. Refer: Driving Licence Categories and Class of Vehicles in India
8.22	less_info	Boolean	Any Misc info details. If available then value as 'true' and if not available 'false'.
8.23	initial_doi	String	The DL initially issues Date as per the Driving License records
8.24	current_status	String	Status of the entered DL number.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When DL details are fetched successfully	200	1	success	Successful Request
When verification fails due to invalid DL number or DOB	200	2	success	Invalid driving license number or DOB	Verification failed
When invalid DOB passed	400	-1	failed	Please provide a valid date of birth in DD-MM-YYYY format	Validation error
All other mismatch errors	200	9

","urlObject":{"path":["v2","driving-license"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"93574284-f307-44e8-b3e6-02afe001c9cd","name":"Successful scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXXXX\",\r\n \"dob\": \"DD-MM-YYYY\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/driving-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"298"},{"key":"Date","value":"Mon, 08 Jul 2024 08:59:39 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_driving_license_v2_PNXXXXKKMSS1zFotlDcMjvkM\",\n \"timestamp\": 1720428947918,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful Request\",\n \"data\": {\n \"license_number\": \"KXXXXXXXXXXXXXX\",\n \"state\": \"Karnataka\",\n \"name\": \"LXXXXXX A\",\n \"permanent_address\": \"# 0000 7TH MAIN X CROSS Xth STAGE KXXXXXXY LAYOUT J P NXXXRA BANGALORE\",\n \"permanent_zip\": \"56XXXX\",\n \"temporary_address\": \"# 0000 7TH MAIN X CROSS Xth STAGE KXXXXXXY LAYOUT J P NXXXRA BANGALORE\",\n \"temporary_zip\": \"560078\",\n \"citizenship\": null,\n \"ola_name\": null,\n \"ola_code\": null,\n \"gender\": null,\n \"father_or_husband_name\": \"AXXXX RXX S K\",\n \"dob\": \"DD-MM-YYYY\",\n \"doe\": \"DD-MM-YYYY\",\n \"transport_doe\": \"\",\n \"doi\": \"DD-MM-YYYY\",\n \"transport_doi\": \"\",\n \"profile_image\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAYEBQYFBAYGBQYHBwYIChAKCgkJChQODwwQFxQYGBcUFhYaHSUfGhsjHBYWICwgIyYnKSopGR8tMC0oMCUoKSj/2wBDAQcHBwoIChMKChMoGhYaKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCj/wAARCACWAGQDASIAAhEBAxEB/8QAHAAAAgMBAQEBAAAAAAAAAAAABQYABAcDAgEI/8QANhAAAgEDAgQEBAQGAgMAAAAAAQIDAAQRBSEGEjFBEyJRYQcUcYEykaHBFyNSYrHRJFNygvH/xAAaAQACAwEBAAAAAAAAAAAAAAAEBQACAwEG/8QAJREAAgMAAgICAQUBAAAAAAAAAAECAxEEEiExIkFRBRQyYXET/9oADAMBAAIRAxEAPwByVtq9qcjaq4OK9q+KKAywM4r6zYU4IyN/Wq3iAIzuwRUUsxY7AD1+1Zbx3x7Jeo2n6DI8dsMiWcbGT6e3vUzxrItbxGha3xZoujRuL2+RplGfBhHO/wBxnas/1b4t3zu66PZRQR9FefzN9cCs5WAuJ60xaZb87A46UKtI/ODTTpMfKAaxtkF0QClnAdgKO2EOzHO2+fpVG1GBjA3ovBC6okUYDTTMEQf3E4H+aGlLEw2KS8mw8Hx8nDGlIx/DAuM+navnFfC2mcR2Zj1CECUfgnTAdD9e49qIWEIgiggXYRIqD7DFXuoqtTePDzNstm2jBb34V8QQXDJYPaXlv1SVpOQkehG9St1eHmbIOKlELk2LxhX4gV+lU7rDRspGzDBq3J0ry0asN6WjKD6+RA1K0wJI8HynAyO1JOv6SSpKrgVrut2AZBKg6eU0r3tmrIwfBwaJjLPIyhJWR0xS7sHjJBXb1qn8m2+1atf6KsgIUCg0+imMHK7fSt1acdCb8CTaWzeJjFM2nwlVAqzHpYD5AOaK2Nh5x7VWU9Lwr6ljTLNnYMw8o3NNnCmnm44hgJGUtv5zfXfH64qjZWuBjOB3p44Qs/lrNpnHnnOc/wBo2Aoab32U5NnSp/2M0I82c1aXcVViXMHN0Jr3aScwZSdxV6njxnnZrdZ0LFSRUr2VyalWakU1C6xzUc4RWFSpQrGh8YiSMowBBpY1K3VJXQY2/wAVKla1ewni/wAmgVOoUdBVKaNZcjGKlSry8MY+ir4IAYbV7tFVZCMVKlcbeFWG9PiE9zDENvEblJ9O5/Sn5F5ECpgBRsPpUqVSYu5repBGyPPZxk9x+9Vo5Cl5jsTUqVZiuK8y00ooCWalSpRGgx//2Q==\",\n \"has_image\": true,\n \"blood_group\": \"\",\n \"vehicle_classes\": [\n \"MCWG\"\n ],\n \"less_info\": false,\n \"initial_doi\": null,\n \"current_status\": \"Active\"\n }\n}"},{"id":"b27d681a-72e3-4583-b26e-a8e2f551a7b8","name":"Verification failed - Invalid driving license number or DOB","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXXXX\",\r\n \"dob\": \"DD-MM-YYYY\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/driving-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"298"},{"key":"Date","value":"Mon, 08 Jul 2024 08:59:39 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_driving_license_v2_80nckOmpNDzveEyo8QUj\",\n \"timestamp\": 1720429012911,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid driving license number or DOB\",\n \"data\": null\n}"},{"id":"67f239aa-9e88-4163-aada-12e875092bd8","name":"Validation error - Invalid DOB format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXXXX\",\r\n \"dob\": \"DD-MM-YYYY\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/driving-license"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"298"},{"key":"Date","value":"Mon, 08 Jul 2024 08:59:39 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_driving_license_v2_EZ8qyYmA0OYiEeILXSkP\",\n \"timestamp\": 1720429039175,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid date of birth in DD-MM-YYYY format\",\n \"data\": null\n}"}],"_postman_id":"e5456691-d483-466e-ad9e-f8821b6a10f4"}],"id":"854fce06-0d64-42ab-8926-ef4d2526588f","description":"

What is Indian driving license (DL)?

In India, a driving licence is an official document that authorises its holder to operate various types of motor vehicles on highways and some other roads to which the public has access. In various Indian states, they are administered by the Regional Transport Authorities/Offices (RTA/RTO).

Driving License API is one of the documents widely used when it comes to Identity verification. The API extracts the Image, Name, DOB, Address, and few more details related to the Driving License. This API provides entire information about the Driving License by passing DL unique ID.

Format of Driving licence Number.

Total number of input characters should be exactly 16 (including space or '-').
The new DL format is mentioned below.
SS-RRYYYYNNNNNNN OR SSRR YYYYNNNNNNN where
- SS - Two character State Code (like RJ for Rajasthan, TN for Tamil Nadu etc)
- RR - Two digit RTO Code
- YYYY - 4-digit Year of Issue (For Example: If year is mentioned in 2 digits, say 99, then it should be converted to 1999. Similarly use 2012 for 12).
- Rest of the numbers are to be given in 7 digits. If there are less number of digits, then additional 0's(zeros) may be added to make the total 7.
\n

Driving Licence Categories and Class of Vehicles in India

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Licence Class	Vehicle Type
MC 50cc	Vehicles that have an engine capacity of 50cc or less than that.
LMV-NT	Vehicles like jeep and motor cars fall under the Light Motor Vehicle Category but these are of non-transport class.
FVG	Vehicles without gears fall under this category like scooters and mopeds
MC EX50CC	Vehicles like motorcycles with gears whose engine capacity is of 50CC or more.
MCWG	Vehicles like motorcycles both with and without gear fall under this category.
HGMV	Vehicles like trailers, larger trucks, and other similar vehicles used for transport of goods fall under the category of HGMV.
HPMV	Vehicles that runs for commercial purpose and has an All India Permit to carry passengers falls under the HPMV category.

","_postman_id":"854fce06-0d64-42ab-8926-ef4d2526588f"},{"name":"FaceTrace","item":[{"name":"Catalog","item":[{"name":"Create Catalog","id":"ad7ee7e8-6fad-4d95-9c4c-0c107f58f3fa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"collectionName\": \"test collection\",\r\n \"externalIdEnabled\": true,\r\n \"imageStorageAccess\": false\r\n}"},"url":"https://api.idcentral.io/idc/face-catalog","description":"

The Create Catalog API is utilized to establish an account-specific catalog, which functions as a virtual container for the facial features of customers or users.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1.	collectionName	String	Required	Preferred collection name
2.	externalIdEnabled	Boolean	Required	The allowable values for this parameter are \"true\" or \"false\". Set it to \"true\" only if the user intend to utilize customer's identifier for the purpose of identifying faces.
3.	imageStorageAccess	Boolean	Required	The allowable values for this parameter are \"true\" or \"false\". Please ensure that you set it to \"true\" only if the purpose of the evaluation and calibration is for catalogs containing less than 1000 faces.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	String	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response code	Status	Message	Error
When catalog is successfully created	200	1	success	Successful Request	null
When API fails to create catalog	400	-1	failed	Face Catalog is already created	Invalid Request

","urlObject":{"path":["face-catalog"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"dcc69ea9-9da9-4222-b687-6abb7cd2a97f","name":"Catalog created successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"collectionName\": \"test collection\",\r\n \"externalIdEnabled\": true,\r\n \"imageStorageAccess\": false\r\n}"},"url":"https://api.idcentral.io/idc/face-catalog"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:20:22 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670498421640,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_collection_1o9FAVdh5C\"\n}"},{"id":"55207082-8ee1-4727-8cdc-888d703d20a5","name":"Catalog already created","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"collectionName\": \"test collection\",\r\n \"externalIdEnabled\": true,\r\n \"imageStorageAccess\": false\r\n}"},"url":"{{base_url}}/face-catalog"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:17:17 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Catalog already created\",\n \"timestamp\": 1670498237131,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_bzEbJOSMLgkeLCkzshR4\"\n}"}],"_postman_id":"ad7ee7e8-6fad-4d95-9c4c-0c107f58f3fa"},{"name":"Delete Catalog","id":"894397cc-2f85-4796-8a96-5f1748751a5b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":"https://api.idcentral.io/idc/face-catalog","description":"

The \"Delete Catalog API\" is designed to delete the current catalog that is linked to your account. It is important to note that deleting the catalog will also result in the removal of all faces that are contained within the catalog.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	String	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	Response Code	Status	Message	Error
1.	When existing catalog is deleted	200	1	success	Successful Request	null
2.	When API fails to delete the catalog	400	-1	failed	Face Catalog is not created	Invalid Request

","urlObject":{"path":["face-catalog"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"57e0e53c-a3e5-4529-88ea-53cabc569ed1","name":"Success","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":"{{base_url}}/face-catalog"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:19:38 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"Successful Request\",\n \"message\": null,\n \"timestamp\": 1670926661345,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_delete_collection_uW4vuFjhUJzyloiuqXAF\"\n}"},{"id":"a9bdb46a-85d3-4626-b3d4-fb4b4c8a906d","name":"Failed","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":"{{base_url}}/face-catalog"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:20:11 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Face Catalog is not created\",\n \"timestamp\": 1670498410768,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_delete_collection_20CyXzzaVUg5dGKHcFHi\"\n}"}],"_postman_id":"894397cc-2f85-4796-8a96-5f1748751a5b"}],"id":"706d8610-2e11-4983-a941-aed910593401","description":"

Catalog is virtual collection of faces securely stores on cloud. These collection can be created and accessed by authrised person only. Client can create multiple catalogs and add faces to the catalogs.

\n","_postman_id":"706d8610-2e11-4983-a941-aed910593401"},{"name":"Face","item":[{"name":"Add Face","id":"52edad5f-653f-47ca-ab94-46ff18347bee","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"text","key":"externalImageId","value":"123"},{"type":"file","contentType":"image/jpeg","key":"files","value":null},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":"https://api.idcentral.io/idc/face-catalog/face","description":"

The Add Face API enables the addition of a face to the catalog, assuming it satisfies the specified criteria. Once a face has been added, a unique faceId is generated, which the client may utilize in conjunction with the Search Face and Delete Face APIs.

Supported Images:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, and png file formats as Input.
The file should be max 5 MB. Files above 5 MB files are not supported.
Image files with more than 1 face (eg. group photos) are not accepted.

Note: For improving the accuracy of face detection, this API includes an optional parameter known as \"Face Size Minimum Threshold\" that can be used to handle scenarios where images contain background images or tiny faces. The value of this parameter ranges from 0 to 1. If this parameter is not set, the default value of 0.1 is used.

Scenarios:

If there is more than one face detected but only one face has a height or width above the threshold H or W, the algorithm adds the face.
if there are at least two faces with a height or width above the threshold H or W, the algorithm rejects the image.

IMPORTANT

Use good quality photos. Avoid blurred & pixelated images, as they often don't give a high match score when you eventually search with a face (even if the face image used for search is of high quality).

In our bulk add mode, we offer the option to automatically reject photos of low quality.

Request:

Body:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1.	externalImageId	Integer	optional	If the catalog is enabled for externalImageID, a unique external ID is mandatory
2	files	File	Required	Image file
3	faceSizeThreshold	Double	Optional	It is the minimum face size
4	replace_face	String	Optional	The possible value can be either Y or N (not case sensitive).This parameter is used when the user provides an existing external_id along with an override flag, the existing face id linked to the external id will be deleted, and the new one will be added. Note: This parameter requires the externalImageId to be \"true\".

Response Detail:

S.No	Key	Data Type	Description
1.	data	Object	Data contains the detailed information received
1.1	faceId	String	Uniquely generated ID for each Image uploaded
1.2	fileName	String	Image file name
1.3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\", it confirms that the request has failed due to an error
1.4	reason	String	This field provides the reason for rejection if an image was not successfully uploaded to the catalog
1.5	file	String	Image details
1.6	externalImageId	Integer	Unique ID assigned to the image which is uploaded
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	Response Code	Status	Message	Error
1	When face is added successfully	200	1	success	Successful request	null
2	When Invalid input file format	200	1	success	Successful request	null
3.	When Invalid or Duplicate externalImageId	400	-1	failed	Please provide valid externalImageId	Invalid Request

","urlObject":{"path":["face-catalog","face"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"8b5d05ee-3d22-4e1a-8e56-2338771590b1","name":"Face added successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}],"body":{"mode":"formdata","formdata":[{"type":"text","key":"externalImageId","value":"12345"},{"type":"file","contentType":"image/jpeg","key":"files","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/1637181904671.jpg"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/face","protocol":"https","host":["api","idcentral","io"],"path":["idc","face-catalog","face"],"query":[{"key":"faceSizeThreshold","value":"0.1","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 11 Dec 2022 08:07:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"faceId\": \"aaedde4b-241a-457b-aa93-c016d0bc7861\",\n \"fileName\": \"1637181904671.jpg\",\n \"status\": \"success\",\n \"reason\": null,\n \"file\": null,\n \"externalImageId\": \"12345\"\n }\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670746025291,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_add_face_OjuNQduORYARgFGZ3uBb\"\n}"},{"id":"03eb4d6b-920d-48a5-9829-60e12bc384ec","name":"Invalid file format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}],"body":{"mode":"formdata","formdata":[{"type":"text","key":"externalImageId","value":"123456"},{"type":"file","contentType":"image/jpeg","key":"files","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/20210331_202952.webp"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/face?faceSizeThreshold=0.1","host":["https://api.idcentral.io/idc"],"path":["face-catalog","face"],"query":[{"key":"faceSizeThreshold","value":"0.1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 11 Dec 2022 08:07:35 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"faceId\": null,\n \"fileName\": \"20210331_202952.webp\",\n \"status\": \"failed\",\n \"reason\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). 20210331_202952.webp is not supported\",\n \"file\": null,\n \"externalImageId\": \"123456\"\n }\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670746054997,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_add_face_3Wsib6w9p7loJrck1bVb\"\n}"},{"id":"7294e1b3-8cdc-4a43-8d41-92bb215de57c","name":"Invalid External Image Id","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}],"body":{"mode":"formdata","formdata":[{"type":"text","key":"externalImageId","value":"1234"},{"type":"file","contentType":"image/jpeg","key":"files","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/1637181904671.jpg"]}]},"url":"https://api.idcentral.io/idc/face-catalog/face"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:22:33 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide valid externalImageId\",\n \"timestamp\": 1670498552789,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_add_face_9J5UPff5LVBUBxgwP2l2\"\n}"}],"_postman_id":"52edad5f-653f-47ca-ab94-46ff18347bee"},{"name":"Search Face","id":"36d7a80f-ea8a-4d86-b348-51d501e5ab3b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"image/jpeg","key":"file","src":"/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/face_mask_1.jpeg"},{"key":"faceSizeThreshold","value":"0.1","type":"text"},{"key":"threshold","value":"70","type":"text"}]},"url":"https://api.idcentral.io/idc/face-catalog/face-search","description":"

Search Face API takes a photo image as input, and searches for face(s) matching the given face in the catalog.

Supported Files:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, and png file formats as Input.
The file should be max 5 MB, more than 5 MB files are not supported.
Input images with more than 1 face aren't accepted.

Scenarios:

If there is more than one face detected but only one face has a height or width above the threshold H or W, the algorithm adds the face.
if there are at least two faces with a height or width above the threshold H or W, the algorithm rejects the image.

IMPORTANT

In our bulk add mode, we offer the option to automatically reject photos of low quality.

Request:

Body:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	file		Required	Image file that is to be searched in catalog.
2	faceSizeThreshold	Double	Optional	It's the minimum face size
3	threshold	Double	Mandatory	It's the search confidence threshold,(the search result confidence will be greater than or equal threshold )

IMPORTANT

The threshold is a critical parameter that significantly impacts the usability of the Face Trace system. A lower threshold value may result in the system identifying multiple similar-looking faces belonging to different individuals, while a very high threshold value (e.g., 99) may cause the system to miss matching photos of the same individual due to a low match score. Therefore, we suggest that the user calibrate and set thresholds based on the specific use case.

When the user initially integrates the Search function, it is recommended that you start with a threshold of 95 and evaluate both the false positives and false negatives. False positives are similar-looking faces that do not necessarily belong to the same person, while false negatives are the same person's faces that generate a score below the threshold. A threshold of 98-99 implies strict search behavior, aiming to identify only faces that have an extremely close match to an existing face in the catalog.

To achieve accurate results, it is crucial to use high-quality photos when adding and searching for faces. Low-quality or pixelated images will result in a lower score, thereby failing to return results even if the photos belong to the same person.

On average, our clients use a threshold score of 96.5.

Definition:

similarity: Similarity refers to the process of computing a numerical similarity score between two face templates to ascertain whether there is a match or no-match. The score ranges from 0 to 100, with higher scores indicating greater similarity between the two faces.

Response:

S.No	Key	Data Type	Description
1	data	Object	Search Face API result
1.1	similarity	Float	Refer: Similarity definition
1.2	face	Object	The information associated with the searched Face.
1.2.1	faceId	String	The Face ID of the searched Face from the catalog.
1.2.2	boundingBox	Object	The Coordinates information of the face image.
1.2.2.1	width	float	width of the face image
1.2.2.2	height	float	Height of the face from the catalog
1.2.2.3	left	float	Left of the face image from the catalog
1.2.2.4	top	float	Top of the face image from the catalog
1.2.3	imageId	String	The unique ID of the image file. It is assigned when image was being uploaded to the catalog
1.2.4	externalImageId	String	Refer: ExternalImageId definition
1.2.5	confidence	float	Refer: Confidence definition
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
4	response_code	Integer	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status Code	Response Code	Status	Message	Error
1.	When uploaded image matches image from the catalog	200	1	success	Successful Request	null
2.	When uploaded image doesn't found in the catalog	200	1	success	Successful Request	null
3	When API fails to search uploaded image in catalog	400	-1	failed	File is mandate, Please provide image file (jpeg, jpg, jpe, jif, jfif, jfi, and png)20210331_202952.webp is not supported	Invalid Request

","urlObject":{"path":["face-catalog","face-search"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"cd051db9-7c89-4893-97b9-c32b73535374","name":"Face Found","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"image/jpeg","key":"file","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/face_mask_1.jpeg"]},{"key":"threshold","value":"70","type":"text"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/face-search?threshold=95&faceSizeThreshold=0.1","protocol":"https","host":["api","idcentral","io"],"path":["idc","face-catalog","face-search"],"query":[{"key":"threshold","value":"95"},{"key":"faceSizeThreshold","value":"0.1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:27:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"similarity\": 100,\n \"face\": {\n \"faceId\": \"94a4ebdf-2f38-4fc1-88cb-7485a13d426a\",\n \"boundingBox\": {\n \"width\": 0.403085,\n \"height\": 0.529223,\n \"left\": 0.310831,\n \"top\": 0.194383\n },\n \"imageId\": \"3b32ca10-2645-3631-be6b-341bc7c8ac59\",\n \"externalImageId\": \"1234\",\n \"confidence\": 99.9999\n }\n }\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670498839554,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_search_face_YvaWqunhbYXohA52mMRK\"\n}"},{"id":"b70a463f-7b43-49e7-b0bf-360b5369fd05","name":"Face Not Found","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"image/jpeg","key":"file","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/face_mask_1.jpeg"]},{"key":"threshold","value":"70","type":"text"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/face-search?threshold=80&faceSizeThreshold=0.1","host":["https://api.idcentral.io/idc"],"path":["face-catalog","face-search"],"query":[{"key":"threshold","value":"80"},{"key":"faceSizeThreshold","value":"0.1"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:27:58 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670498878443,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_search_face_J8qj6Hpni63F2056ltfx\"\n}"},{"id":"88ab2124-84d5-4a7e-af85-e56a6bdc5184","name":"Failed","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"image/jpeg","key":"file","src":["/C:/Users/abhishek.konkal/Downloads/idrnd(selfie)/20210331_202952.webp"]},{"key":"threshold","value":"70","type":"text"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/face-search?threshold=80&faceSizeThreshold=0.1","host":["https://api.idcentral.io/idc"],"path":["face-catalog","face-search"],"query":[{"key":"threshold","value":"80"},{"key":"faceSizeThreshold","value":"0.1"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 11 Dec 2022 08:22:00 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"file is mandate, Please provide image file (jpeg, jpg, jpe, jif, jfif, jfi, and png)20210331_202952.webp is not supported\",\n \"timestamp\": 1670746920686,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_search_face_J9hVPAYQlwyt8ucFJ3cj\"\n}"}],"_postman_id":"36d7a80f-ea8a-4d86-b348-51d501e5ab3b"},{"name":"Delete Face By External Image ID","id":"d0815f83-c0bd-48f0-8d29-c794b78fa7fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"formdata","formdata":[{"key":"externalImageId","value":"1234","type":"text"}]},"url":"https://api.idcentral.io/idc/face-catalog/face/imageId","description":"

The \"Delete Face API\" enables the user to remove a face or customer from the catalog. The \"externalImageId\" is generated when an image is added to the face catalog and represents a unique identifier associated with each image.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1.	externalImageId	String	Required	Unique external ID

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	String	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message	error
1	When face is successfully deleted from the catalog	200	1	success	Successful Request	null
2	When user tries to delete the face and it fails	400	-1	failed	Invalid ExternalImageId	Invalid Request

","urlObject":{"path":["face-catalog","face","imageId"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"05cfd863-813d-4a81-8107-ba61ed99f9ac","name":"Success","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"externalImageId","value":"1234","type":"text"}]},"url":"{{base_url}}/face-catalog/face/imageId"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:35:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670499304387,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"\"\n}"},{"id":"bd4ef5dc-3a6c-4c3c-86ed-886b8dd69076","name":"Failed","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"body":{"mode":"formdata","formdata":[{"key":"externalImageId","value":"123456","type":"text"}]},"url":"{{base_url}}/face-catalog/face/imageId"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 11:34:20 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Invalid ExternalImageId\",\n \"timestamp\": 1670499259784,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_remove_face_kKUAuCfGwIzFEog254Ls\"\n}"}],"_postman_id":"d0815f83-c0bd-48f0-8d29-c794b78fa7fc"},{"name":"Delete Face By FaceID","id":"8294f381-eab3-457c-a876-b13a565272fd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":"https://api.idcentral.io/idc/face-catalog/face?faceIds=94a4ebdf-2f38-4fc1-88cb-7485a13d426a","description":"

\"Delete Face By FaceID\" API enables the deletion of faces from the catalog based on their face ID, which is a uniquely generated identifier assigned to each image that is added to the catalog. Each successfully added image will have a unique face ID.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	faceIds	Param	Required	Unique faceId

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	data	Object	Data contains the detailed information received
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	String	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message	error
1	When face is successfully deleted from the catalog	200	1	success	Successful Request	null
2	When faceId is invalid	400	-1	failed	Invalid faceID [faceId]	Invalid Request

","urlObject":{"path":["face-catalog","face"],"host":["https://api.idcentral.io/idc"],"query":[{"key":"faceIds","value":"94a4ebdf-2f38-4fc1-88cb-7485a13d426a"}],"variable":[]}},"response":[{"id":"a59a49af-36aa-44fe-9b21-3059374d189f","name":"Success","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":{"raw":"{{base_url}}/face-catalog/face?faceIds=aaedde4b-241a-457b-aa93-c016d0bc7861","host":["{{base_url}}"],"path":["face-catalog","face"],"query":[{"key":"faceIds","value":"aaedde4b-241a-457b-aa93-c016d0bc7861"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 11 Dec 2022 08:29:30 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n \"aaedde4b-241a-457b-aa93-c016d0bc7861\"\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670747369326,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_remove_face_rikNPFdgvSni10VoJ3V0\"\n}"},{"id":"d0339dc7-4383-4e2b-abf6-81775f725966","name":"Invalid FaceID","originalRequest":{"method":"DELETE","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{api_key}}"}],"url":{"raw":"{{base_url}}/face-catalog/face?faceIds=1234","host":["{{base_url}}"],"path":["face-catalog","face"],"query":[{"key":"faceIds","value":"1234"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 09 Dec 2022 04:20:41 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Invalid faceID [1234]\",\n \"timestamp\": 1670559641377,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"facecatalog_remove_face_PKRPsek9IDHzjG16IURq\"\n}"}],"_postman_id":"8294f381-eab3-457c-a876-b13a565272fd"}],"id":"280a133d-0b7e-4964-b939-c1cc2f7e2e6e","_postman_id":"280a133d-0b7e-4964-b939-c1cc2f7e2e6e","description":""},{"name":"Face Bulk Upload","item":[{"name":"Bulk Upload using AWS S3","item":[{"name":"Bulkupload using AWS S3 mode","id":"48d7fba6-8241-4bdc-b6dd-04d969418cc2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"connectionDtails\": {\r\n \"hostname\": \"string\",\r\n \"password\": \"string\",\r\n \"path\": \"string\",\r\n \"port\": 22,\r\n \"userName\": \"string\"\r\n },\r\n \"extrnalIdEnabled\": true,\r\n \"qualityFilter\": \"auto\",\r\n \"s3Upload\": true,\r\n \"s3Url\": \"s3://facetrace/\",\r\n \"faceSizeThreshold\": \"0.1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload","description":"

In this mode, the organization provides the path to the AWS S3 storage along with connection details and other required parameters mentioned in the API request. With this API, the images are retrieved from the AWS S3 storage and added to the created catalog.

Below is the prerequisite.

extrnalIdEnabled key should have been marked as false when the catalog was created.
imageStorageAccess key should have been marked as true when the catalog was created.

Definition

externalImageID: This field is required only if the catalog is enabled to use your own identifier. Additionally, this field must be unique for each face that is being added to the catalog.
\n
imageStorageAccess: This is required if you are using this for evaluation and calibration for catalogs with <1000 faces.
\n

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	connectionDtails	String	Required	Connection details required to setup connection is storage
1.1	hostname	String	Required	HOST name details
1.2	password	String	Required	Password to the HOST name
1.3	path	String	Required	Path to the file storage
1.4	port	Integer	Required	Access Port details
1.5	userName	String	Required	Username of the authorised person
2	extrnalIdEnabled	Boolean	Required	Refer: extrnalIdEnabled definition
3	qualityFilter	String	Required	Quality filter details. Default 'auto'
4	s3Upload	Boolean	Required	This field indicates whether access to the uploaded AWS S3 file should be granted or not. The possible values are \"true\" and \"false\"
5	s3Url	String	Required	Refer: AWS S3 definition
6	faceSizeThreshold	Double	Optional	It's the minimum face size

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	data	Object	Data contains the detailed information received
1.1	uploadId	String	It is a unique generated ID for the batch of images which are uploaded to the catalog
1.2	fileCount	Integer	It is the count files uploaded to the catalog
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message
1	When files have been uploaded successfully	200	1	success	Successful Request
2	When ImageStorageAccess is flagged as true when catalog was created	-1	-1	failed	Bulk Upload is availabe for only Face Catlog which has ImageStorageAccess is FALSE
3	When externalImageID is flagged as true when catalog was created	-1	-1	failed	This Bulk Upload is availabe for only Face Catlog which has ExternalID is Disabled
4	Any other mismatch error	200	9

","urlObject":{"path":["face-catalog","upload"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"0a33bb89-7a55-4bb8-bf64-2d20c0deb4ec","name":"Files Uploaded Successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{token}}","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"connectionDtails\": {\r\n \"hostname\": \"string\",\r\n \"password\": \"string\",\r\n \"path\": \"string\",\r\n \"port\": 22,\r\n \"userName\": \"string\"\r\n },\r\n \"extrnalIdEnabled\": true,\r\n \"qualityFilter\": \"auto\",\r\n \"s3Upload\": true,\r\n \"s3Url\": \"s3://facetrace/\",\r\n \"faceSizeThreshold\": \"0.1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:13:23 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"uploadId\": \"4e2a50c9-5d38-42a8-ba38-f5XXXXXXXXXX\",\n \"fileCount\": 57\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1672388002981,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_collection_bpSSD8YOdaXXXXXXXXXX\"\n}"},{"id":"09c1ce12-50a7-4e4b-963c-82bb3f6411c1","name":"ImageStrorageAccess is enabled","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer {{token}}","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"connectionDtails\": {\r\n \"hostname\": \"string\",\r\n \"password\": \"string\",\r\n \"path\": \"string\",\r\n \"port\": 22,\r\n \"userName\": \"string\"\r\n },\r\n \"extrnalIdEnabled\": true,\r\n \"qualityFilter\": \"auto\",\r\n \"s3Upload\": true,\r\n \"s3Url\": \"s3://facetrace/\",\r\n \"faceSizeThreshold\": \"0.1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:10:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Bulk Upload is availabe for only Face Catlog which has ImageStorageAccess is FALSE\",\n \"timestamp\": 1672387830570,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_QBYa0xCpzye9XqttO7mp\"\n}"},{"id":"0889faa3-6fbd-4baa-ae96-428de9c58063","name":"ExternalImageID is disabled","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Bearer ","type":"text","disabled":true}],"body":{"mode":"raw","raw":"{\r\n \"connectionDtails\": {\r\n \"hostname\": \"string\",\r\n \"password\": \"string\",\r\n \"path\": \"string\",\r\n \"port\": 22,\r\n \"userName\": \"string\"\r\n },\r\n \"extrnalIdEnabled\": false,\r\n \"qualityFilter\": \"auto\",\r\n \"s3Upload\": true,\r\n \"s3Url\": \"s3://facetrace/\",\r\n \"faceSizeThreshold\": \"0.1\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:39:23 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"This Bulk Upload is availabe for only Face Catlog which has ExternalID is Disabled\",\n \"timestamp\": 1672389563889,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_lFvjlGqe6vWdW4CvThRz\"\n}"}],"_postman_id":"48d7fba6-8241-4bdc-b6dd-04d969418cc2"},{"name":"BulkUpload Using CSV file","id":"282d71a7-13a7-4560-b81f-fe1e431875ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":"/C:/Users/bhanupriya.r/Downloads/Sample csv.csv"},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","description":"

In this mode of uploading files to the catalog, unique external image ID is assigned to the each image file. In this mode, a catalog should have extranlImageId key enabled. Organization prepare a file in a .csv format with below mentioned column names.

path : AWS S3 path URL of all image from the AWS S3 storage
externalImageId: Unique Identified to all the uploaded which are being uploaded

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	file	file	Required	File with `.csv` format containg AWS S3 path urls and externalImageId assigned
2	faceSizeThreshold	Double	Optional	It's the minimum face size

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	data	Object	Information about uploaded files to catalog
1.1	uploadId	String	It is unique generated ID for the batch of images which have been uploaded to the catalog
1.2	fileCount	Integer	It is the count files uploaded to the catalog
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message	error
1	When files have been uploaded successfully	200	1	success	Successful Request
2	When ImageStorageAccess is flagged as true when catalog was created	-1	-1	failed	Bulk Upload is availabe for only Face Catlog which has ImageStorageAccess is FALSE
3	When externalImageID is flagged as true whe catalog was created	-1	-1	failed	This Bulk Upload is availabe for only Face Catlog which has ExternalID is Disabled
4	When catalog is not created	-1	-1	failed	Face Catalog is not created	Face Catalog is not created
5	When invalid CSV file is uploaded	400	-1	failed	Please provide the valid CSV file
6	Any other mismatch error	200	9

","urlObject":{"path":["face-catalog","upload","csv"],"host":["https://api.idcentral.io/idc"],"query":[{"key":"qualityFilter","value":"AUTO"}],"variable":[]}},"response":[{"id":"2853fba2-7062-4e86-9cc3-4a9b74058469","name":"Files uploaded successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":["/C:/Users/prashant.bharam/Downloads/Sample csv.csv"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","host":["https://api.idcentral.io/idc"],"path":["face-catalog","upload","csv"],"query":[{"key":"qualityFilter","value":"AUTO"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:45:29 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"uploadId\": \"7e92c11f-5155-4061-85cb-c16740bf3a1f\",\n \"fileCount\": 50\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1672389929511,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"facecatalog_collection_QML1EfMzeXeo6gwP7kHL\"\n}"},{"id":"cc4f0d1d-be6c-4311-8868-6e86ca87e317","name":"ExternalID is marked as false","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":["/C:/Users/prashant.bharam/Downloads/Sample csv.csv"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","host":["https://api.idcentral.io/idc"],"path":["face-catalog","upload","csv"],"query":[{"key":"qualityFilter","value":"AUTO"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:35:48 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"This Bulk Upload is availabe for only Face Catlog which has ExternalID is Enabled\",\n \"timestamp\": 1672389349015,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_3Elh7FX9KsB603XGsYib\"\n}"},{"id":"79b7bbf3-ff11-4990-983e-07ef44b5a96f","name":"CSV file not uploaded","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":[]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","host":["https://api.idcentral.io/idc"],"path":["face-catalog","upload","csv"],"query":[{"key":"qualityFilter","value":"AUTO"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:42:56 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid CSV file\",\n \"timestamp\": 1672389776763,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_zir5wKN2Dz3xcsyGrqyX\"\n}"},{"id":"9155199c-13a0-448e-a57a-7e41658be7df","name":"face catalog is not created","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":["/C:/Users/prashant.bharam/Downloads/Sample csv.csv"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","host":["https://api.idcentral.io/idc"],"path":["face-catalog","upload","csv"],"query":[{"key":"qualityFilter","value":"AUTO"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:43:24 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Face Catalog is not created\",\n \"timestamp\": 1672389804188,\n \"error\": \"Face Catalog is not created\",\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_RtYviM9AvzsB9oE5vZWw\"\n}"},{"id":"09436afc-fe00-4d7d-aea1-b51786ace768","name":"When Image Storage Access is True","originalRequest":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"api-key","value":"{{apikey}}"},{"key":"parallelThread","value":"8"}],"body":{"mode":"formdata","formdata":[{"type":"file","contentType":"text/csv","key":"file","src":["/C:/Users/prashant.bharam/Downloads/Sample csv.csv"]},{"key":"faceSizeThreshold","value":"0.1","type":"text"}]},"url":{"raw":"https://api.idcentral.io/idc/face-catalog/upload/csv?qualityFilter=AUTO","host":["https://api.idcentral.io/idc"],"path":["face-catalog","upload","csv"],"query":[{"key":"qualityFilter","value":"AUTO"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 30 Dec 2022 08:44:10 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Bulk Upload is availabe for only Face Catlog which has ImageStorageAccess is FALSE\",\n \"timestamp\": 1672389850756,\n \"error\": null,\n \"success\": false,\n \"txn_id\": \"facecatalog_collection_GF5eanp3avAnXRzESTDg\"\n}"}],"_postman_id":"282d71a7-13a7-4560-b81f-fe1e431875ac"}],"id":"7b53753c-9df5-4e18-9385-908135196716","_postman_id":"7b53753c-9df5-4e18-9385-908135196716","description":""},{"name":"BulkUpload Using SFTP Mode","id":"c634d5ab-032c-48c5-af95-2bc63f5dd6be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"connectionDtails\": {\n \"hostname\": \"3.145.142.83\",\n \"password\": \"gowthami\",\n \"path\": \"/home/gowthami/images/face_80\",\n \"port\": \"22\",\n \"userName\": \"gowthami\"\n },\n \"qualityFilter\": \"HIGH\"\n /*\"uploadId\": \"xxxxxxx\"*/\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload","description":"

In this mode, organizations can upload the image files to the catalog using SFTP file transfer mode. In this mode, file stored on the SFTP server or on local storage of computer machine will be imported to the catalog. Whitelisting of URLs, IPs and other client details may be required.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	connectionDtails	String	Required	Connection detalis required to setup connection is host
1.1	hostname	String	Required	HOST name details
1.2	password	String	Required	Password to the HOST name
1.3	path	String	Required	Path to the file storage
1.4	port	Integer	Required	Access Port details
1.5	userName	String	Required	Username of the authorised person
2	qualityFilter	String	Required	Quality fileter details. Default 'auto'

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	data	Object	Information about upoded files to catalog
1.1	uploadId	String	It is unique generated ID for the batch of images which have been uploaded to the catalog
1.2	fileCount	Integer	It is the count files uploaded to the catalog
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message
1	When files have been uploaded successfully	200	1	success	Successful Request
2	When ImageStorageAccess is flagged as true when catalog was created	-1	-1	failed	Bulk Upload is availabe for only Face Catlog which has ImageStorageAccess is FALSE
3	When externalImageID is flagged as true whe catalog was created	-1	-1	failed	This Bulk Upload is availabe for only Face Catlog which has ExternalID is Disabled
4	Any other mismatch error	200	9

","urlObject":{"path":["face-catalog","upload"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"e985728f-5efd-4742-95a9-27544d0e0fbd","name":"bulkUpload - Successful senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"connectionDtails\": {\n \"hostname\": \"3.145.142.83\",\n \"password\": \"gowthami\",\n \"path\": \"/home/gowthami/images/face_80\",\n \"port\": \"22\",\n \"userName\": \"gowthami\"\n },\n \"qualityFilter\": \"HIGH\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/face-catalog/upload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status_code\": 1,\n \"timestamp\": 1643952159741,\n \"data\": {\n \"uploadId\": \"ad8c962c-aab1-4544-a4ce-853687f4fdab\",\n \"fileCount\": 82\n },\n \"error\": null,\n \"message\": \"Successful Request\",\n \"txn_id\": \"\"\n}"},{"id":"2199b999-9aae-49bc-b55e-675342327427","name":"bulkUpload - Invalid Request","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"connectionDtails\": {\n \"hostname\": \"3.145.142.83\",\n \"password\": \"gowthami\",\n \"path\": \"/home/gowthami/images/face_80\",\n \"port\": \"22\",\n \"userName\": \"gowthami\"\n },\n \"qualityFilter\": \"HIGH\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/face-catalog/upload"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"status_code\": -1,\n \"timestamp\": 1643952590165,\n \"data\": null,\n \"error\": \"Invalid Path\",\n \"message\": null,\n \"txn_id\": \"\"\n}"}],"_postman_id":"c634d5ab-032c-48c5-af95-2bc63f5dd6be"},{"name":"getStatus","id":"142c2473-1d16-4d73-92de-e056eb880a51","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"uploadId\": \"bbe2e494-b1d0-4f79-a4cc-25714e0d08c2\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/face-catalog/upload/status","description":"

Get Status API is used to know the status of the bulk upload. The unieqly generated uploadId needs to be passed to know the status.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Required	Description
1	uploadId	String	Required	Uniquely generated uploadId when bulk upload of images was being performed

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	data	Object	Status about upoded files to catalog
1.1	processedFileCount	Integer	Successfully processed and uploaded files / images to the catalog count
1.2	totalFileCount	Integer	Total file/images to be uploaded
1.3	status	Integer	Percentage completion of the bulk upload
1.4	uploadStatus	String	If confirms the status of the bulok upload activity. Possible values `COMPLETED` if all uploaded file have been successfully uploaded to the catalog and `IN_PROGRESS` if bulk upload to the catalog is still in progress.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Scenario	Status Code	response Code	status	message
1	When file upload status is 'COMPLETED'	200	1	success	Successful Request
2	When file upload status is 'IN_PROGRESS'	200	1	success	Successful Request
3	Any other mismatch error	200	9

","urlObject":{"path":["face-catalog","upload","status"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"82811f13-4e31-42f0-9d55-3277e726245f","name":"getStatus - Status in Process","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"uploadId\": \"ad8c962c-aab1-4544-a4ce-853687f4fdab\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/face-catalog/upload/status"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": 1,\r\n \"timestamp\": 1643952789208,\r\n \"data\": {\r\n \"processedFileCount\": 61,\r\n \"totalFileCount\": 82,\r\n \"uploadStatus\": \"IN_PROGRESS\"\r\n },\r\n \"error\": null,\r\n \"message\": \"Successful Request\",\r\n \"txn_id\": \"\"\r\n}"},{"id":"284a93e0-b23f-4300-897c-0be5149823e1","name":"getStatus - Completed status","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"uploadId\": \"ad8c962c-aab1-4544-a4ce-853687f4fdab\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/face-catalog/upload/status"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": 1,\r\n \"timestamp\": 1643952753050,\r\n \"data\": {\r\n \"processedFileCount\": 82,\r\n \"totalFileCount\": 82,\r\n \"uploadStatus\": \"COMPLETED\"\r\n },\r\n \"error\": null,\r\n \"message\": \"Successful Request\",\r\n \"txn_id\": \"\"\r\n}"},{"id":"88fa5205-8223-4956-a862-27b48b3e62af","name":"Bad Request","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"uploadId\": \"ad8c962c-aab1-4544-a4ce-853687f4fdab\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/face-catalog/upload/status"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": -1,\r\n \"timestamp\": 1643952800406,\r\n \"data\": null,\r\n \"error\": \"Input Error\",\r\n \"message\": \"Invalid Upload Id\",\r\n \"txn_id\": \"\"\r\n}"}],"_postman_id":"142c2473-1d16-4d73-92de-e056eb880a51"}],"id":"df0fffa1-0184-46ca-8858-3142d111e4c5","description":"

What purpose does bulk upload serve?

FaceTrace enables businesses, security organizations, and government agencies to rapidly and accurately identify faces across vast databases without incurring substantial integration costs. To serve this purpose, organizations must be capable of uploading images in bulk to maintain an up-to-date image repository. IDcentral's Bulk Image Upload API facilitates bulk image uploads to S3 storage for organizations.

IDcentral offers two modes for organizations to upload image files in bulk.

Bulk Upload using SFTP mode
Bulk Upload using AWS S3

Definitions

AWS S3: Amazon S3 (Simple Storage Service) offers object storage, which is designed for storing and retrieving any volume of data or information from any location over the internet via a web services interface. It is capable of storing computer files up to 5 terabytes in size. In our case, the image files will be stored in a hash format within the created catalog. The AWS S3 URL represents a pre-signed path for the object in the created catalog on AWS S3.
\n
SFTP Mode: SFTP (SSH File Transfer Protocol) is a secure file transfer protocol that operates over the SSH protocol. It supports the complete security and authentication capabilities of SSH, including protection against password sniffing and man-in-the-middle attacks. SFTP ensures data integrity through encryption and cryptographic hash functions, and provides authentication for both the server and the user.
\n

\n","_postman_id":"df0fffa1-0184-46ca-8858-3142d111e4c5"}],"id":"f9473749-92ce-4daf-aa62-26ff6385a114","description":"

What is Face Trace?

Face Trace is an AI driven product that allows you to search customers or users by facial biometrics. Typically this is used to identify black-listed customers who try to sign-up with new documents. It's also used to identify customers who would create new accounts to benefit from promotions targeted at new customers.

Definitions:

Catalog: Catalog is a virtual collection of faces. Note that we don't store the actual face images. The images are converted into a hash, which is used to match faces. A catalog supports millions of faces.

faceid: This is the identifier generated by our product for every face image added to the catalog.

externalImageID: This is required only if the catalog is enabled to use your own identifier. This field is required to be unique for each face being added to the catalog.

imageStorageAccess: This is required if you are using this for evaluation and calibration for catalogs with <1000 faces.

APIs

Following are the API services that support the integration of Face Trace into your application.

Create Catalog
Delete Catalog
Add Face
Search Face
Delete Face by External Image ID
Delete Face by faceid

\n","event":[{"listen":"prerequest","script":{"id":"cec5548a-a606-461c-97d4-6d859c686862","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"03a99e15-fb6f-4289-ab7f-b048da14a1b2","type":"text/javascript","exec":[""]}}],"_postman_id":"f9473749-92ce-4daf-aa62-26ff6385a114"},{"name":"Face Biometrics","item":[{"name":"Face Match","id":"ed735426-3403-4a51-b9fd-dc26d508cc6d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match","description":"

The Face Match API allows you to compare two facial images. This API accepts the image file and document file in the form of either a URL linking to an image or a base64-encoded image or document. You can upload these two files in the supported format, and the API will provide a similarity score. The similarity score reflects the probability that the images depict the same individual, with a higher score signifying a greater degree of similarity between the faces.

Supported file format and other details:

In this Face Match API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
Max faces in a frame: 1.
File size should not exceed 5 MB.

Note - This API accepts any combination of document & photo formats

Request: The request has to be passed in body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_url or id_document_base64	String	Required	Document image in the form URL or Base 64 Note - If User wants to give the URL in input, id_document_url should be used and if User wants to give the base 64 in input, id_document__base64 should be used
2	photo_url or photo_base64	String	Required	Selfie/photo image in the form URL or Base 64 Note - If User wants to give the URL in input, iphoto_url should be used and if User wants to give the base 64 in input, photo__base64 should be used
3	face_match_threshold	Decimal	Optional	Threshold set for similarity score which ranges from 0 to 100. (Default value is set to 85)
4	face_size_threshold	Decimal	Optional	Minimum face size which ranges from 0 to 1. (Default value is set to 0.1)

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched from Liveness check
1.1	similarity	Float	Similarity score of image fetched from the document and the photo uploaded

Scenarios Covered

Scenario	Status Code	Response Code	Status	Message	Error
Successful Scenario	200	1	success	Successful Request
Face match failed. Faces don't match as per the given threshold.	200	2	success	Face match failed. Faces don't match as per the given threshold.	Verification failed
Multiple Faces Found in [Document] / [Photo]	200	3	success	Multiple Faces Found in [Document] / [Photo]	Verification failed
No Faces Found in [Document] / [Photo]	200	4	success	No Faces Found in [Document] / [Photo]	Verification failed
Invalid Image Format (for base 64)	200	5	success	Invalid Image Format.	Verification failed
All other mismatch errors	200	9
Invalid format (for URL)	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).	Validation failed
Invalid Image Base64 format	400	-1	failed	Invalid Image Base64 format	Validation Failed
Conflicting Input Types	400	-1	failed	Conflicting Input Types	Validation Failed
Photo_url not accessible	400	-1	failed	Image URL Unreachable	Validation Failed
Invalid Image URL format	400	-1	failed	Invalid Image URL format	Validation Failed
Invalid image format	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).	Validation Failed
Invalid size	400	-1	failed	File exceeds maximumm file size 5000000 bytes and %s size is %s	Validation Failed

","urlObject":{"path":["v2","face-match"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"6db7e387-f9dd-41bf-a249-dc2a521b3b7b","name":"Successful Scenario (URL)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_SIpLubuAbgCOcjV0Qp9e\",\n \"timestamp\": 1693985793523,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"similarity\": 100.0\n }\n}"},{"id":"fd89a44d-13ff-4edc-9021-5402459f963c","name":"Successful Scenario (Base 64)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_base64\":\"{{id_document_base64}}\",\r\n \"photo_base64\": \"{{photo_base64}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985793523,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"similarity\": 100.0\n }\n}"},{"id":"3a5ab62b-c1ae-4da7-86de-aebc7a18f7f3","name":"Conflicting Input Formats","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985300489,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Conflicting Input Types\",\n \"data\": null\n}"},{"id":"b0957634-b7a9-40b7-a63f-5569695da2b5","name":"Invalid Image Base64 format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985228154,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid Image Base64 format\",\n \"data\": null\n}"},{"id":"9b9ef164-ea6d-4c92-8db4-8cfdb5afec18","name":"Invalid Image URL format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985144432,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid Image URL format\",\n \"data\": null\n}"},{"id":"142c9458-cfca-4e9b-8031-6d18e8c1b6b7","name":"Image URL Unreachable","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985472072,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Image URL Unreachable\",\n \"data\": null\n}"},{"id":"acd6d751-ea66-4476-9ad3-a900bcd2a09d","name":"Unsupported Image File","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985611426,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).\",\n \"data\": null\n}"},{"id":"966bc01f-ebc6-457d-8430-c47e963696cf","name":"File exceeds the maximum file size","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985731579,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"File exceeds maximumm file size 5000000 bytes and Document size is 6614340\",\n \"data\": null\n}"},{"id":"29b39353-0f8d-4a8c-86d0-0a1968fd0c0b","name":"Failure Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985835486,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Face match failed. Faces don't match as per the given threshold.\",\n \"data\": {\n \"similarity\": 0.32688943\n }\n}"},{"id":"aad627ee-e832-4db4-9c5a-c8a1e420c866","name":"Multiple Faces Found in [Document] / [Photo]","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693989996823,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"Multiple Faces Found in Document.\",\n \"data\": null\n}"},{"id":"6e2b840e-420a-4a37-9375-2a0b2e363487","name":"No Faces Found in [Document] / [Photo]","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985860107,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 4,\n \"error\": \"Verification failed\",\n \"message\": \"No Faces Found in Document.\",\n \"data\": null\n}"},{"id":"53fdf416-16cd-4149-bac0-7ba9089383ab","name":"Invalid Image Format.","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_document_url\":\"{{document_url}}\",\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"face_match_threshold\": 85,\r\n \"face_size_threshold\": 0.1\r\n}"},"url":"https://api.idcentral.io/idc/v2/face-match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 08 Sep 2023 07:13:13 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"face_match_v2_u9P3TubQb6Mrgu4kuAy\",\n \"timestamp\": 1693985517096,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"Verification failed\",\n \"message\": \"Invalid Image Format.\",\n \"data\": null\n}"}],"_postman_id":"ed735426-3403-4a51-b9fd-dc26d508cc6d"},{"name":"Face Extraction","id":"4b53090a-cb5a-40a0-b27d-3330a6f2e1be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/logo-social.png"}]},"url":"https://api.idcentral.io/idc/onboarding/face/extract","description":"

What is Face Extraction?

Face extraction is a computer technology that locates and determines the size of a human face within digital images. It is a fundamental process for all facial analysis algorithms, such as face alignment, face recognition, face verification, and face parsing. The Face Extraction API provided by IDcentral allows you to extract human faces from the image or document that you provide.

Supported file format and other details:

In this Face Match API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
Max faces in a frame: 1.
File size should not be greater 5 MB.
Image shouldn't be compressed.

Request: The request has to be passed in form-data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_image	file	Required	Image of the document file from which the user wants to extract a face image

Response: Successful response returns the image file in JPG format.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When face is successfully extracted from the document	-	-	-	Note: Successful response returns the image file in JPG format.
When face is not detected from the uploaded document	400	-1	failed	Unable to find the face corrds from the requested document, please provide the valid document to exact the face	Invalid Document
Uploaded document's type is not supported	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). Releiving letter.pdf is not supported	Invalid Document
When uploaded document type size is more than 5 MB	400	-1	failed	File exceeds maximum file size 5000000 bytes and DSC00203.JPG size is 21233664	Invalid Document
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","face","extract"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"ab2974b7-6e8e-4227-b543-d9964c05748a","name":"Face Extracted Successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/DL- ID.jpg"]}]},"url":"https://api.idcentral.io/idc/idc/onboarding/face/extract"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"��\u0010JFIF\u0001\u0001\u0001\u0001��C\b\u0006\u0006\u0007\u0006\u0005\b\u0007\u0007\u0007 \b \f\u0014 \f\u000b\u000b\f\u0019\u0012\u0013\u000f\u0014\u001d\u001a\u001f\u001e\u001d\u001a\u001c\u001c $.' \",#\u001c\u001c(7),01444\u001f'9=82<.342��C\u0001 \f\u000b\f\u0018 \u00182!\u001c!22222222222222222222222222222222222222222222222222��\u0011\bUT\u0003\u0001\"\u0002\u0011\u0001\u0003\u0011\u0001��\u001f\u0001\u0005\u0001\u0001\u0001\u0001\u0001\u0001\u0001\u0002\u0003\u0004\u0005\u0006\u0007\b \u000b��\u0010\u0002\u0001\u0003\u0003\u0002\u0004\u0003\u0005\u0005\u0004\u0004\u0001}\u0001\u0002\u0003\u0004\u0011\u0005\u0012!1A\u0006\u0013Qa\u0007\"q\u00142��\b#B��\u0015R��$3br� \u0016\u0017\u0018\u0019\u001a%&'()*456789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz��\u001f\u0001\u0003\u0001\u0001\u0001\u0001\u0001\u0001\u0001\u0001\u0001\u0001\u0002\u0003\u0004\u0005\u0006\u0007\b \u000b��\u0011\u0002\u0001\u0002\u0004\u0004\u0003\u0004\u0007\u0005\u0004\u0004\u0001\u0002w\u0001\u0002\u0003\u0011\u0004\u0005!1\u0006\u0012AQ\u0007aq\u0013\"2�\b\u0014B�� #3R�\u0015br� \u0016$4�%�\u0017\u0018\u0019\u001a&'()*56789:CDEFGHIJSTUVWXYZcdefghijstuvwxyz��\f\u0003\u0001\u0002\u0011\u0003\u0011?� ey�)�Q\u001e�l�\u0018⹯\u0018x�\u000f\u000fi,�T�[��O�is$U�\u0017��|=/��,�wmV��b�fo*�&�\u00181\u0004\u001fZ�}F}WR��vV�F,}\u0006Nj�\u00038犤�SK\u001dm��\u001f\u0010�\u0016+|�$��n\u0007�i�~<� ��A�<�]�fÏ�5��M ��L��,z\u0015�ōZ��2\u001b{��60�W[�|P�/@��18�԰��xcg�P�(��'\u0013�X�VT޻YznF�?�Hf\u0018��󯞼1�-C�׀)3�9��cǹ\u0007ֽ�B�,��5ol��0 ��\u001bЊ62�\u000b��F�(x�60h��\"�b�7��H\u0011�� ##\u001c\u0003޽��Î��\u0016�� v\u0019\u000f1�\b��\u0001�X'��\u0014y�\u0016�FVrO�h��\u0005$��\u000fz�\u0005�W\fۏ�*�\b�\u000bM\u001eN1��#�\u0015��RD��1�\u00108�QIm�eF;\u0016�\u0015�\f0�c\u0012�H��PI\u00018��\u001cpp3T�\\lb5��?\u0006��Y&ﺸ�lȌ�a�G�w\u0015I��>P�{�ՋV.PM\u0018L�N\u0018�#\u0015�\u0007�[k�_`�*��^Sq�3c\u0007\u0007Ԛ�;�^��ج�.x��_zm�r�=\u000fc\u0011�\u0019�\u0015M.YW\u0019��>��+^i�M��=60�\u0019Qˑ��x5��\u0013�A6\u0017J\b#|Go�\"�+SH�S\"�?�P��<�*��D6�.�N�q��i�8��Q��g��2��=��Тg�M\"��\u0015}��6��\\�\u001a��8]�\u0004��}j{�Y\u0002�6�R��~\u0007�fټ �W\"�դ�X�\u001c\u001c0\u0019��$�3\f�\u0016<35_�\u0005��N\u0007�K$j[׎G�\u0017\u0013��} �&�]�\u001b��zπ�6�tA��ig1�\u001c�{W��\u0010xY0 \u001eƽ#��\u001d\u0001VRIIX\u0002NN;T�c\u0019��(��v޴T��>\u00069��wH�ZӤ��(��Z�\u0004T\u0012�銋��;F��ٰ\u001d\u0018�q��o|�r��+��΅&�~�Ѐl�c��O\\��\u0005�Z|1!O\u0004�A��Cx��iC�d��?w5?�\"�33\u0005'8<�\u001e�\u0015Qb_4��j�9�KE��䍇\u0003\u0007��,�ܪ�\u0011�p~��~��(�\u0019[��f�U\u000bHe28=��K\u001b��e�<�\u001cӱJl�X�Ws7\u000e��~\u0015��G�98s�Gָo YIw�\u0019�\u0015��\u001b��m\u0010,ar)IhcRw4��P�\u0005\u0018��攞&Ѣ�ٵ;`\u0014�~l�N�k�Ծ(i\u0010;-�\u0017\u0017.:1\u001eZ�~y�+Þ�VO��\u0006:իVO��\\\u0006c�\u001d��уz�\u0019]j�"},{"id":"e362dd92-401d-4851-a135-4e01f378e845","name":"Face not detected","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/DL- ID.jpg"]}]},"url":"https://api.idcentral.io/idc/idc/onboarding/face/extract"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": 400,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Unable to find the face corrds from the requested document, please provide the valid document to exact the face\",\r\n \"timestamp\": 1647509614899,\r\n \"error\": \"Invalid Document\",\r\n \"success\": false,\r\n \"txn_id\": null\r\n}"},{"id":"c9301336-1cd2-4eba-9a64-80697c8745e2","name":"Invalid Document type","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/VISA/Reliving letter.pdf"]}]},"url":"https://api.idcentral.io/idc/onboarding/face/extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 16:53:40 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). Reliving letter.pdf is not supported\",\n \"timestamp\": 1668358420498,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"face_extraction_RgKQAQjWHizaS4itFxwQ\"\n}"},{"id":"29f44164-cc26-45c2-b72c-0fb0bda69530","name":"File Size Exceeds","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/DSC00203.JPG"]}]},"url":"https://api.idcentral.io/idc/onboarding/face/extract"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 16:56:53 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"File exceeds maximumm file size 5000000 bytes and DSC00203.JPG size is 21233664\",\n \"timestamp\": 1668358613316,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"face_extraction_K65cDVKJ5QwbUudPQFqx\"\n}"},{"id":"e9758a6b-0792-4594-89b5-b5b5a19c36aa","name":"Account Balance Exhausted","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/DL- ID.jpg"]}]},"url":"https://api.idcentral.io/idc/idc/onboarding/face/extract"},"status":"Not Found","code":404,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": 401,\r\n \"response_code\": 80,\r\n \"message_code\": null,\r\n \"message\": \"Account balance exhausted,Kindly contact for assistance\",\r\n \"timestamp\": 1647500347676,\r\n \"error\": \"Account balance exhausted\",\r\n \"success\": false,\r\n \"count\": 0\r\n}"}],"_postman_id":"4b53090a-cb5a-40a0-b27d-3330a6f2e1be"},{"name":"Face Profile","id":"77638681-bc8a-460e-8fe8-7464274838cd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"image","description":"

(Required) image

\n","type":"file","value":null}]},"url":"https://api.idcentral.io/idc/onboarding/facedetail","description":"

The Face Profile API provided by IDcentral is designed to detect and measure various facial features, including age, gender, and emotional expressions such as happiness, surprise, sadness, disgust, anger, and fear. This API allows the user to gain deeper insights into your audience by providing actionable and real-time data on their expressions and demographic characteristics. With this information, the user can better understand the customers and tailor products or services to meet the needs.

Face Profile API gives you-

Facial features: Detecting and measuring various facial features, including the coordinates of the eyes, ears, cheeks, nose, and mouth of every face detected. By analysing these coordinates, the API can provide detailed insights into the shape and structure of the face.
Contours of detected faces: Detecting and measuring the contours of detected faces, as well as the contours of their eyes, eyebrows, lips, and nose. By analysing these contours, the API can provide detailed information about the shape, size, and position of various facial features.
Emotional expressions: Detecting and measuring various emotional expressions, including whether a person is smiling or has their eyes closed. By analysing various facial features, such as the shape of the mouth and the position of the eyelids, the API can determine whether a person is smiling or has their eyes closed.

Definition:

Value: The value field in the API confirms whether a given facial feature has been accurately analysed and presented. For example, when the API retrieves information regarding whether a user is wearing eyeglasses, the value field will display 'true' if eyeglasses were detected and 'false' if they were not.
Confidence: The confidence score provided by the system is a numerical value ranging from 0 to 100. A score of 100 indicates a high probability of an exact match, while a score of 0 signifies no matching answer was found. The score reflects the level of confidence in the system's response, with higher scores indicating greater confidence. It's important to note that for a given query, there may be multiple answers returned with varying confidence scores.

Supported file format and other details:

In this Face Match API, the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
Max faces in a frame: 1.
File size should not be greater 5 MB.
Image shouldn't be compressed.

Request: The request has to be passed in form-data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	image	file	Required	Image of the document file from which the user wants to extract a face image

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	key	Data Type	Description
1	faceDetail	Object	Face feature information
1.1	Eyesglasses	Object	Whether the customer is wearing eyeglasses with value and confidence values
1.2	MouthOpen	Object	Whether the customer has mouth open with value and confidence values
1.3	AgeRange	Object	Eye range with low and high values
1.4	Quality	Object	Quality details with brightness and sharpness values
1.5	Pose	Object	Pose details with roll, yaw, pitch values
1.6	EyesOpen	Object	Whether the customer has eyes open with value and confidence values
1.7	Gender	Object	Gender prediction with value and confidence values
1.8	Smile	Object	Smile details with values and confidence values
1.9	Moustache	Object	Moustache details with value and confidence details
1.10	Sunglasses	Object	Whether the customer is wearing Sunglasses with value and confidence details

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When face profile details are extracted from the uploaded document	-	-	-	Note: Face profile details will be displayed
When face profile details are not extracted from the uploaded document	-	-	-	Note: Face profile details will not be displayed in the response
When uploaded file size is more than 5 MB.	2	-1	failed	File exceeds maximumm file size 5000000 bytes and DSC00203.JPG size is 21233664	Invalid Request
When uploaded document file format is not supported	-1	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). passsport-back.pdf is not supported	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","facedetail"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"b8c4ce24-1024-4e9b-93d7-59822f1849bc","name":"Face Details Extracted Successfully","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"image","description":"(Required) image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/VISA/Photo.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/facedetail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:01:16 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"faceDetail\": {\n \"Eyesglasses\": {\n \"value\": false,\n \"confidence\": 94.22\n },\n \"MouthOpen\": {\n \"value\": false,\n \"confidence\": 93.28\n },\n \"AgeRange\": {\n \"low\": 23,\n \"high\": 33\n },\n \"Quality\": {\n \"brightness\": 88.42,\n \"sharpness\": 92.23\n },\n \"Pose\": {\n \"roll\": 2.12,\n \"yaw\": -1.27,\n \"pitch\": 4.94\n },\n \"EyesOpen\": {\n \"value\": true,\n \"confidence\": 97.6\n },\n \"Gender\": {\n \"value\": \"Male\",\n \"confidence\": 99.97\n },\n \"Smile\": {\n \"value\": false,\n \"confidence\": 94.38\n },\n \"Moustache\": {\n \"value\": true,\n \"confidence\": 89.97\n },\n \"Sunglasses\": {\n \"value\": false,\n \"confidence\": 100\n }\n }\n}"},{"id":"1045078b-206e-41b8-be84-254387a3473d","name":"No face Details Extracted","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"image","description":"(Required) image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/flower.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/facedetail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:10:31 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"faceDetail\": {}\n}"},{"id":"22c3cf67-f81c-4905-9999-77ea10835148","name":"File Size Exceeds","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"image","description":"(Required) image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/DSC00203.JPG"]}]},"url":"https://api.idcentral.io/idc/onboarding/facedetail"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:12:45 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 2,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"File exceeds maximumm file size 5000000 bytes and DSC00203.JPG size is 21233664\",\n \"timestamp\": 1668359565753,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": null\n}"},{"id":"63507af2-e8db-441f-a701-2e51d7341fd7","name":"Invalid Document Type","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"multipart/form-data"},{"key":"Accept","value":"application/json"}],"body":{"mode":"formdata","formdata":[{"key":"image","description":"(Required) image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/passsport-back.pdf"]}]},"url":"https://api.idcentral.io/idc/onboarding/facedetail"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:13:16 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). passsport-back.pdf is not supported\",\n \"timestamp\": 1668359596662,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": null\n}"}],"_postman_id":"77638681-bc8a-460e-8fe8-7464274838cd"}],"id":"4108c7de-cfb2-4227-a253-4b630ba60655","description":"

What is Face Biometrics?

Face biometrics is a technology that captures an individual's facial features and converts them into a mathematical representation, known as a faceprint. This faceprint is stored in a database and used to verify a person's identity by comparing it with a live capture or digital image. The software relies on deep learning algorithms to make this comparison accurately.

Facial recognition technology is used to extract and identify human faces from digital images. It employs machine learning and algorithms to locate human faces in larger images, which may contain non-face objects such as buildings, landscapes, and body parts. It identifies key facial features and contours of the detected faces.

IDcentral offers developers APIs and SDKs that facilitate the integration of facial recognition technology into web and mobile applications. These APIs are designed to make complex biometric functionality easily accessible to developers through a simple REST API, which can be integrated into any programming language or environment.

Definition

Threshold: Threshold is a setting used in facial recognition systems for the purposes of authentication, verification, or identification. The system determines whether a facial template match is accepted or rejected based on the match score falling above or below the threshold. The threshold can be adjusted within the facial recognition system, allowing for customization and optimization of the matching process. For example, when matching faces against all the enrolled faces in a gallery, IDcentral returns a similarity score ranging from 0 to 100. A higher score indicates that the system is more confident in the match between the faces.
Similarity: Similarity is the process of calculating a numerical score that measures the degree of similarity between two face templates, which is used to determine whether there is a match or no-match. The similarity score typically ranges from 0 to 100, with a higher score indicating a higher degree of similarity between the two faces being compared.

IDcentral offers below Face Biometrics API services:

Face Match
Face Extraction
Face Profile

\n","_postman_id":"4108c7de-cfb2-4227-a253-4b630ba60655"},{"name":"Forgery Detection","item":[{"name":"Forgery Detection V2","id":"1db9ec77-f566-4750-865b-8ee8496d0a1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect","description":"

What is Forgery Detection API?

This Forgery Detection API helps you to be confident that the document supplied to you hasn’t been built using a fake document generator app, doesn’t have a passport photo pasted on it, and has all the expected color schemes that the standard document is expected to have.
IDcentral's AI-based forgery detection API is designed to quickly identify fraud and forgery. An OCR algorithm is used to train the forgery detection API to make our Anti-spoof better the Bank Grade. Simply upload a document, and the system will confirm whether it is legitimate and has been issued by the government.

Numerous banks, NBFCs, and other financial institutions use this security scheme before providing loans to any individual. Verified and certified by users, we offer forgery Detection API that's frequently used by customers to fulfill their objectives.

Supported File Types:

This Forgery Detection API supports all pdf,png,jpeg format documents provided in url or base64 in request.

Request: The request parameters has to pass under raw JSON format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	document_front_base64 (or document_front_url)	String	Required	base64 or url of front side of the file to be run for forgery detection.
2	document_back_base64 (or document_back_url)	String	Optional	base64 or url of back side of the file to be run for forgery detection.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
2	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
3	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
4	error	String	A text content explains a reason if API request failed
5	timestamp	Integer	API response receive time in milliseconds
6	message	String	A text content explains if API request was successful or not.
7	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
8	data	Object	The field gives data respective for front and back side of the document, clarifying if it is forged or not along with evidence provided if any.
8.1	front	Object	data associated with the front side of document uploaded.
8.11	is_identity_document	Object	returns true if provided document is valid identity document, else false.
8.1.2	possible_suspicious_words	Object	returns true or false with evidence if any when any suspicious words found in the document
8.1.3	possible_image_manipulation	Object	returns true or false with evidence if any when any image manipulation found in the document
8.1.4	possible_online_duplicate	Object	returns true or false and give evidence if any duplicate of the provided document exist online
8.2	back	Object	all key value pairs similar to 8.1 (front) for the back side of the document if it is uploaded

Response Details:

Scenario	Status Code	Response Code	Status	Message	Error
When valid document is uploaded	200	1	success	Successful Request
When uploaded document is downloaded from online data and possibly fraudulent.	200	2	success	The provided document may be possibly forged.	Verification failed
When the document uploaded is possibly forged/ fraudulent	200	2	success	The provided document may be possibly forged.	Verification failed
When the document uploaded is not an identity document	200	2	success	The provided document may be possibly forged.	Verification failed
When no document is provided	400	-1	failed	document_front_base64 and document_front_url both cannot be empty	Validation error
When document entered in unsupported doc format	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, png, and pdf)	Validation error
When entered document exceeds maximum allowed file size	400	-1	failed	File exceeds maximum file size 5242880 bytes and document_front_base64 size is 6994049	Validation error
When we enter multiple paged document	400	-1	failed	The PDF data consists of multiple pages.	Validation error
When we give invalid image url format	400	-1	failed	Invalid Image URL format	Validation error
When the document entered is in invalid MIME type	400	-1	failed	Please provide the supported MIME types (image/jpeg, image/png and application/pdf).	Validation error
All other mismatch error	200	9	success

","urlObject":{"path":["v2","forgery-detect"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"141825af-56a9-4f3c-bffa-d74576061171","name":"Success scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_qeId41OFT48hD3ZDgRSG\",\n \"timestamp\": 1709798569380,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"front\": {\n \"is_identity_document\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_suspicious_words\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_image_manipulation\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_online_duplicate\": {\n \"value\": \"false\",\n \"evidence\": []\n }\n },\n \"back\": {\n \"is_identity_document\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_suspicious_words\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_image_manipulation\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_online_duplicate\": {\n \"value\": \"false\",\n \"evidence\": []\n }\n }\n }\n}"},{"id":"9edad541-5efd-482c-a758-6c13e7e71bf8","name":"Document from online data","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_NhHmFIrt3IDlGixpdhEg\",\n \"timestamp\": 1709724946528,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The provided document may be possibly forged.\",\n \"data\": {\n \"front\": {\n \"is_identity_document\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_suspicious_words\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_image_manipulation\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_online_duplicate\": {\n \"value\": \"true\",\n \"evidence\": [\n \"https://encrypted-tbn2.gstatic.com/images?q=tbn:ANd9GcQ2SRHoTpAqE4-vREDRnkkyfOQ8psgkTP6bClZUSRvDwxxxxxxxx\"\n ]\n }\n },\n \"back\": {}\n }\n}"},{"id":"f6eb2332-f2e5-4ae3-900f-0db5c3b73240","name":"Possibly forged/ fraudulent","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_kD5wCHrbWee0xxH4hY3E\",\n \"timestamp\": 1709724784188,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The provided document may be possibly forged.\",\n \"data\": {\n \"front\": {\n \"is_identity_document\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_suspicious_words\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_image_manipulation\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_online_duplicate\": {\n \"value\": \"false\",\n \"evidence\": []\n }\n },\n \"back\": {}\n }\n}"},{"id":"02b6e60d-1910-40f7-bd3f-dd86fded623a","name":"Not identity document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_2GOe8fi07it2db98dCeY\",\n \"timestamp\": 1709804045419,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The provided document may be possibly forged.\",\n \"data\": {\n \"front\": {\n \"is_identity_document\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_suspicious_words\": {\n \"value\": \"false\",\n \"evidence\": []\n },\n \"possible_image_manipulation\": {\n \"value\": \"true\",\n \"evidence\": []\n },\n \"possible_online_duplicate\": {\n \"value\": \"false\",\n \"evidence\": []\n }\n },\n \"back\": {}\n }\n}"},{"id":"78470bea-08df-41c2-865f-55a6c46a90d0","name":"Validation error - no document provided","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_EaU4D3e0M3moHWJXAq9N\",\n \"timestamp\": 1709723800697,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"document_front_base64 and document_front_url both cannot be empty\",\n \"data\": null\n}"},{"id":"133ed992-b471-44f1-8d48-d22c5efb492f","name":"Validation error - unsupported doc format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_lvkOJW15Y8xEMEWoXPGT\",\n \"timestamp\": 1710326349152,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, png, and pdf).\",\n \"data\": null\n}"},{"id":"c39c989b-a302-480d-b872-9756749f51bf","name":"Validation error - exceeding file size","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_mVWAaUjvpCFrwFnSgYCm\",\n \"timestamp\": 1709798911607,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"File exceeds maximum file size 5242880 bytes and document_front_base64 size is 6994049\",\n \"data\": null\n}"},{"id":"ef24c22a-657b-44d6-80c3-6ad3867cf523","name":"Validation error - multipage doc","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_Eqkq3tdFYdyewxT0GXbK\",\n \"timestamp\": 1709722792650,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"The PDF data consists of multiple pages.\",\n \"data\": null\n}"},{"id":"be0da850-203a-4a5a-9861-f22c288f36de","name":"Validation error - Invalid url format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_G8KXf02AyXkYdIo4YMSf\",\n \"timestamp\": 1709798758204,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid Image URL format\",\n \"data\": null\n}"},{"id":"e392b9f5-80b1-491e-b8c2-d078deda1874","name":"Validation error - Unsupported MIME type","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"document_front_base64\": \"{{document_front}}\", //Use\"document_front_url\" for Image in URL format\r\n \"document_back_base64\": \"{{document_back}}\" //Use\"document_back_url\" for Image in URL format\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/forgery-detect"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"297"},{"key":"Date","value":"Wed, 13 Mar 2024 07:19:44 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"forgery_detection_v2_D4uJrlCEvbvnAK9yGbWW\",\n \"timestamp\": 1710395480962,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide the supported MIME types (image/jpeg, image/png and application/pdf).\",\n \"data\": null\n}"}],"_postman_id":"1db9ec77-f566-4750-865b-8ee8496d0a1f"}],"id":"3e1bb274-080f-49c3-bd74-aae729204a45","description":"

This Forgery Detection eliminates the fraudulent onboarding at source by ensuring that the document provided to you is not a tampered document.

\n","_postman_id":"3e1bb274-080f-49c3-bd74-aae729204a45"},{"name":"GST","item":[{"name":"getGstInDetails","id":"213f50ec-788f-49cf-a23a-c674594c1de1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"filing_status_get\": true,\n \"id_number\": \"30AAACR5055KZK\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin","description":"

This API will verify the legitimacy of a GSTIN. You will need to pass the GST Number to verify the status of the GST licence. On successful validation, the API will return the complete business details including name and address of the business.

GSTIN Format - The first 2 digits of the 15 digit GSTIN represents the state code. The next 10 digits are the PAN number of the person or the business entity. The thirteenth digit is based on the number of registrations done by the firm within a state under the same PAN.

Definition:

filing_status_get: Filing Status gives you past records of GST filing by a company. if value is 'true' then API will return GST filing details for past years.
HSN Code: HSN code stands for “Harmonized System of Nomenclature”. This system has been introduced for the systematic classification of goods all over the world. HSN code is a 6-digit uniform code that classifies 5000+ products and is accepted worldwide.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	GSTIN number
2	filing_status_get	Boolean	Optional	To get the filling status list pass the value as true else false. (default value as false)

Response:

S. No	Key	Data Type	Description
1	data	Object	Data fetched for the given GSTIN number
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	gstin	String	The GSTIN number
1.3	pan_number	String	The Pan Card number associated with given GSTIN number
1.4	business_name	String	Business Name as per the GST records for given GSTIN number
1.5	legal_name	String	Legally registered name as per the GST records for given GSTIN number
1.6	center_jurisdiction	String	Jurisdiction Center as per the GST records for given GSTIN number
1.7	state_jurisdiction	String	Jurisdiction State as per the GST records for given GSTIN number
1.8	date_of_registration	String	The Date of Registration as per the GST records for given GSTIN number
1.9	constitution_of_business	String	Business Constitution Name as per the GST records for given GSTIN number
1.10	taxpayer_type	String	The type of the TaxPayer as per the GST records for given GSTIN number
1.11	gstin_status	String	Status of the GSTIn as per the GST records for given GSTIN number
1.12	date_of_cancellation	String	Cancellation Date as per the GST records for given GSTIN number
1.13	field_visit_conducted	String	The status of field visit conducted as per the GST records for given GSTIN number
1.14	filing_status	Array of Object	Information about the GST filling Status list for given GSTIN number
1.14.1	return_type	String	Return type of the filling status as per the GST records for given GSTIN number
1.14.2	financial_year	String	Financial year of the filling status as per the GST records for given GSTIN number
1.14.3	tax_period	String	Tax period of the filling status as per the GST records for given GSTIN number
1.14.4	date_of_filing	String	Filling Date of the filling status as per the GST records for given GSTIN number
1.14.5	status	String	The status of the filling status as per the GST records for given GSTIN number
1.14.6	mode_of_filing	String	The mode of filling as per the GST record for given GSTIN number
1.15	address	String	Address as per the GST records for given GSTIN number
1.16	hsn_info	Object	HSN code if any assciated with given GSTIN number
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When GST details are successfully fetched with filing details	200	1	success	Successful Request
When GST details are successfully fetched without filing details	200	1	success	Successful Request
When Invalid GST number is entered	400	-1	failed	Please provide the valid GST number	Invalid id_number
All other mismatch errors	200	9

","urlObject":{"path":["gstin"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7cd4270a-391b-4957-afb0-cf2c53c43157","name":"Success Scenario with filling details","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"filing_status_get\": true,\n \"id_number\": \"30AAACRXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"corporate_gstin_XtesPtagXfkmkLefkvaf\",\n \"gstin\": \"30AAACR5055K1ZK\",\n \"pan_number\": \"AAACR5055K\",\n \"business_name\": \"RELIANCE INDUSTRIES LIMITED.\",\n \"legal_name\": \"RELIANCE INDUSTRIES LIMITED\",\n \"center_jurisdiction\": \"Commissionerate - GOA,Division - DIVISION-II,Range - RANGE-IV\",\n \"state_jurisdiction\": \"State - Goa,Headquarter - Head Quarter,Ward - Panaji (Jurisdictional Office)\",\n \"date_of_registration\": \"2017-07-01\",\n \"constitution_of_business\": \"Public Limited Company\",\n \"taxpayer_type\": \"Regular\",\n \"gstin_status\": \"Active\",\n \"date_of_cancellation\": \"1800-01-01\",\n \"field_visit_conducted\": \"No\",\n \"filing_status\": [\n [\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"February\",\n \"date_of_filing\": \"2022-03-09\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"January\",\n \"date_of_filing\": \"2022-02-08\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"December\",\n \"date_of_filing\": \"2022-01-10\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"November\",\n \"date_of_filing\": \"2021-12-09\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"October\",\n \"date_of_filing\": \"2021-11-09\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"September\",\n \"date_of_filing\": \"2021-10-08\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"August\",\n \"date_of_filing\": \"2021-09-08\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"July\",\n \"date_of_filing\": \"2021-08-09\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"June\",\n \"date_of_filing\": \"2021-07-08\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR1\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"May\",\n \"date_of_filing\": \"2021-06-10\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"January\",\n \"date_of_filing\": \"2022-02-18\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"December\",\n \"date_of_filing\": \"2022-01-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"November\",\n \"date_of_filing\": \"2021-12-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"October\",\n \"date_of_filing\": \"2021-11-19\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"September\",\n \"date_of_filing\": \"2021-10-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"August\",\n \"date_of_filing\": \"2021-09-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"July\",\n \"date_of_filing\": \"2021-08-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"June\",\n \"date_of_filing\": \"2021-07-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"May\",\n \"date_of_filing\": \"2021-06-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR3B\",\n \"financial_year\": \"2021-2022\",\n \"tax_period\": \"April\",\n \"date_of_filing\": \"2021-05-20\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9\",\n \"financial_year\": \"2020-2021\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2021-12-17\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9\",\n \"financial_year\": \"2019-2020\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2021-02-27\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9\",\n \"financial_year\": \"2018-2019\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2020-11-30\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9\",\n \"financial_year\": \"2017-2018\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2020-01-28\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9C\",\n \"financial_year\": \"2020-2021\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2021-12-28\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9C\",\n \"financial_year\": \"2019-2020\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2021-02-27\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9C\",\n \"financial_year\": \"2018-2019\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2020-12-09\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n },\n {\n \"return_type\": \"GSTR9C\",\n \"financial_year\": \"2017-2018\",\n \"tax_period\": \"Annual\",\n \"date_of_filing\": \"2020-01-31\",\n \"status\": \"Filed\",\n \"mode_of_filing\": \"ONLINE\"\n }\n ]\n ],\n \"address\": \"RCITPL Premises,Ground Floor, CMM Arena, Renovadi, Merces, North Goa, Goa, 403005\",\n \"hsn_info\": {}\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1647512782228,\n \"error\": null,\n \"success\": true,\n \"txn_id\": null\n}"},{"id":"3af3776b-607a-4af3-a579-2e94b049f9a5","name":"Success Scenario without filling details","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"filing_status_get\": false,\n \"id_number\": \"30AAACRXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"corporate_gstin_owEsodSxlPibDaAWOvUi\",\n \"gstin\": \"30AAACR5055K1ZK\",\n \"pan_number\": \"AAACR5055K\",\n \"business_name\": \"RELIANCE INDUSTRIES LIMITED.\",\n \"legal_name\": \"RELIANCE INDUSTRIES LIMITED\",\n \"center_jurisdiction\": \"Commissionerate - GOA,Division - DIVISION-II,Range - RANGE-IV\",\n \"state_jurisdiction\": \"State - Goa,Headquarter - Head Quarter,Ward - Panaji (Jurisdictional Office)\",\n \"date_of_registration\": \"2017-07-01\",\n \"constitution_of_business\": \"Public Limited Company\",\n \"taxpayer_type\": \"Regular\",\n \"gstin_status\": \"Active\",\n \"date_of_cancellation\": \"1800-01-01\",\n \"field_visit_conducted\": \"No\",\n \"filing_status\": [],\n \"address\": \"RCITPL Premises,Ground Floor, CMM Arena, Renovadi, Merces, North Goa, Goa, 403005\",\n \"hsn_info\": {}\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1647513018653,\n \"error\": null,\n \"success\": true,\n \"txn_id\": null\n}"},{"id":"e227b481-448a-4b77-985d-5556e25c3701","name":"Invalid GST Number","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"filing_status_get\": false,\n \"id_number\": \"30AAAR50551ZK\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid GST number\",\n \"timestamp\": 1647513114626,\n \"error\": \"Invalid id_number\",\n \"success\": false,\n \"txn_id\": null\n}"}],"_postman_id":"213f50ec-788f-49cf-a23a-c674594c1de1"},{"name":"getGstInByPan","id":"19cdc04d-99e2-4db1-906e-b751b5074dad","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"AAACR5055K\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin-by-pan","description":"

A single business can have multiple GST numbers with a single PAN. For a single business you can have only single GST number in one state. However you can use same PAN number to register under GST in different states. Further if you have different business verticals, you can obtain multiple GST numbers with a single PAN in a single state.

Definition:

PAN Number: PAN is basically your company's tax identity. It should include 10 characters. The first 5 characters are alphabets followed by 4 numbers and the 10th character is an alphabet.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Valid Pan Card Number

Response:

S. No	Key	Data Type	Description
1	data	Object	Data fetched as per PAN Records
1.1	pan_number	String	The Requested Pan Card Number
1.2	client_id	String	The Unique reference ID for the transaction
1.3	gstin_list	Array of objects	The list of GSNin Records Associated with the requested Pan card
1.3.1	gstin	String	GSTIn number linked with Pan Number
1.3.2	state	String	Name of the state
1.3.3	state_code	String	Unique code of the state
1.3.4	active_status	String	The status of the GstIn number
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	String	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

(Note: gstin_list object will have details of all associated GSTIN number associated with given PAN number)

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When GSTIn details are fetched successfully by giving valid PAN number	200	1	success	Successful Request
All other mismatch errors	200	9
When Invalid PAN number passed	400	-1	failed	Please Provide the Valid Pan Card Number	Invalid id_number

","urlObject":{"path":["gstin-by-pan"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"2ce8cb1e-06ec-48c2-85b0-224d2f1f69e7","name":"Success Scenario with GSTIn list","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"AAACXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/gstin-by-pan"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"pan_number\": \"AAACXXXXXX\",\n \"client_id\": \"gstin_pan_iWEIiWNyTfXXXXXXXXXX\",\n \"gstin_list\": [\n {\n \"gstin\": \"23AAACR50XXXXXX\",\n \"state\": \"Madhya Pradesh\",\n \"state_code\": \"23\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"24AAACR50XXXXXX\",\n \"state\": \"Gujarat\",\n \"state_code\": \"24\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"23AAACR505XXXXXX\",\n \"state\": \"Madhya Pradesh\",\n \"state_code\": \"23\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"09AAACRXXXXXXXX\",\n \"state\": \"Uttar Pradesh\",\n \"state_code\": \"09\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"23AAACR5055K1ZF\",\n \"state\": \"Madhya Pradesh\",\n \"state_code\": \"23\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"24AAACR5055K3ZB\",\n \"state\": \"Gujarat\",\n \"state_code\": \"24\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"10AAACR5055K1ZM\",\n \"state\": \"Bihar\",\n \"state_code\": \"10\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"17AAACR5055K1Z8\",\n \"state\": \"Meghalaya\",\n \"state_code\": \"17\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"20AAACR5055K1ZL\",\n \"state\": \"Jharkhand\",\n \"state_code\": \"20\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"08AAACR5055K1Z7\",\n \"state\": \"Rajasthan\",\n \"state_code\": \"08\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"25AAACR5055K1ZB\",\n \"state\": \"Daman & Diu\",\n \"state_code\": \"25\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"21AAACR5055K1ZJ\",\n \"state\": \"Orissa\",\n \"state_code\": \"21\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"21AAACR5055K2ZI\",\n \"state\": \"Orissa\",\n \"state_code\": \"21\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"34AAACR5055K2ZB\",\n \"state\": \"Puducherry\",\n \"state_code\": \"34\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"26AAACR5055K2Z8\",\n \"state\": \"Dadra & Nagar Haveli\",\n \"state_code\": \"26\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"02AAACR5055K1ZJ\",\n \"state\": \"Himachal Pradesh\",\n \"state_code\": \"02\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"24AAACR5055K4ZA\",\n \"state\": \"Gujarat\",\n \"state_code\": \"24\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"04AAACR5055K1ZF\",\n \"state\": \"Chandigarh\",\n \"state_code\": \"04\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"05AAACR5055K1ZD\",\n \"state\": \"Uttarakhand\",\n \"state_code\": \"05\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"22AAACR5055K1ZH\",\n \"state\": \"Chhattisgarh\",\n \"state_code\": \"22\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"30AAACR5055K1ZK\",\n \"state\": \"Goa\",\n \"state_code\": \"30\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"03AAACR5055K1ZH\",\n \"state\": \"Punjab\",\n \"state_code\": \"03\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"27AAACR5055K1Z7\",\n \"state\": \"Maharashtra\",\n \"state_code\": \"27\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"02AAACR5055K2ZI\",\n \"state\": \"Himachal Pradesh\",\n \"state_code\": \"02\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"16AAACR5055K1ZA\",\n \"state\": \"Tripura\",\n \"state_code\": \"16\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"37AAACR5055K1Z6\",\n \"state\": \"Andrapradesh(New)\",\n \"state_code\": \"37\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"33AAACR5055K1ZE\",\n \"state\": \"Tamil Nadu\",\n \"state_code\": \"33\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"37AAACR5055K2Z5\",\n \"state\": \"Andrapradesh(New)\",\n \"state_code\": \"37\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"06AAACR5055K1ZB\",\n \"state\": \"Haryana\",\n \"state_code\": \"06\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"36AAACR5055K1Z8\",\n \"state\": \"Telengana\",\n \"state_code\": \"36\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"34AAACR5055K1ZC\",\n \"state\": \"Puducherry\",\n \"state_code\": \"34\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"19AAACR5055K1Z4\",\n \"state\": \"West Bengal\",\n \"state_code\": \"19\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"03AAACR5055K2ZG\",\n \"state\": \"Punjab\",\n \"state_code\": \"03\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"29AAACR5055K1Z3\",\n \"state\": \"Karnataka\",\n \"state_code\": \"29\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"27AAACR5055K4Z4\",\n \"state\": \"Maharashtra\",\n \"state_code\": \"27\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"07AAACR5055K1Z9\",\n \"state\": \"Delhi\",\n \"state_code\": \"07\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"26AAACR5055K1Z9\",\n \"state\": \"Dadra & Nagar Haveli\",\n \"state_code\": \"26\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"29AAACR5055K2Z2\",\n \"state\": \"Karnataka\",\n \"state_code\": \"29\",\n \"active_status\": \"Inactive\"\n },\n {\n \"gstin\": \"18AAACR5055K1Z6\",\n \"state\": \"Assam\",\n \"state_code\": \"18\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"01AAACR5055K1ZL\",\n \"state\": \"Jammu & Kashmir\",\n \"state_code\": \"01\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"32AAACR5055K1ZG\",\n \"state\": \"Kerala\",\n \"state_code\": \"32\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"27AAACR5055K3Z5\",\n \"state\": \"Maharashtra\",\n \"state_code\": \"27\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"13AAACR5055K1ZG\",\n \"state\": \"Nagaland\",\n \"state_code\": \"13\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"97AAACR5055K1Z0\",\n \"state\": \"\",\n \"state_code\": \"97\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"12AAACR5055K1ZI\",\n \"state\": \"Arunachal Pradesh\",\n \"state_code\": \"12\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"27AAACR5055K2Z6\",\n \"state\": \"Maharashtra\",\n \"state_code\": \"27\",\n \"active_status\": \"Active\"\n },\n {\n \"gstin\": \"24AAACR5055K2ZC\",\n \"state\": \"Gujarat\",\n \"state_code\": \"24\",\n \"active_status\": \"Inactive\"\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1647514302517,\n \"error\": null,\n \"success\": true,\n \"txn_id\": null\n}"},{"id":"eb1de75e-24f3-40eb-ab21-d20952758f03","name":"Invalid PAN Number","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"AAACR5055K\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/gstin-by-pan"},"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": 400,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Please Provide the Valid Pan Card Number\",\r\n \"timestamp\": 1647514488438,\r\n \"error\": \"Invalid id_number\",\r\n \"success\": false,\r\n \"txn_id\": null\r\n}"}],"_postman_id":"19cdc04d-99e2-4db1-906e-b751b5074dad"}],"id":"a5cc5bcb-0ac1-45f0-8f15-04cc4ba67dd7","description":"

What is GSTIN?

Indian Goods And Service Tax Act was implemented in July 2017 which replaced many indirect taxes. GSTIN is a unique number assigned to companies registered under this Act.

GSTIN verification is the process of verifying the registration of an entity. Businesses can perform this check as a mandatory taxation compliance while on-boarding new vendors, partners or customer entities.

Verifying GST Number or GSTIN is very important as there are many cases where individuals manipulate GST Number (GSTIN). In addition to this, the GST Number search will help you to maintain transparency in all the business transactions and will ensure that you are filing correct GST Returns for the particular tax period. Further, GSTIN verification will also help you to claim Input Tax Credit that you might lose because of fake GSTIN.

Verifying GSTIN or GST Number is the need of the hour to ensure that your paid GST taxes land up in the right pockets. It is also your opportunity to contribute towards nation-building.

IDcentral provides two GST details search APIs

Get GSTIN details API using GST number
Get GSTIN details using PAN number

\n","_postman_id":"a5cc5bcb-0ac1-45f0-8f15-04cc4ba67dd7"},{"name":"Image Processing","item":[{"name":"Base64 to Image","id":"f112a4c7-6d5c-4543-b7e6-479799ecbde4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"base64Image\": \"/j/4AAQSkZJRgABAQAAAQAB=\",\n \"outputFormat\": \"jpg\"\n}"},"url":"https://api.idcentral.io/idc/image/base64ToImage","description":"

Base64 to Image API helps to convert the Base64 URL to Image file.

This API support JPG and PNG formats to get the output image file.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
base64Image	String	Mandatory	Base64 URL of the image
outputFormat	String	Mandatory	supporting image formats are JPG or PNG.

Response: Successful response returns the image file in JPG or PNG format (as per the requested file format).

\n","urlObject":{"path":["image","base64ToImage"],"host":["https://api.idcentral.io/idc"],"query":[{"disabled":true,"key":"base64Image","value":"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"}],"variable":[]}},"response":[{"id":"c17baad6-b609-4560-9ac3-390c83a1a5d5","name":"Base64 to Image success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"base64Image\": \"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRoRWF2Uf/Z\",\n \"outputFormat\": \"JPG\"\n}"},"url":"https://api.idcentral.io/idc/idc/image/base64ToImage"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"image file get downloaded."},{"id":"310f52df-6165-4e45-bec2-2e2b6b47db94","name":"Invalid Request","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"base64Image\": \"/9j/4AAQSkZJRgABAQAAAQ/Z\",\n \"imageSize\": \"JPG\"\n}"},"url":"https://api.idcentral.io/idc/idc/image/base64ToImage"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": -1,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Please provide the base64Image\",\r\n \"timestamp\": 1647954761315,\r\n \"error\": \"Invalid Request\",\r\n \"success\": false,\r\n \"count\": 0\r\n}"},{"id":"b57092da-0b14-4ad1-8584-66979ccf0b24","name":"Invalid API Key","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"base64mage\": \"/9j/4AAQSkZJRgABAQEAYAB2ux//Z\",\n \"outputFormat\": \"png\"\n}"},"url":"https://api.idcentral.io/idc/idc/image/base64ToImage"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 22 Mar 2022 13:16:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 70,\n \"response_code\": 70,\n \"message_code\": null,\n \"message\": \"Please check your credentials and provide valid API key\",\n \"timestamp\": 1647954944156,\n \"error\": \"Authentication Failed\",\n \"success\": false,\n \"count\": 0\n}"}],"_postman_id":"f112a4c7-6d5c-4543-b7e6-479799ecbde4"},{"name":"Image to Base64","event":[{"listen":"test","script":{"id":"0fa98d0f-3c8d-4fbe-8103-b7a174272b89","exec":[""],"type":"text/javascript"}}],"id":"17fdcb43-1d71-45e9-9303-138d9ea19405","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"application/json","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/response.txt"}]},"url":"https://api.idcentral.io/idc/image/imageToBase64","description":"

Image to Base64 API helps to convert the Image file to Base64 URL.

Supported file formats:

In this Image to Base64 API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.

Request: The request has to be passed in form-data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
file	file	Mandatory	Image file to convert Base64

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	status_code	String	The status_Code of the API which is represents the API status as success or failure
2	timestamp	Integer	API response time stamp
3	data	Object	Data fetched from the image files
3.1	base64Image	String	Base64 URL of the Image
3.2	imageSize	String	the size of the converted image file in bytes
4	error	String	error message
5	statusCode	Integer	The Status code of the API which is represents the API status
6	txn_id	String	the unique transaction ID

","urlObject":{"path":["image","imageToBase64"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"0fd2e589-5e6c-44e9-a40f-a192c7c356d7","name":"Success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"application/json","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/1643892173245.jpg"]}]},"url":"https://api.idcentral.io/idc/idc/image/imageToBase64"},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"base64Image\": \"/9j/4AAQSkZJRgABAQEAYABgAAD/4TDKRXhpZgAATU0AKgAAAAgABAExAAIAAAALAAAQSodpAAQAAAABAAAQVoglAAQAAAABAAAgouocAAcAABAMAAAAPgAAAAAc6gAAABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA\",\r\n \"imageSize\": \"103736 bytes\"\r\n },\r\n \"status\": \"success\",\r\n \"status_code\": 1,\r\n \"response_code\": 1,\r\n \"message_code\": null,\r\n \"message\": \"Successful Request\",\r\n \"timestamp\": 1647955162939,\r\n \"error\": null,\r\n \"success\": true,\r\n \"count\": 0\r\n}"},{"id":"cc1a2d79-e0f2-4dd6-a402-e5359840817e","name":"Invalid Request","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"application/json","type":"default"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/1643892173245.jpg"]}]},"url":"https://api.idcentral.io/idc/idc/image/imageToBase64"},"status":"Bad Request","code":400,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": -1,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). 00005523202201.pdf is not supported\",\r\n \"timestamp\": 1647955270172,\r\n \"error\": \"Invalid Request\",\r\n \"success\": false,\r\n \"count\": 0\r\n}"}],"_postman_id":"17fdcb43-1d71-45e9-9303-138d9ea19405"},{"name":"getPhotoExtractor","id":"be9a7be3-611a-41b2-93a9-13acc971142a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"

(Required) file

\n","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/1643892564566.jpg"}]},"url":"https://api.idcentral.io/idc/image/photo/extractor","description":"

This Photo Extractor API helps to get the comprehensive information and metadata for searched image.

Supporting Files:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, and png file formats as Input.
The file should be max 5 MB, More than 5 MB files are not supported.

Request: The request files can passed in form-data format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
file	file	Mandatory	image file to extract the information

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	key	Data Type	Description
1	status_code	String	The status_Code of the API which is represents the API status as success or failure
2	timestamp	Integer	API response time stamp
3	data	Object	Returns the comprehensive information and metadata of the searched image file
4	error	String	error message
5	message	String	The Status message of the API
6	txn_id	String	the unique transaction ID

","urlObject":{"path":["image","photo","extractor"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"99c2cece-68a7-4b69-bafc-a2a8d853b094","name":"getPhotoExtractor success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"aliquip ipsum in dolore qui"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/image/photo/extractor"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": 1,\r\n \"timestamp\": 1644562889474,\r\n \"data\": {\r\n \"PNG-IHDR: Image Height\": \"163\",\r\n \"PNG-IHDR: Interlace Method\": \"No Interlace\",\r\n \"PNG-pHYs: Unit Specifier\": \"Metres\",\r\n \"File: File Modified Date\": \"Fri Feb 11 12:31:29 +05:30 2022\",\r\n \"PNG-gAMA: Image Gamma\": \"0.455\",\r\n \"File: File Name\": \"1644562906095download.png\",\r\n \"File: File Size\": \"137593 bytes\",\r\n \"PNG-sRGB: sRGB Rendering Intent\": \"Perceptual\",\r\n \"PNG-pHYs: Pixels Per Unit X\": \"5669\",\r\n \"PNG-pHYs: Pixels Per Unit Y\": \"5669\",\r\n \"PNG-IHDR: Color Type\": \"True Color with Alpha\",\r\n \"PNG-IHDR: Compression Type\": \"Deflate\",\r\n \"PNG-IHDR: Image Width\": \"310\",\r\n \"PNG-IHDR: Bits Per Sample\": \"8\",\r\n \"PNG-IHDR: Filter Method\": \"Adaptive\"\r\n },\r\n \"error\": null,\r\n \"message\": \"Successful Request\",\r\n \"txn_id\": \"\"\r\n}"},{"id":"68e9d982-ce04-4dbc-a81d-801fabb78c25","name":"Invalid Input","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/idc/image/photo/extractor"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": -1,\r\n \"timestamp\": 1644563006502,\r\n \"data\": null,\r\n \"error\": \"Input Error\",\r\n \"message\": \"Please provide the supported image files( jpeg, jpg, jpe, jif,tiff, webp,jfif, jfi and png). is not supported\",\r\n \"txn_id\": \"\"\r\n}"}],"_postman_id":"be9a7be3-611a-41b2-93a9-13acc971142a"},{"name":"resizeImage","id":"54cf7ecf-dc44-4dff-8868-cab022d2999b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"

(Required) file

\n","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/download.png"}]},"url":"https://api.idcentral.io/idc/image/resize?height=90&width=100","description":"

This Resize Image API helps to resize the given image and then optimize it.

Supporting Files:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, and png file formats as Input.
The file should be max 5 MB, More than 5 MB files are not supported.

Request: The request filed has to pass in Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
height	params (text)	Mandatory	The height of the image required to resize the image
width	param (text)	Mandatory	The width of the image required to resize the image

Request: The request files can passed in form-data format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
file	file	Mandatory	images files to resize the image.

Response: Successful response returns the image file in the input image format.

\n","urlObject":{"path":["image","resize"],"host":["https://api.idcentral.io/idc"],"query":[{"description":{"content":"

(Required) height

\n","type":"text/plain"},"key":"height","value":"90"},{"description":{"content":"

(Required) width

\n","type":"text/plain"},"key":"width","value":"100"}],"variable":[]}},"response":[{"id":"ea11d3d5-8536-4d00-8de6-688121396c5f","name":"resizeImage - Success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/1644466534288.jpg"]}]},"url":{"raw":"https://api.idcentral.io/idc/idc/image/resize?height=90&width=100","host":["https://api.idcentral.io/idc"],"path":["idc","image","resize"],"query":[{"key":"height","value":"90","description":"(Required) height"},{"key":"width","value":"100","description":"(Required) width"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""},{"id":"06c23192-1eb3-4fac-8b22-d91b4af62eb9","name":"Error senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/Resize16445637340821644466534288.jpg"]}]},"url":{"raw":"https://api.idcentral.io/idc/idc/image/resize?width=100","host":["https://api.idcentral.io/idc"],"path":["idc","image","resize"],"query":[{"key":"height","value":"90","description":"(Required) height","disabled":true},{"key":"width","value":"100","description":"(Required) width"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"54cf7ecf-dc44-4dff-8868-cab022d2999b"},{"name":"compressImage","id":"c87744bc-011f-4304-9710-746afed33f2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"

(Required) file

\n","type":"file","value":null}]},"url":"https://api.idcentral.io/idc/image/compress?quality=80","description":"

This Compress Image API helps to compress the quality of the image and return the new image in the same requested image file format.

Supporting Files:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, and png file formats as Input.
The file should be max 5 MB, More than 5 MB files are not supported.

Request: The request filed has to pass in Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
quality	params (text)	Mandatory	The Quality of the image required to compress the file

Request: The request files can passed in form-data format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
file	file	Mandatory	images files to compress the file.

Response: Successful response returns the image file in the input image format.

\n","urlObject":{"path":["image","compress"],"host":["https://api.idcentral.io/idc"],"query":[{"description":{"content":"

(Required) quality

\n","type":"text/plain"},"key":"quality","value":"80"}],"variable":[]}},"response":[{"id":"451043a3-914f-40d1-bdc9-9f1b607845ee","name":"compressImage - Success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"aliquip ipsum in dolore qui"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":[]}]},"url":{"raw":"https://api.idcentral.io/idc/image/compress?quality=9302296.105433434","host":["https://api.idcentral.io/idc"],"path":["image","compress"],"query":[{"key":"quality","value":"9302296.105433434","description":"(Required) quality"}]}},"_postman_previewlanguage":"Text","header":[{"key":"","value":"","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"The console does not support viewing bodies with media files.\r\n"},{"id":"c0dd5ac1-edcb-442c-a6c1-ff57e9de0381","name":"Error senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":[]}]},"url":{"raw":"https://api.idcentral.io/idc/idc/image/compress?quality=80","host":["https://api.idcentral.io/idc"],"path":["idc","image","compress"],"query":[{"key":"quality","value":"80","description":"(Required) quality"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": -1,\r\n \"timestamp\": 1644563603041,\r\n \"data\": null,\r\n \"error\": \"Input Error\",\r\n \"message\": \"Please provide the supported image files(jpg and png). is not supported\",\r\n \"txn_id\": \"\"\r\n}"}],"_postman_id":"c87744bc-011f-4304-9710-746afed33f2a"},{"name":"convertImage","id":"73f701ed-6bb3-41ed-b4b9-970986cd1bfe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"

(Required) file

\n","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/162496774085301362195_pancard_1624967183.jpeg"}]},"url":"https://api.idcentral.io/idc/image/convert?targetFormat=png","description":"

This Convert Image API helps to convert the image from one format to another format and it returns the output file as per the target requested format.

Supporting Files:

This API supports jpeg, jpg, jpe, jif, jfif, jfi, png and pdf file formats as Input & Output.
The file should be max 5 MB, More than 5 MB files are not supported.

Request: The request filed has to pass in Params

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
targetFormat	params (text)	Mandatory	The required output file format ( jpeg, jpg, jpe, jif, jfif, jfi, png and pdf)

Request: The request files can passed in form-data format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Key Parameter	Data Type	is Required	Description
file	file	Mandatory	file to convert

Response: Successful response returns the file as per the targeted file format.

\n","urlObject":{"path":["image","convert"],"host":["https://api.idcentral.io/idc"],"query":[{"description":{"content":"

(Required) targetFormat

\n","type":"text/plain"},"key":"targetFormat","value":"png"}],"variable":[]}},"response":[{"id":"260c395f-c688-4d07-bbe0-774e9485d01f","name":"convertImage - Success senario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/1643892046216.jpg"]}]},"url":{"raw":"https://api.idcentral.io/idc/idc/image/convert?targetFormat=png","host":["https://api.idcentral.io/idc"],"path":["idc","image","convert"],"query":[{"key":"targetFormat","value":"png","description":"(Required) targetFormat"}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":""},{"id":"9dedcff1-3f53-4434-b8b5-3ef05757a8e2","name":"Invalid request","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"file","description":"(Required) file","type":"file","src":["/C:/Users/saikrishna.grande/Downloads/1643892046216.jpg"]}]},"url":{"raw":"https://api.idcentral.io/idc/idc/image/convert?targetFormat=json","host":["https://api.idcentral.io/idc"],"path":["idc","image","convert"],"query":[{"key":"targetFormat","value":"json","description":"(Required) targetFormat"}]}},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"status_code\": -1,\r\n \"timestamp\": 1644564756976,\r\n \"data\": null,\r\n \"error\": \"Input Error\",\r\n \"message\": \"Supported outputFormat is jpg/png\",\r\n \"txn_id\": \"\"\r\n}"}],"_postman_id":"73f701ed-6bb3-41ed-b4b9-970986cd1bfe"}],"id":"aa8b9fef-d205-4d29-97d4-e967e2d6c99e","description":"

This Image Processing API's helps to perform the multiple functionalities as per the requirment.

This Image Processing covers the below mentioned all the functionalities

Base64 to Image Conversion
Image to Base64 Conversion
Image Extraction
Resizing the Image size
Compressing the image Quality
Converting Image to other required formats

\n","_postman_id":"aa8b9fef-d205-4d29-97d4-e967e2d6c99e"},{"name":"ITR Compliance","item":[{"name":"ITR Compliance Check","id":"6d8388f7-38c1-45f4-98bb-5b65603584ea","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"pan_number\": \"{{pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/itr-compliance-check","description":"

This ITR Compliance API provides the details on whether the given PAN card number is complied with ITR norms and have been filing ITR or not if eligible .

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	pan_number	String	Required	Valid Pan Card Number

Response:

S. No	Key	Data Type	Description
1	data	Object	Data fetched as per PAN Records
1.1	pan_number	String	The Requested Pan Card Number
1.2	is_specified_person	String	Result on whether compliant or not. Refer: 'Specified Person' defination. Expected values are \"N\" or \"Y\"
1.3	pan_allotment_date	String	A date of PAN allotment in \"YYYY-MM-DD\" format
1.4	masked_name	String	Masked Name of PAN card holder
1.5	pan_aadhaar_linked	String	Confirms whether PAN is linked with aadhaar or not. Expected values are \"Y\" or \"N\".
1.6	financial_year	String	The financial Year details for which the records are being searched
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	String	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Is_Specified_Person	Message
When PAN is ITR compliant	200	1	success	N	Successful Request
When PAN is ITR compliant	200	1	success	Y	Successful Request
All other mismatch error	200	9

","urlObject":{"path":["itr-compliance-check"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f280419a-658b-4918-a89b-b7675fca7a7a","name":"Success Scenario - ITR Filed","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"pan_number\": \"{{pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/itr-compliance-check"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 09:01:21 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"pan_number\": \"{{pan_number}}\",\n \"is_specified_person\": \"N\",\n \"pan_allotment_date\": \"2010-07-06\",\n \"masked_name\": \"PXXXXXXT DXXXXXXA BXXXXM \",\n \"pan_aadhaar_linked\": \"Y\",\n \"financial_year\": \"NA\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful request\",\n \"timestamp\": 1668934881021,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"itr_compliance_check_2qDycq6CeZXXXXXXXXXX\"\n}"}],"_postman_id":"6d8388f7-38c1-45f4-98bb-5b65603584ea"}],"id":"4fd45e7c-8609-4279-873c-cc892b8a672b","description":"

What is ITR compliance API?

IT compliance is a portal owned by Income Tax department facilitate and track the Tax deduction at source (TDS) and Tax Collection at Source (TCS) under Sections 206AB and 206CCA which are the latest addition to the Income Tax Act. The introduction of the new sections is for imposing higher TDS/ TCS rates on the persons falling under the “Specified Person” category as per the act. The new section is applicable from the 1st of July, 2021.

Who is classified as a 'Specified Person'?

If a person falls user user below menioned catagory then person is marked as 'specified person'

A person who has not filed the returns of income for both of the two assessment years relevant to the two previous years immediately prior to the previous year in which tax is required to be collected, for which the time limit of filing a return of income under sub-section (1) of section 139 has expired;
\n
The aggregate of tax deducted at source and tax collected at source in his case is rupees fifty thousand or more in each of these two previous years.
\n

It has two possible values. if personal is complied with ITD norms and classified as 'Not specified Person' then it will show 'N' as value and if not compliant then it will show 'Y' as a value.

\n","_postman_id":"4fd45e7c-8609-4279-873c-cc892b8a672b"},{"name":"Liveness","item":[{"name":"Liveness","id":"77bc0564-b3f5-4704-86c7-24af83b2eb0e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"regular\",\r\n \"threshold\":70\r\n}"},"url":"https://api.idcentral.io/idc/v2/liveness","description":"

\"Liveness Check API\" enables the user to detect potential fraud by ensuring that the image that has been given in the request is a genuine live image and not a static image, a passport sized image, or an image of someone else displayed on a mobile phone or laptop screen.

Note- This API accepts the image file in the form of either a URL linking to an image or a base64-encoded image.

Supported file format and other details:

The input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
\n
Minimal Image height: 480 px.
\n
Maximum Image file size should not exceed 5MB.
\n
Minimum padding for face: 10 px.
\n
Maximum faces in a frame: 1.
\n
Image shouldn't be compressed.
\n
Ideal face posture: Frontal face.
\n
Face orientation position: Vertical.
\n

To evaluate the performance, there are two metrics BPCER and APCER.

BPCER: BPCER stands for \"Bonafide Presentation Classification Error Rate\". It represents the rate at which the liveness check incorrectly categorizes genuine attempts as spoof or fraudulent attempts. A lower BPCER indicates better accuracy in distinguishing between genuine and spoof presentations.
\n
APCER: APCER stands for \"Attack Presentation Classification Error Rate\". It represents the rate at which the liveness check correctly identifies spoof or fraudulent attempts as genuine attempts. A lower APCER indicates a more robust system capable of detecting various spoofing attacks effectively.
\n

Note: This API should be used only in situations where the client application has control over the camera and is able to capture a photo of the customer directly. It should not be used when allowing the customer to upload an image file from their own device.

The recommended maximum distance between the face and the device is 1.5 feet.
\n
The user's ears should be visible when liveness is being checked.
\n
Enhanced illumination on facial areas and immediate surroundings may substantially elevate the BPCER.
\n
Poorly-lit settings and tinted light sources can notably boost BPCER.
\n
The presence of motion blur effects can notably increase BPCER, affecting the accuracy of distinguishing between a live person and a spoof.
\n
Implementing texture filtering can markedly elevate APCER, thereby raising the likelihood of permitting unauthorized individuals access.
\n

Definition:

threshold: In facial recognition systems, the threshold is a setting used for authentication, verification, or identification. The system decides whether a facial template match is acceptable or not based on whether the match score is higher or lower than the set threshold. This threshold is adjustable according to the system's requirements.

Note: By default the threshold value is set to \"70\".

device: The device mentioned refers to the supporting device on which the user intends to utilize this API. Currently this API supports mobile or desktop OS setting (Possible values are IOS, Android, Desktop or Unknown).

Note: By default the device value is set to \"Unknown\".

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

device	Definition
IOS	This refers to device which has IOS operating system, including iPhone and iPad.
Android	This refers to device which has Android operating system, including Android phones and tablets.
Desktop	This refers to device which has Desktop devices, including Desktop computer and laptop
Unknown	This refers to the devices which are unknown to the user.

calibration: The calibration refers to the process of configuring and fine-tuning the face recognition system to optimize its performance and accuracy. It involves adjusting various parameters to enhance the system's ability to accurately identify and match faces in different scenarios and conditions. Possible values are Soft, Regular, and Hardened.

Note: By default the calibration value is set to \"regular\".

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Calibration	Definition
Soft	If the Calibration is set to \"Soft,\" it aims to be more forgiving and accommodating to legitimate users.
Regular	If the Calibration is set to \"Regular\", it aims to prioritize accuracy by being cautious and minimizing the chances of allowing impostors to be recognized as authorized individuals. It maintains balance between the \"Soft\" and \"Hardened\" calibration.
Hardened	Hardened If the Calibration is set to \"Hardened,\" it aims to prioritize maximizing security and being very cautious and strict.

image_quality_score: The image_quality_score is used to evaluate multiple parameters related to image quality, including blur, reflection, sharpness, exposure, and orientation (pitch, yaw, roll), as well as the positions of the eyes and mouth. It returns a quality score that indicates how well the image meets the system's requirements.
\n
score: The score in liveness detection serves as a confidence measure to determine whether the person in the image is a live individual or a fake representation, such as a pre-captured image, a sequence of images displayed on-screen, or a physical mask used by malicious actors with fraudulent intentions.
\n
result: The final decision about whether the face is genuine or fake is determined by the liveness score and the threshold. If the score is higher than the threshold, it is considered genuine or accepted, while if it is lower than the threshold, it is considered fake or rejected.
\n

Request: The request has to be passed in body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	photo_url or photo_base64	String	Required	Selfie image in the form of URL or Base 64
2	threshold	Decimal	Required	Refer: Threshold definition
3	device	String	Optional	Refer: Device definition
4	calibration	String	Optional	Refer: Calibration definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Information fetched from Liveness check
1.1	threshold	Float	The default threshold value applied for the image.
1.2	image_quality_score	Float	The quality score of the input image
1.3	score	Float	Liveness score of the image
1.4	result	String	The liveness status of the image as pass or fail

Scenarios Covered

Scenario	Status Code	Response Code	Status	Message	Error
When system has successfully detected liveness from the uploaded document	200	1	success	Successful Request
Liveness Check Failed. Possible Spoof.	200	2	success	Liveness Check Failed. Possible Spoof.	Verification error
When uploaded document file format is not supported	200	3	success	Provided image doesn't meet the specifications : Interpupillary distance is too small	Verification error
Provided image doesn't meet the specifications : Too many faces detected	200	3	success	Provided image doesn't meet the specifications : Too many faces detected	Verification error
Provided image doesn't meet the specifications : Failed to detect face	200	3	success	Provided image doesn't meet the specifications : Failed to detect face	Verification error
All other mismatch errors	200	9
Invalid format	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).	Validation error
Invalid photo_base64	400	-1	failed	Invalid Image Format	Validation Failed
Invalid photo_url	400	-1	failed	Invalid Image URL	Validation Failed
Photo_url not accessible	400	-1	failed	Image URL Unreachable	Validation Failed
Either photo_url or photo_base64 to be provided	400	-1	failed	Either of photo_url or photo_base64 is mandatory	Validation Failed
Both photo_url & photo_base64 are provided	400	-1	failed	Provide either photo_url or photo_base64, not both	Validation Failed
Invalid image format	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).	Validation Failed
Invalid calibration	400	-1	failed	Invalid Calibration	Validation Failed
Invalid Device	400	-1	failed	Invalid Device	Validation Failed
Invalid size	400	-1	failed	File exceeds maximumm file size 5000000 bytes and {image name} size is {file size}	Validation Failed

","urlObject":{"path":["v2","liveness"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"857a3b77-1de6-4cf0-b5b7-d9351b9aa0fa","name":"Successful Scenario (URL)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_8mRrXnuxb2Ez2d3WfFeU\",\n \"timestamp\": 1694070410173,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"threshold\": 70.0,\n \"image_quality_score\": 100.0,\n \"score\": 96.96,\n \"result\": \"pass\"\n }\n}"},{"id":"6c108764-93f0-4a5c-94d3-7e90490dd778","name":"Successful Scenario (Base 64)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"photo_base64\": \"{{photo_base64}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_8mRrXnuxb2Ez2d3WfFeU\",\n \"timestamp\": 1694070410173,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"threshold\": 70.0,\n \"image_quality_score\": 100.0,\n \"score\": 96.96,\n \"result\": \"pass\"\n }\n}"},{"id":"ae096f2b-1aff-4f6b-911f-d2de7634f39d","name":"Spoof Detected","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}"},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_41rve3QdjMezeDYa9qti\",\n \"timestamp\": 1694072066498,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification error\",\n \"message\": \"Liveness Check Failed. Possible Spoof.\",\n \"data\": {\n \"threshold\": 70.0,\n \"image_quality_score\": 88.06,\n \"score\": 6.82,\n \"result\": \"fail\"\n }\n}"},{"id":"c49136bc-37dc-4931-af26-6b0684a30828","name":"Multiple Faces","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}"},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_DpK1cjJ65fP0YGI7MDMp\",\n \"timestamp\": 1694075154212,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification error\",\n \"message\": \"Provided image doesn't meet the specifications : Too many faces detected\",\n \"data\": null\n}"},{"id":"c8a56697-5d35-4657-88f2-4d716ec47343","name":"Failed Specification","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}"},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_nmT8l0nznzgPMeb4HM68\",\n \"timestamp\": 1694076181952,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification error\",\n \"message\": \"Provided image doesn't meet the specifications : Failed to detect face\",\n \"data\": null\n}"},{"id":"c5312e8f-7ac8-48c1-8e5a-57629e4eadff","name":"Unsupported Image","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"photo_url\": \"{{photo_url}}}}\",\r\n \"device\": \"{{device}}\",\r\n \"calibration\": \"{{calibration}}\",\r\n \"threshold\":70\r\n}"},"url":"https://api.idcentral.io/idc/v2/liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"331"},{"key":"Date","value":"Thu, 07 Sep 2023 10:10:57 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"passive_liveness_check_8mRrXnuxb2Ez2d3WfFeU\",\n \"timestamp\": 1694070410173,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"threshold\": 70.0,\n \"image_quality_score\": 100.0,\n \"score\": 96.96,\n \"result\": \"pass\"\n }\n}"}],"_postman_id":"77bc0564-b3f5-4704-86c7-24af83b2eb0e"}],"id":"53b73903-00ed-4ffe-82cf-703962adc90a","description":"

What is Liveness detection?

Liveness detection is a way of identifying if someone is trying to trick a system by checking if the source of a biometric sample is a real person or a fake one. Special algorithms analyze data from biometric sensors to determine if the source is genuine or not.

In facial recognition systems that use biometrics, liveness detection uses a person's unique biological features to confirm their identity with very high accuracy and very few errors. This authentication relies on each person's unique biological traits and is a major improvement in authentication technology. It involves having exclusive and unrepeatable data specific to each person.

\n","_postman_id":"53b73903-00ed-4ffe-82cf-703962adc90a"},{"name":"Name Matching","item":[{"name":"Name Matching","id":"ca680c6b-7afb-4a27-89dd-4b5d58e40860","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/onboarding/match?baseName=&verificationName=","description":"

This Name Match API helps to identify two elements of text, strings, or entries that are approximately similar but are not exactly the same.

This Name Match API helps to score the similarity of data.

Request: The request params has to be passed in URL.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	baseName	String	Required	The Value of the 1st String which we want to verify
2	verificationName	String	Required	The Value of the 2st String to compare the baseName value.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Name match details
1.1	match_score	Float	The match score of the two strings. score range i.e 0.0 to 1.0.
1.2	match_status	String	Match status as a binary string. Details on interpreting this output below.
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
7	message	String	A text content explains if API request was successful or not.
8	timestamp	Integer	API response receive time in milliseconds
9	responseTimestamp	Integer	API response receive time in milliseconds
10	error	String	A text content explains a reason if API request failed
11	success	Bllean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
6	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Match Status:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Bit	Meaning
0000001	Mis-Spelt (but matches phonetically)
0000010	Name(s) match, but are mis-ordered
0000100	Names (s) match, but one or more names in verification name are Initialled
0001000	Names (s) match, but one or more names in verification name are Expanded
0010000	Name (s) match, but one or more names are NOT present in the base name.
0100000	Name (s) match, but one or more names are NOT present in the verification name
1000000	One or more names don't match. Phonetic mismatches are NOT set by this bit.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Match_Status	Status	Message	Error
When given name and verification name matches	200	1	000000	success	Successful Request
When given name and verification name do not match	200	1	010000	success	Successful Request
When base name is missing	400	-1		failed	Please provide the valid baseName	Invalid baseName
When verification name is missing	400	-1		failed	Please provide the valid verificationName	Invalid verificationName
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","match"],"host":["https://api.idcentral.io/idc"],"query":[{"key":"baseName","value":""},{"key":"verificationName","value":""}],"variable":[]}},"response":[{"id":"c8ee5b44-57da-4bf7-aa70-1390e13f5e98","name":"Fuzzy Match with match score as > 0.80","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/onboarding/match?baseName=&verificationName=","host":["https://api.idcentral.io/idc"],"path":["onboarding","match"],"query":[{"key":"baseName","value":""},{"key":"verificationName","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 09 Dec 2022 10:01:23 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"match_score\": 1,\n \"match_status\": \"0000000\"\n },\n \"status\": \"success\",\n \"status_code\": \"200\",\n \"statusCode\": \"200\",\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670580083457,\n \"responseTimestamp\": 1670580083457,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"fuzzy_match_pAoP951seF8dSJUwbMsO\"\n}"},{"id":"3d86533c-8b27-4314-9dfa-894d1d56fda1","name":"Fuzzy Match with match score <0.20","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/idc/onboarding/match?baseName=&verificationName=","host":["https://api.idcentral.io/idc"],"path":["idc","onboarding","match"],"query":[{"key":"baseName","value":""},{"key":"verificationName","value":""}]}},"status":"OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": {\r\n \"match_score\": 0.21,\r\n \"match_status\": \"010000\"\r\n },\r\n \"status\": \"success\",\r\n \"status_code\": \"200\",\r\n \"statusCode\": \"200\",\r\n \"response_code\": 1,\r\n \"message_code\": \"success\",\r\n \"message\": \"Successful Request\",\r\n \"timestamp\": 1647953704877,\r\n \"responseTimestamp\": 1647953704877,\r\n \"error\": null,\r\n \"success\": true\r\n}"},{"id":"40d6fa4b-1bcf-40b5-a7fa-5dfde5aa3d73","name":"Base name is missing","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/onboarding/match?baseName=&verificationName=","host":["https://api.idcentral.io/idc"],"path":["onboarding","match"],"query":[{"key":"baseName","value":""},{"key":"verificationName","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 18:05:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": \"400\",\n \"statusCode\": null,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid baseName\",\n \"timestamp\": 1668362713174,\n \"responseTimestamp\": 1668362713174,\n \"error\": \"Invalid baseName\",\n \"success\": false,\n \"txn_id\": \"fuzzy_match_6ch2Ac7jfXXXXXXXXXXX\"\n}"},{"id":"1489206e-eb8f-416a-ab62-3f359da81729","name":"Verification Name is missing","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/onboarding/match?baseName=&verificationName=","host":["https://api.idcentral.io/idc"],"path":["onboarding","match"],"query":[{"key":"baseName","value":""},{"key":"verificationName","value":""}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 18:06:08 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": \"400\",\n \"statusCode\": null,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid verificationName\",\n \"timestamp\": 1668362768770,\n \"responseTimestamp\": 1668362768770,\n \"error\": \"Invalid verificationName\",\n \"success\": false,\n \"txn_id\": \"fuzzy_match_T2RCNajnXXXXXXXXXXXX\"\n}"}],"_postman_id":"ca680c6b-7afb-4a27-89dd-4b5d58e40860"}],"id":"9ba98445-5ccc-4aad-bcf2-77abbfbe48c7","description":"

What is Name-matching API ?

This API provides an algorithmically-generated individual name similarity match-score utilizing machine learning and other heuristic algorithms. These keys, when sorted or matched, enable similar individual names (Jim Johnson, James Johnston, etc.) to be clustered together for the purposes of identifying redundant data, improving analytics, business intelligence, business processes, data science, CRM, and other data-centric disciplines. This REST-based API takes an individual/person name query string and returns the generated similarity key in JSON.

Definition:

baseName: It is any Json, for example an name structure to be compared with either a verificationName. It is mainaly a user input that business wishes to validate and compare from the name from validated source.
verificationName: It is a Json object, for example a name, which should be compared to baseName. It usually verified/validated name fetched from validated document.
match_score: The name matching returns scores that can range from 0 through 100% (It is shown as range from 0 to 1. for eg. if name match is 40% then the value will be 0.4) based on how close the search data and file data values match.
match_status: False positives are one of the biggest issues with name matching that uses fuzzy matching algorithms. scenarioes like words with acronyms, name reveral, phonetic mispelling, abrevations etc. To denote these kinds scenarioes, match_status codes have been mapped.

\n","_postman_id":"9ba98445-5ccc-4aad-bcf2-77abbfbe48c7"},{"name":"NSDL eSign","item":[{"name":"Setup Document","event":[{"listen":"test","script":{"id":"f03ba317-81d3-4f22-a3d0-dc20f423d028","exec":[""],"type":"text/javascript"}}],"id":"82e59dec-0ca7-4cb3-9b3c-6a635348d003","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":"/C:/Users/linus.xavier/OneDrive - Subex Limited/Documents/All/Samples/NSDL eSign/Contract document.pdf"},{"key":"request","value":" {\n \"templateId\": \"KQJC287934\",\n \"partyDetails\": [\n {\n \"nameOnSignatureStamp\": \"Linus\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"\",\n\"partyId\":\"Party 1\"\n },\n {\n \"nameOnSignatureStamp\": \"Manish\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"Reason\",\n\"partyId\":\"Party 2\"\n }\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/save","description":"

Setup Document API is used to generate the un-signed documents links that will be shared with the mentioned parties to be eSigned. The party details are also added to the request.

The uniquely generated link can be shared with parties via email, text message or can be displayed on the client platform and once clicked, it will be redirected to the eSign URL.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	file	File	Required	A document that will be eSigned by party / parties
2	request	String	Required	This includes Party/Parties details who will eSigning the document. It also includes templateId.

Response:

S. No	Key	Data Type	Description
1	data	String	Details when eSign URLs are generated
1.1	docId	String	Uniquely generated reference Id when eSign URLs are successfully generated on successful API response
1.2	esignUrls	Array List	eSign URL details
1.2.1	partyId	String	Party ID mentioned from the API request
1.2.2	url	String	It is uniquely generated unsigned URL for given party / parties. All mentioned party / parties will have independent eSign URLs.
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When individual un signed doc URLs are generated	200	1	success	Successful Request
When more than selected parties details are given	-1	0	failed	Selected document template only supports 2 party/parties.	Input Error
When un supported document is uploaded	-1	0	failed	File Name : pdf_file, only pdf documents are supported for E-sign	Input error
All other mismatch errors	200	9

","urlObject":{"path":["esign","save"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"2e90604e-9cff-4e2a-be97-839cfca118f1","name":"Documents Generated Successfully","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Esign Demo/fp_dc_setup_guide.pdf"]},{"key":"request","value":" {\n \"templateId\": \"XXXXXXXX\",\n \"partyDetails\": [\n {\n \"nameOnSignatureStamp\": \"Linus\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"\",\n\"partyId\":\"Party 1\"\n },\n {\n \"nameOnSignatureStamp\": \"Manish\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"Reason\",\n\"partyId\":\"Party 2\"\n }\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/save"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:08:29 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"docId\": \"7a3605c1-7ff0-4e2d-b498-XXXXXXXXXXXXXX\",\n \"esignUrls\": [\n {\n \"partyId\": \"Party 1\",\n \"url\": \"https://api.idcentral.io/web/esign/#/idc-esign/2f19ba31-61bb-4b18-b3b0-XXXXXXXXXXXXX\"\n },\n {\n \"partyId\": \"Party 2\",\n \"url\": \"https://api.idcentral.io/web/esign/#/idc-esign/90430a09-df6a-4381-9886XXXXXXXXXXXXXXX\"\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1668942510103,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"esign_api_kaNsvFsXXXXXXXXXXXX\"\n}"},{"id":"36d0fcf2-49c1-496f-99f6-13eb414f8ea1","name":"More than seleted parties given","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Esign Demo/fp_dc_setup_guide.pdf"]},{"key":"request","value":" {\n \"templateId\": \"XXXXXXXXXXX\",\n \"partyDetails\": [\n {\n \"nameOnSignatureStamp\": \"Linus\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"\",\n\"partyId\":\"Party 1\"\n },\n{\n \"nameOnSignatureStamp\": \"Linus\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"\",\n\"partyId\":\"Party 1\"\n },\n {\n \"nameOnSignatureStamp\": \"Manish\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"Reason\",\n\"partyId\":\"Party 2\"\n }\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/save"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:09:45 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": 0,\n \"message_code\": null,\n \"message\": \"Selected document template only supports 2 party/parties.\",\n \"timestamp\": 1668942585875,\n \"error\": \"Input Error\",\n \"success\": false,\n \"txn_id\": \"esign_api_f5jZsTaOXXXXXXXXXXXX\"\n}"},{"id":"14ffba8e-5e86-4c61-ad7d-b78ea2704589","name":"Invalid File format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"file","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Esign Demo/Face Match/Prashant Pan Card P1.jpg"]},{"key":"request","value":" {\n \"templateId\": \"KQJC287934\",\n \"partyDetails\": [\n {\n \"nameOnSignatureStamp\": \"Linus\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"\",\n\"partyId\":\"Party 1\"\n },\n {\n \"nameOnSignatureStamp\": \"Manish\",\n \"locationOnSignatureStamp\": \"Bangalore\",\n \"reasonOnSignatureStamp\": \"Reason\",\n\"partyId\":\"Party 2\"\n }\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/save"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:11:28 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": 0,\n \"message_code\": null,\n \"message\": \"File Name : pdf_file, only pdf documents are supported for E-sign\",\n \"timestamp\": 1668942688877,\n \"error\": \"Input Error\",\n \"success\": false,\n \"txn_id\": \"esign_api_V7DtMCXXXXXXXXXXXXX\"\n}"}],"_postman_id":"82e59dec-0ca7-4cb3-9b3c-6a635348d003"},{"name":"Download eSigned Document via s3","id":"994eb0ad-132e-4f9c-bb3d-75448bdcbe39","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"docId","value":"62ea9b3f-6e7d-4425-8ee4-efb9c23e5205","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/request/document","description":"

The \"Download eSigned Document API\" enables the user to retrieve the eSigned document by the involved parties. To accomplish this, a uniquely generated \"docId\" must be passed as a parameter. This API can be initiated at any point in the user journey. It will retrieve the document, even if it has not been eSigned by all the parties involved. The document is stored as an AWS S3 storage URL, where the downloadable link is accessible.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	docId	String	Required	It is uniquely generated doc ID from setup Document API

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	String	eSigned document details
1.1	url	String	Uniquely generated doc URL which can be downloaded
1.2	expireTimestamp	Integer	It is timestamp in milliseconds which defines the expiry of the generated download document URL
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When eSigned doc link is generated successfully	200	1	success	Successful Request
When document is deleted	200	2	success	Document is deleted	Download failed
When invalid docid is entered	-1	0	failed	Invalid Document Id	Input Error
All other mismatch errors	200	9

","urlObject":{"path":["esign","request","document"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"d6eff5e7-cbf4-4783-aaac-af95e857d105","name":"Download Doc link generated","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"docId","value":"ddc3a4b2-8921-4296-9bba-fda8b8ab70a3","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/request/document"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:19:24 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"url\": \"https://idc-esign-documents.s3.ap-south-1.amazonaws.com/bfaaa120e302b31fb4e3e349f5eb0efd/ddc3a4b2-8921-4296-9bba-fda8b8ab70a3/0.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20221120T111924Z&X-Amz-SignedHeaders=host&X-Amz-Expires=600&X-Amz-Credential=AKIAUSRHKC7E4FQBF7DG%2F20221120%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=a9fd1dda9a5950829832a0196f55a524927eec1dcb72XXXXXXXXXXXXXXXXXXXXXX\",\n \"expireTimestamp\": 1668943764675\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1668943158105,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"esign_api_hIfr4SOXXXXXXXXXXXXXX\"\n}"},{"id":"92cd2c08-4468-4755-86da-dfa09e43bdf8","name":"Invalid Doc ID entered","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"docId","value":"ddc3a4b2-8921-4296-9bba-fda8b8ab70a","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/request/document"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:21:02 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": 0,\n \"message_code\": null,\n \"message\": \"Invalid Document Id\",\n \"timestamp\": 1668943262531,\n \"error\": \"Input Error\",\n \"success\": false,\n \"txn_id\": \"esign_api_JtmRKXXXXXXXXXXX\"\n}"},{"id":"b5b71bbd-1b26-44ae-ae73-0f7650180e82","name":"Document is deleted","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"docId","value":"ddc3a4b2-8921-4296-9bba-fda8b8ab70a","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/request/document"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:21:02 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"message_code\": \"success\",\n \"message\": \"Document is deleted\",\n \"timestamp\": 1707210917965,\n \"error\": \"Download failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"esign_api_drZBUnSi35NkVC2CwjY8\"\n}"}],"_postman_id":"994eb0ad-132e-4f9c-bb3d-75448bdcbe39"},{"name":"Esign Document Status","id":"6d51187d-3504-46c1-8194-6c4dde52d982","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{api-key}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"request","value":"{\n \"docIds\": [\n \"81cc7aa9-8336-4284-bae1-0a6470a5ccad\"\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/document/status","description":"

The \"eSigned Document Status API\" enables the user to inquire about the eSigned status of the document by the involved parties. By using the shared URL, this API provides information of the parties who have eSigned the document and those who have not. To utilize this API, it is necessary to pass the uniquely generated \"docId\" as a parameter.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	request	String	Required	Uniquely generated doc ID from setup Document API is passed

Response:

S. No	Key	Data Type	Description
1	data	Object	Details about the eSigned document
1.1	documentStatusResponse	Array List	Details about parties and their eSigning the document status
1.1.1	docId	String	Uniquely generated doc ID from setup Document AP
1.1.2	signed	Array List	List of parties who have eSigned
1.1.3	pending	Array List	List of parties not who have not eSigned
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if failed then request `failed` due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When eSigned document status is fetched	200	1	success	Successful Request
When invalid docid is entered	-1	0	failed	Invalid Document Id/Ids	Input Error
All other mismatch errors	200	9

","urlObject":{"path":["esign","document","status"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"84b57fcf-efec-4b28-b354-ce1822b168fe","name":"eSign Doc status Fetched successfully","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"request","value":"{\n \"docIds\": [\n \"ddc3a4b2-8921-4296-9bba-fda8b8ab70a3\"\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/document/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:22:17 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"documentStatusResponse\": [\n {\n \"docId\": \"ddc3a4b2-8921-4296-9bba-XXXXXXXXXXXXXX\",\n \"signed\": [],\n \"pending\": [\n \"Party 1\",\n \"Party 2\"\n ]\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1668943337098,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"esign_api_ZLWGIYXXXXXXXXXXXXX\"\n}"},{"id":"239cbf82-5660-42dd-b771-93f93b7078b5","name":"Invalid Doc Id entered","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"request","value":"{\n \"docIds\": [\n \"ddc3a4b2-8921-4296-9bba-fda8b8ab70a\"\n ]\n}","contentType":"application/json","type":"text"}]},"url":"https://api.idcentral.io/idc/esign/document/status"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:29:05 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": 0,\n \"message_code\": null,\n \"message\": \"Invalid Document Id/Ids\",\n \"timestamp\": 1668943745156,\n \"error\": \"Input Error\",\n \"success\": false,\n \"txn_id\": \"esign_api_z8Xz0pJmhXXXXXXXXXX\"\n}"}],"_postman_id":"6d51187d-3504-46c1-8194-6c4dde52d982"},{"name":"Delete eSign","id":"9ae09b7a-f195-42d0-bbfa-5cb49909a2b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Content-Type","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"docId\": \"{{doc_id}}\"\n\n}"},"url":"https://api.idcentral.io/idc/v2/esign/document/delete","description":"

The Delete eSign API allows the user to delete eSign document.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	doc_id	Text	Required	It is uniquely generated doc ID from setup Document API.

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	doc_id	Text	Doc ID given in the request
8.2	is_deleted	Text	Status of deletion request (Possible values are true and false)

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When the document is successfully deleted	200	1	success	Successful Request
When the document was already deleted	200	2	success	Document already deleted	Deletion failed
When deleteion is failed due to invalid docid	200	3	success	Invalid doc_id	Deletion failed
Validation error (Invalid docid)	400	-1	failed	Invalid doc_id	Validation error
Other mismatched errors	200	9	success

","urlObject":{"path":["v2","esign","document","delete"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"2560ebc9-461a-41ef-86c8-ab691421e894","name":"Successful scenario","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"esign_api_v2_IoHj6ARfV5nHzFRZJ1Vz\",\n \"timestamp\": 1707219418756,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"doc_id\": \"c50575b6-680f-4e75-82ed-791c8367b7b6\",\n \"is_deleted\": true\n }\n}"},{"id":"7080fbc4-2038-4d94-98f6-7c9bb4c97f1b","name":"Deletion failed (Already deleted)","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"esign_api_v2_AzQCrYnRfXxzrkvFXr6B\",\n \"timestamp\": 1707219449358,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Deletion failed\",\n \"message\": \"Document already deleted\",\n \"data\": null\n}"},{"id":"d4e82873-fcc0-403e-98e3-44a070c14835","name":"Authentication failed","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"auth_failed_wVUj2WOjvRqnxqpW0Gcv\",\n \"timestamp\": 1707220529351,\n \"status\": \"failed\",\n \"status_code\": 401,\n \"response_code\": 70,\n \"error\": \"Authentication failed\",\n \"message\": \"Please check your credentials\",\n \"data\": null\n}"},{"id":"596d9a3c-1f7f-4e11-80f5-3fbfdea97f8d","name":"Authentication failed (Token Expired)","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"token_expired_NcfnckAgSiDe4511mNJp\",\n \"timestamp\": 1707219673695,\n \"status\": \"failed\",\n \"status_code\": 401,\n \"response_code\": 72,\n \"error\": \"Authentication failed\",\n \"message\": \"Token expired\",\n \"data\": null\n}"},{"id":"f03a2ef6-ff6a-48e0-887b-08e831a0e81a","name":"Deletion failed (Invalid doc_id)","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"esign_api_v2_OaKrZm6Zsfn9ZETyx84q\",\n \"timestamp\": 1707220560140,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Deletion failed\",\n \"message\": \"Invalid doc_id\",\n \"data\": null\n}"},{"id":"9b3d27e4-97c9-4cf7-8d42-8f98eb76ad3a","name":"Validation failed (Invalid docID)","originalRequest":{"method":"DELETE","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}"}],"body":{"mode":"raw","raw":"{\n\n \"doc_id\": \"{{doc_id}}\"\n\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/esign/document/delete"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Fri, 09 Feb 2024 08:39:49 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"esign_api_v2_MJuDeuyuKSoPoSdFieCi\",\n \"timestamp\": 1707219600247,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid doc_id\",\n \"data\": null\n}"}],"_postman_id":"9ae09b7a-f195-42d0-bbfa-5cb49909a2b8"}],"id":"4abd7dc3-8f89-4e86-9123-7a1c2d9d1538","description":"

What is NSDL eSign?

eSign is an online electronic signature service that can facilitate an Aadhaar holder to digitally sign a document. An Aadhaar holder can now sign a document after Biometric/One Time Password authentication thus requiring no paper based application form or documents. eSign Application Service Providers (ASP) like IDcentral, integrate with these services to provide Aadhaar-holders with a way to sign documents electronically. Through eSign services, a Digital Signature Certificate (DSC) can be obtained and an eSign can be affixed within seconds. Authentication of the signer will be carried out by the e-KYC services of UIDAI and on successful authentication, the electronic signature on the document will be ascribed by eSign services of NSDL.

NSDL eSign helps you securely and digitally sign documents via OTP or Fingerprint Biometrics using your Aadhaar.

Prerequisite

You should have eSign access enabled by IDcentral. Please connect with IDC sales team to avail the access. Below details will be configured when giving you an access to eSign API service
1. Document Preview
2. Redirect Url
3. Webhook Endpoint Url
\n
eSign template needs to be created using eSign option from the IDcentral Client Portal

Note: All the involved parties can not eSign the document concurrently. Only one party can eSign the document at a time. Once the signing is completed then only other party can initiate the eSign process. A party needs to complete the eSigning process in 10 min. The session will be expired if not completed within 10m min.

Steps to generate a template on IDcentral Client portal

STEP-1: Visit IDcentral Client Portal and login with your user credentials.
STEP-2: Select eSign option from the menu and select 'create a document template'
STEP-3: Enter below details and click on the next button

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name of the Option	Description
Template Name	Name of the template
esignAuthMode	IDC offers 3 ways in which party can eSign a document. Refer: Modes of eSign definition
Choose Base Document	This is the sample document for the reference purpose. This is not an actual document that will be eSigned. This document will be used to decide on eSign position
Choose Max No Of Parties	IDC supports upto 10 parties which can be involved

STEP-4: After Clicking on the next button, an uploaded document and specified party/parties signatures will be displayed
STEP-5: Drag the signatures of the signing parties & place them at the appropriate places in the document.
STEP-6: When signature is dragged it gives below option.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Name of the option	Description
Current Page	If set, it confirms the eSign will be stamped on the selected page only
Even Page	if set, the eSign will appear on every even page in the document
Odd Page	If set, the eSign will appear on every odd page in the document
All Page	If set, the eSign will appear on every page in the document
Remove All	If set, selected party eSign position and option will be removed

STEP-7: Click on save once STEP-6 are completed. 'Document Template ID' will be created.

Please follow the below steps to avail the NSDL eSign API service.

Step 1: Log on to the IDcentral Client Portal & create your document template using 'Create A Document Template' option of eSign menu. Template ID will be created for the created template.

Step 2: Initiate Setup Document API with the template id, and the details of the signing parties as mandatory parameters. This API generates unique links for all the involved signing parties along with unique docId.

Step 3: Links can be shared with respected parties to be eSigned using Aadhar, based on the set mode of eSign.

Step 3: Initiate the Download eSigned Document API to download the latest version of the document and confirm on status of eSigning by parties. The response also confirms no how many parties have eSigned the document.

Step 4: Once all parties have signed, system will send eSigning confirmation to pre-set webhook URL.

Definition

Post Back / webhook URL: A number of server-to-server calls are made to IDC’s client to keep them updated about the verification status or share details. This allows the clients to keep the request updated on their end, even if the end-user is lost midway through the process.
Redirection URL: URL Redirect is a technique which is used to redirect your domain's visitors to a different URL. You can forward your domain name to any website, webpage, etc. which is available online.
Document Preview: When this option is enabled, it allows party/parties to preview the document to the eSigned after clicking on the uniquely generated eSign URL. If an option is disabled, user is redirected to NSDL page to user authentication after clicking on the link.
Modes of eSign: Modes of eSign term referred as by ways in which party can digitally sign the document. We offer 2 modes of eSigning the document.
- eSign using Aadhaar OTP verification: Using this mode party will be asked to enter the aadhaar number and OTP will be received on the registered mobile number. Once party is validated eSign will be stamped on the document.
- eSign using Aadhaar biometric device: Using this mode party can eSign using biometric device. User will be asked to verify their thumb biometric with given Aadhaar number. Once party is validated eSign will be stamped on the document.
- You can allow your users to sign document by mode of their preference from above.
\n
Party: Party can be referred as Person / Business entity /Authorised signatory who are authrised to eSign a document.

\n","_postman_id":"4abd7dc3-8f89-4e86-9123-7a1c2d9d1538"},{"name":"PAN","item":[{"name":"PAN Details *","id":"3d6277f1-0b67-4e54-a811-19a21ebee306","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-details","description":"

*IMPORTANT: This API is expected to be deprecated soon.

The PAN details API is used to retrieve basic demographic information of a PAN cardholder. This API requires the input of the PAN number to fetch the details.

The PAN Status Code indicates the current status of the PAN card. It reflects whether the PAN card is valid or invalid, or if it has been blocked due to misconduct or reported as deceased. The possible values and their meanings are as follows:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status Code	Meaning
E	Valid
F	Fake
X	Deactivated
D	Deleted
N	Invalid
EA	Amalgamation
EC	Acquisition
ED	Death
EI	Dissolution
EL	Liquidated
EM	Merger
EP	Partition
ES	Split
EU	Under Liquidation
I	Inoperative

Aadhaar Seeding Status - Possible Values & Meaning

This API provides real-time validation of the linking or seeding status of a given PAN number as per the circular issued by the Central Board of Direct Taxes (CBDT) in India in 2022. The circular mandates individuals who have been allotted PAN numbers to link them with their Aadhaar numbers. By using this API, the user can instantly verify the status of such linking or seeding for a particular PAN number.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Aadhar Seeding Status Code	Meaning
Y	Seeding Successful
R	Seeding Unsuccessful
Blank	Not Seeded
NA	Not Applicable

Type of Holder Code - Possible values and meaning

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Type of Holder code	Meaning
P	Individual
C	Company
H	Hindu Undivided Family (HUF)
A	Association of Persons(AOP)
B	Body of Individuals(BOI)
G	Government Agency
J	Artificial Juridical Person
L	Local Authority
F	Firm/ Limited Liability Partnership
T	Trust

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	name	String	PAN card holder's name as registered in NSDL database
8.2	number	String	PAN card Number
8.3	type_of_holder	String	Category of taxpayer as registered with NSDL - Business/ Person
8.4	type_of_holder_code	String	Category of PAN - Code
8.5	is_individual	String	The PAN Category API can be used to determine the category of a PAN, which confirms whether the PAN belongs to an individual or a business. If the API returns \"true\", then the PAN belongs to an individual, and if it returns \"false\", then the PAN belongs to a business.
8.6	is_valid	String	This verifies the existence of a PAN number. If the returned value is \"true,\" it indicates that the PAN number is valid. If the value is \"false,\" it indicates that the PAN number is invalid
8.7	first_name	String	First name of the PAN card holder
8.8	middle_name	String	Middle name of the PAN card holder
8.9	last_name	String	Last name of the PAN card holder
8.10	title	String	Title (Mr/Ms/Mrs/Sri)
8.11	pan_status	String	Valid or Invalid
8.12	pan_status_code	String	PAN status code. Refer: Pan Status Code - Possible Values & Meaning
8.13	aadhaar_seeding_status	String	Aadhaar-PAN seeding status. This field confirms if Aadhaar-PAN is linked or not. Refer: Aadhar Seeding Status - Possible Values & Meaning
8.14	aadhaar_seeding_status_code	String	Aadhaar- PAN seeding status code. Refer: Aadhar Seeding Status - Possible Values & Meaning
8.15	last_updated_on	String	A date when PAN details were last updated

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN is entered	200	1	success	Successful Request
When Incorrect PAN is entered	200	2	success	The given PAN number is invalid	Verification failed
All other mismatch errors	200	9
When Invalid / no PAN is passed	400	-1	failed	Please provide a valid PAN number	Validation error

","urlObject":{"path":["v2","pan","pan-details"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"bbee7cb7-003c-441f-a493-82a9f44e5069","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"{{pan_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 09:37:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_nHZSlAXXXXXXXXXX\",\n \"timestamp\": 1665567453783,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"name\": \"XXXXXX XXXXXX D\",\n \"number\": \"XXXXXXXXXX\",\n \"type_of_holder\": \"Individual or Person\",\n \"type_of_holder_code\": \"P\",\n \"is_individual\": \"true\",\n \"is_valid\": \"true\",\n \"first_name\": \"XXXXX\",\n \"middle_name\": \"XXXXX\",\n \"last_name\": \"XXXXXX\",\n \"title\": \"Shri\",\n \"pan_status\": \"VALID\",\n \"pan_status_code\": \"E\",\n \"aadhaar_seeding_status\": \"Successful\",\n \"aadhaar_seeding_status_code\": \"Y\",\n \"last_updated_on\": \"12/07/2017\"\n }\n}"},{"id":"d29e7785-fad6-400e-b30a-2e874001e7eb","name":"Empty PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-details"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 09:38:50 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_8NhdVwYlIi5bM9KZyItM\",\n \"timestamp\": 1665567531188,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"e9561bd6-5a1a-4d08-bfd0-32dde6dd997c","name":"Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"{{pan_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 09:39:40 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_NG6t9KrKhx2Mrwr1JWhh\",\n \"timestamp\": 1665567580180,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": null\n}"},{"id":"676eb03a-fce5-4218-8e47-66309c674b22","name":"Invalid PAN - Length","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"AHXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-details"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 09:40:59 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_hR7QbB5LRCVZUchVPYKG\",\n \"timestamp\": 1665567659164,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"}],"_postman_id":"3d6277f1-0b67-4e54-a811-19a21ebee306"},{"name":"PAN to Name *","id":"734eb8f4-61ee-421b-b2bf-0880f9a0db78","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"{{pan_number}}\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-name","description":"

*IMPORTANT: This API is expected to be deprecated soon.

The PAN to Name API allows you to retrieve the name of the PAN card holder by providing their unique PAN number.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	pan_number	String	PAN Number
8.2	full_name	String	PAN card holder full name as per the PAN records
8.3	category	String	Category of taxpayer as registered with NSDL. (eg. Business / Person)

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN details are entered	200	1	success	Successful Request
When incorrect PAN number is enetered	200	2	success	The given PAN number is invalid	Verification failed
Invalid PAN is entered	400	-1	failed	Please provide a valid PAN number	Validation error
All other mismatch errors	200	9

","urlObject":{"path":["v2","pan","pan-name"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f8377131-ee20-49f7-99d8-c4a6b9db5739","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{APIKey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"{{pan_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-name"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:42:41 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_to_name_KKrjYULwMrGd3U2gAns0\",\n \"timestamp\": 1665556960587,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"AXXXXXXXX\",\n \"full_name\": \"XXXXXXXX XXXXXXX XXXXXXX\",\n \"category\": \"Individual or Person\"\n }\n}"},{"id":"37bc0bfa-6cf5-4458-b9d2-3a65200b2d2e","name":"Invalid PAN Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"AYHXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-name"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:43:19 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_to_name_LbEy4cUdnuD7QbyFgREQ\",\n \"timestamp\": 1665556999614,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": null\n}"},{"id":"84643236-93c8-4d75-aaa2-80db0ee3638e","name":"Invalid PAN - Validaiton","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"AYHXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-name"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:44:27 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_to_name_b00KVdtKlIgWKjf3D2ty\",\n \"timestamp\": 1665557067846,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"}],"_postman_id":"734eb8f4-61ee-421b-b2bf-0880f9a0db78"},{"name":"PAN KRA Verification","id":"c0357090-6c72-444f-9d60-5bec57f13c59","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"XXXXXXXXXXX\"\r\n\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-kra","description":"

The PAN KRA Verification API is designed to facilitate the PAN Card KRA (KYC Registration Agency) verification process. This API helps you check whether a given PAN number is already available with the KRA database or not. By passing the PAN number as a request value, you can instantly verify the KRA status of the PAN cardholder.

KRA stands for KYC Registration Agency, which was introduced by SEBI (Securities and Exchange Board of India) to bring uniformity in the KYC (Know Your Customer) process and eliminate duplication of records. As per SEBI guidelines of 2011, investors who wish to invest in mutual funds or become KYC compliant must register with one of the authorized agencies. Once registered or KYC compliant, investors can start investing in mutual funds.

The PAN KRA Verification API streamlines the verification process by allowing the user to quickly and easily check the KRA status of a PAN cardholder, enabling smooth KYC compliance and mutual fund investment.

There are 5 KYC Registration agencies.

www.google.com

CVL KRA
\n
CAMS KRA
\n
Karvy KRA
\n
NSDL KRA
\n
NSE KRA
\n

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\", it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	pan_number	String	PAN Number passed in request
8.2	pan_kra_status	String	This key field confirms whether the given PAN number is KRA compliant or not. If the value is \"True,\" it means that the PAN is KRA compliant. If the value is \"False,\" it means that the PAN is not KRA compliant.
8.3	pan_kra_agency	String	This key field confirms the name of the KRA authorized agency if the pan_kra_status is \"True\". If pan_kra_status is \"False\", this key field shows null.

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	KRA Status	Error
When valid KRA linked PAN is entered	200	1	success	Successful request	True
When invalid PAN is entered	200	2	success	PAN not registered	False	Verification failed
When valid non KRA linked PAN is entered	200	5	success	PAN not registered		KYC rejected
When incorrect PAN format is entered	400	-1	failed	Please provide a valid PAN number		Validation error
All other mismatch errors	200	9

","urlObject":{"path":["v2","pan","pan-kra"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"16d09492-c7aa-47b0-8ef4-01ef7c7b44c6","name":"KRA Registered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"AXZPV5062B\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-kra"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 19 Jan 2023 04:57:39 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_kra_oy4FELz3qcpPGorvJkDx\",\n \"timestamp\": 1674104256420,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"KYC registered\",\n \"data\": {\n \"pan_number\": \"AXZXXXXXXX\",\n \"pan_kra_status\": \"True\",\n \"pan_kra_agency\": \"NDML KRA\"\n }\n}"},{"id":"55715087-0618-45e5-9c67-db733717ca02","name":"PAN Not Registered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"AXZXXXXXXXX\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-kra"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:53:54 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_kra_aqI8OvteufozKdn4X8hH\",\n \"timestamp\": 1665557630626,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"KYC rejected\",\n \"message\": \"PAN not registered\",\n \"data\": null\n}"},{"id":"9146e1c5-5c53-4d2e-8ff6-08382efa4472","name":"Invalid PAN Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-kra"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:55:07 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_kra_3teLCJC5YCH64u1RWaAS\",\n \"timestamp\": 1665557707866,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"028020b6-906e-4862-b423-712815567f4d","name":"KYC Rejected","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-kra"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 07:00:06 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_kra_pYduN8VD1QQkPkAD9iRf\",\n \"timestamp\": 1665558002227,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"KYC rejected\",\n \"message\": \"PAN not registered\",\n \"data\": null\n}"}],"_postman_id":"c0357090-6c72-444f-9d60-5bec57f13c59"},{"name":"PAN Verification","id":"5a3fbe81-fba8-4621-9202-dcd7402a1889","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{ \"dob\": \"1999-08-11\", \"full_name\": \"XXXX XXXXX\", \"id_number\": \"{{pan_number}}\"}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify","description":"

The PAN verification API is a reliable method to authenticate a PAN card number using the database of the government issuing authority. To use this API, the end user must provide the PAN card's unique number, full name, and date of birth. The API will only verify the PAN card successfully if the three input values provided by the user are valid as per the PAN card records.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	id_number	String	Required	The unique PAN Card number
2	dob	String	Required	Date of Birth as per the PAN card (YYYY-MM-DD) format
3	full_name	String	Required	Full Name of the PAN Holder as per PAN card

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	client_id	String	A uniquely generated reference ID
8.2	pan_number	String	The unique PAN Number
8.3	full_name	String	Full Name of the PAN Holder as per the request
8.4	dob	String	Date of Birth of the PAN Holder as per the request

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid details are passed and matched	200	1	success	Successful request
When valid details do not match	200	2	success	The details provided aren't matching the records	Verification failed
When no DOB value is passed	400	-1	failed	Date of birth should not be null	Validation error
When invalid PAN is entered	400	-1	failed	Please provide a valid PAN number	Validation error
When invalid DOB is entered	400	-1	failed	Please provide a valid date of birth in YYYY-MM-DD format	Validation error
When full_name value is not entered	400	-1	failed	PAN holder full name should not be null	Validation error
When invalid full_name value is entered	400	-1	failed	Please provide a valid name of the PAN holder	Validation error
When invalid PAN number is entered	400	-1	failed	Please provide a valid PAN number	Validation error
All other response code	200	9

","urlObject":{"path":["v2","pan","pan-verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"0bc91544-da53-4f04-98d5-6078e8910141","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{APIKey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\",\"dob\":\"19XX-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:31:53 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_STEdvxdk3bpELgryX2E2\",\n \"timestamp\": 1665556313757,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"XXXXXXXXXX\",\n \"full_name\": \"RAHUL XXXXXXXX XXXX\",\n \"dob\": \"19XX-XX-XX\"\n }\n}"},{"id":"cd90a4f7-37e0-4c7b-a8d0-72c9e47be8c9","name":"Not Matching Records","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\",\"dob\":\"19XX-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 11 Oct 2022 11:47:55 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_H8pIDfy8dsaKcdK3LIPD\",\n \"timestamp\": 1665488875399,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The details provided aren't matching the records\",\n \"data\": null\n}"},{"id":"8c7b96f3-eb0d-4acd-93fb-bc956088bdd1","name":"Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\",\"dob\":\"19XX-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:25:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_RryiCX6JAMcyUTCSPkAG\",\n \"timestamp\": 1665555913618,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"27f6a703-6255-4ccd-a135-0acc9fabe73c","name":"Invalid Date Format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXX\",\"dob\":\"19-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:26:42 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_HjQIaJyhK5NKB2HUyZjA\",\n \"timestamp\": 1665556002082,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid date of birth in YYYY-MM-DD format\",\n \"data\": null\n}"},{"id":"1d98ad56-b76a-4642-903a-4b7f385b2465","name":"DOB Not Provided","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXX\",\"dob\":\"\",\"full_name\":\"DESIMRAN CARTONS PRIVATE LIMITED\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:27:27 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_SPcL0yAzd8hUE361Fo60\",\n \"timestamp\": 1665556048793,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Date of birth should not be null\",\n \"data\": null\n}"},{"id":"5e5688fb-160c-4e66-aec2-db5b0eba7c26","name":"Invalid PAN Name","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXX\",\"dob\":\"2002-10-21\",\"full_name\":\"123 CARTONS PRIVATE LIMITED\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:28:18 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_oSBIkD7BtMnXblp2gsyY\",\n \"timestamp\": 1665556098637,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid name of the PAN holder\",\n \"data\": null\n}"},{"id":"71ae1308-d568-41e2-83a9-cd30d38eeb18","name":"Full_Name Not Provided","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXXX\",\"dob\":\"2002-10-21\",\"full_name\":\"\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:30:22 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_YFx8Jdny7t7OMyLOi9u9\",\n \"timestamp\": 1665556222294,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"PAN holder full name should not be null\",\n \"data\": null\n}"},{"id":"d18c549b-7bcf-44a8-b2ae-2ee209ff3820","name":"Details Don't Match","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"XXXXXXXXXXXX\",\"dob\":\"19XX-02-XX\",\"full_name\":\"XXXXXXXX XXXXXXXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:34:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_tCasijZtNtigNfhxmTvr\",\n \"timestamp\": 1665556455581,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The details provided aren't matching the records\",\n \"data\": null\n}"},{"id":"14d8ea2b-5400-4e10-b70f-b76f6d619ec2","name":"PAN Not Provided","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"\",\"dob\":\"19XX-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 06:51:42 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_S88KmCCLrdEG81hcoUeh\",\n \"timestamp\": 1665557502537,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"4793f8c6-1768-4758-a61d-aa8c3b359ca4","name":"PAN Number Not Provided","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"id_number\":\"\",\"dob\":\"19XX-XX-XX\",\"full_name\":\"RXXXXX KXXXX SXXX\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 12 Oct 2022 09:45:52 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"indian_pan_verification_TzgmQqgwjQEuWlxKQkq6\",\n \"timestamp\": 1665567952632,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"}],"_postman_id":"5a3fbe81-fba8-4621-9202-dcd7402a1889"},{"name":"PAN Verify Plus","id":"aa2617ed-0e1a-4b84-ae53-4b3eee6c0f67","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus","description":"

The PAN Verify Plus API is a reliable method to authenticate a PAN card number using the database of the government issuing authority. To use this API, the user must provide the PAN card's unique number, full name, and date of birth. The API verifies if the name and D.O.B given in request for the provided PAN number matches the government record (name on card or as per records). Additionally it also provide the pan status and Aadhaar seeding status.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	id_number	String	Required	The unique PAN Card number
2	dob	String	Required	Date of Birth as per the PAN card (YYYY-MM-DD) format *For non individuals enter Date of Incorporation here.
3	full_name	String	Required	Full name of the PAN holder (concatenation of first name, middle name, last name) OR Name on card (name printed on physical PAN card) _{Example: If firstname:Pansy middlename: M lastname: Meyer AND Name on Card(Name printed on physical card) is P Meyer It accepts \"Pancy M Meyer\" or \"P Meyer\" as input.}
4	father_name	String	Optional	father name as per records

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	name	String	MATCHING or NOT-MATCHING considering input name and name as per records. (name on card or as per records)
8.2	number	String	The unique PAN number
8.3	pan_status	String	The status of the given PAN number. [Possible Values: 1. EXISTING AND VALID 2. MARKED AS FAKE 3. MARKED AS DEACTIVATED 4. DELETED 5. INVALID PAN/ RECORD NOT FOUND IN ITD DATA 6. EXISTING AND VALID BUT EVENT MARKED AS AMALGAMATION IN ITD DATABASE 7. EXISTING AND VALID BUT EVENT MARKED AS ACQUISITION IN ITD DATABASE 8. EXISTING AND VALID BUT EVENT MARKED AS DEATH IN ITD DATABASE 9. EXISTING AND VALID BUT EVENT MARKED AS DISSOLUTION IN ITD DATABASE 10. EXISTING AND VALID BUT EVENT MARKED AS LIQUIDATED IN ITD DATABASE 11. EXISTING AND VALID BUT EVENT MARKED AS MERGER IN ITD DATABASE 12. EXISTING AND VALID BUT EVENT MARKED AS PARTITION IN ITD DATABASE 13. EXISTING AND VALID BUT EVENT MARKED AS SPLIT IN ITD DATABASE 14. EXISTING AND VALID BUT EVENT MARKED AS UNDER LIQUIDATION IN ITD DATABASE ]
8.4	date_of_birth	String	MATCHING or NOT-MATCHING considering input D.O.B and D.O.B as per records.
8.5	aadhaar_seeding_status	String	Provides the aadhar seeding status of the given PAN number [Possible Values: 1. Y - ( for OPERATIVE PAN) 2. R - ( for INOPERATIVE PAN) 3. NA - ( for NON-INDIVIDUAL PAN) ]

Scenarios Covered:

Scenario	Status Code	Response Code	Status	Message	Error
When valid details are provided in the request and are matching	200	1	success	Successful request
When PAN number entered is invalid	200	2	success	The given PAN number is invalid	Verification failed
PAN status issue	200	3	success	{{data.pan_status}}	Verification failed
Name not matching	200	4	success	Name is not matching	Verification failed
DOB is not matching	200	5	success	DOB is not matching	Verification failed
Father name not matching (for PAN numbers in DCT catergory)	200	6	success	Father name is not matching	Verification failed
Aadhaar not seeded	200	7	success	Aadhaar not seeded	Verification failed
Multiple field mismatch	200	8	success	Multiple fields are mismatching	Verification failed
Invalid PAN	400	-1	failed	Please provide a valid PAN number	Validation error
Invalid D.O.B format	400	-1	failed	Please provide a valid date of birth in YYYY-MM-DD format	Validation error
Invalid PAN holder name	400	-1	failed	Please provide a valid name of the PAN holder	Validation error
Empty D.O.B	400	-1	failed	Date of birth should not be null	Validation error
Empty PAN holder name	400	-1	failed	PAN holder full name should not be null	Validation error
All other response code	200	9	success		Mismatch error

","urlObject":{"path":["v2","pan","pan-verify-plus"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"8b89b315-a80b-425f-b6a3-b0ebd797fd50","name":"Successful scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_o9W8qE7qiOXLPCfAiFB5\",\n \"timestamp\": 1712829887816,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"name\": \"MATCHING\",\n \"number\": \"XXXXXXXXXX\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"MATCHING\",\n \"aadhaar_seeding_status\": \"Y\",\n \"father_name\": null\n }\n}"},{"id":"eaa9afb6-78ee-4728-bd04-6ed280263556","name":"Verification failed - Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_wcaaNN1LboieU8WHuOWe\",\n \"timestamp\": 1712829979480,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": {\n \"name\": null,\n \"number\": null,\n \"pan_status\": null,\n \"date_of_birth\": null,\n \"aadhaar_seeding_status\": null,\n \"father_name\": null\n }\n}"},{"id":"2113999c-98ac-4138-91d3-165d6b3436b2","name":"Verification failed - Name Not Matching","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_yU13wMYNV2dzxct7bnfTT\",\n \"timestamp\": 1712830141462,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 4,\n \"error\": \"Verification failed\",\n \"message\": \"Name is not matching\",\n \"data\": {\n \"name\": \"NOT-MATCHING\",\n \"number\": \"XXXXXXXXXX\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"MATCHING\",\n \"aadhaar_seeding_status\": \"Y\",\n \"father_name\": null\n }\n}"},{"id":"c43bb4d2-825a-4772-a65e-87ae0c5bbac6","name":"Verification failed - D.O.B Not Matching","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcidc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_OFORUCQMzTTVqlznw7EN\",\n \"timestamp\": 1712830017710,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"error\": \"Verification failed\",\n \"message\": \"DOB is not matching\",\n \"data\": {\n \"name\": \"MATCHING\",\n \"number\": \"XXXXXXXXXX\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"NOT-MATCHING\",\n \"aadhaar_seeding_status\": \"Y\",\n \"father_name\": null\n }\n}"},{"id":"5a39e10c-169b-4906-b375-7f4f2ee0f50d","name":"Verification failed - Aadhaar not seeded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcidc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_VTmyHerkTjqGHAJ2v4Fo\",\n \"timestamp\": 1712831451764,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 7,\n \"error\": \"Verification failed\",\n \"message\": \"Aadhaar not seeded\",\n \"data\": {\n \"name\": \"MATCHING\",\n \"number\": \"XXXXXXXXXXX\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"MATCHING\",\n \"aadhaar_seeding_status\": \"R\",\n \"father_name\": null\n }\n}"},{"id":"85d00ece-8dcf-453a-acb1-45fb135e88de","name":"Verification failed - Aadhaar not seeded - Commercial PAN","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcidc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_VTmyHerkTjqGHAJ2v4Fo\",\n \"timestamp\": 1712831451764,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 7,\n \"error\": \"Verification failed\",\n \"message\": \"Aadhaar not seeded\",\n \"data\": {\n \"name\": \"MATCHING\",\n \"number\": \"XXXXXXXXXXX\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"MATCHING\",\n \"aadhaar_seeding_status\": \"NA\",\n \"father_name\": null\n }\n}"},{"id":"a29c26b5-2ae2-4077-84ea-9d835a3775a6","name":"Verification failed - Multiple Mismatches","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_vB1MkZzzH2xxpKzNiK7g\",\n \"timestamp\": 1712831881318,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 8,\n \"error\": \"Verification failed\",\n \"message\": \"Multiple fields are mismatching\",\n \"data\": {\n \"name\": \"NOT-MATCHING\",\n \"number\": \"AHTPH3949R\",\n \"pan_status\": \"EXISTING AND VALID\",\n \"date_of_birth\": \"NOT-MATCHING\",\n \"aadhaar_seeding_status\": \"R\",\n \"father_name\": null\n }\n}"},{"id":"5c86f7a2-9206-4d82-a047-1b96638ebe8a","name":"Validation error - Invalid PAN number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcidc/v2/pan/pan-verify-plus"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_Uyf0AMvdz9lZefm2lfVS\",\n \"timestamp\": 1712830445286,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"},{"id":"4781cea3-4506-45a6-a383-738f7504d0e5","name":"Validation error - Invalid D.O.B","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idcidc/v2/pan/pan-verify-plus"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_D6KnhN5thCxx5IdAafwr\",\n \"timestamp\": 1712830808294,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid date of birth in YYYY-MM-DD format\",\n \"data\": null\n}"},{"id":"39938420-867e-4e85-9d98-5f79f2793279","name":"Validation error - Invalid Name","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"XXXXXXXXXXX\",\n \"dob\": \"YYYY-MM-DD\",\n \"full_name\": \"XXXXXXX XXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-verify-plus"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Language","value":"en"},{"key":"Content-Length","value":"1115"},{"key":"Date","value":"Thu, 11 Apr 2024 09:04:59 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_verify_plus_v2_ApnOY3GN0KiqnmXcvbj8L\",\n \"timestamp\": 1712830548293,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid name of the PAN holder\",\n \"data\": null\n}"}],"_postman_id":"aa2617ed-0e1a-4b84-ae53-4b3eee6c0f67"},{"name":"PAN Extended V2","id":"bedfb2f0-164c-4a7c-8931-aa9675b430a8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended","description":"

The PAN Extended (V2) API is used to retrieve basic demographic information of a PAN cardholder. This API requires the input of the PAN number to fetch the details. It also gives us the details of whether aadhaar is linked or not, and masked aadhaar number linked to the particular PAN.
Note: This API works for PAN card that belong to category Person and Firm.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response:

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	pan_number	String	PAN card Number
8.2	full_name	String	Full name of the PAN Card holder
8.3	name	Object	The name of the PAN card holder separated as full name, middle name and last name.
8.3.1	first_name	String	First name of the PAN card holder as per records.
8.3.2	middle_name	String	Middle name of the PAN card holder as per records if any.
8.3.3	last_name	String	The last name of PAN card holder as per records.
8.4	doi	String	Date of incorporation of the entered PAN card.
8.5	father_name	String	Father's name of the PAN card holder as per records for PAN card.
8.6	gender	String	Gender of the PAN card holder as 'M' or 'F'.
8.7	category	String	Category of the PAN card, stating the card is 'Person' or \"Firm\".
8.8	masked_aadhaar	String	Masked aadhaar number of the aadhaar linked to PAN card given as per request.
8.9	aadhaar_linked	String	gives 'true' or 'false' confirming if the aadhaar is linked to PAN card.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN is entered - For Person	200	1	success	Successful request
When valid PAN is entered - For Firm	200	2	success	Successful request
Invalid PAN number entered	200	3	success	The given PAN number is invalid	Verification failed
All other mismatches	200	9

","urlObject":{"path":["v2","pan","pan-extended"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"3fbc32c7-fc8e-4ac1-b577-1841515c8203","name":"Successful Request - Person","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"299"},{"key":"Date","value":"Thu, 09 May 2024 09:56:17 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_v2_XLXbEge8wu9ZBWxxxx6F\",\n \"timestamp\": 1715246859833,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"XXXXXXXXXX\",\n \"full_name\": \"KXXXXXX SXXXXX GXXXX DXXXXXXXXXXXX\",\n \"name\": {\n \"first_name\": \"KXXXXXX\",\n \"middle_name\": \"SXXXXX GXXXX\",\n \"last_name\": \"DXXXXXXXXXXXX\"\n },\n \"doi\": \"\",\n \"father_name\": \"SXXXXX GXXXX KXXXXXX MXXXXXX GXXXX\",\n \"gender\": \"MALE\",\n \"category\": \"Person\",\n \"masked_aadhaar\": \"33XXXXXXXX22\",\n \"aadhaar_linked\": \"true\"\n }\n}"},{"id":"9e70564f-3435-4ef3-a4bd-e807d6280bc9","name":"Successful Request - Firm","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"299"},{"key":"Date","value":"Thu, 09 May 2024 09:56:17 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_v2_Oeqko71fkuhwxxxxxx4lS\",\n \"timestamp\": 1715246996457,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"XXXFXXXXXX\",\n \"full_name\": \"SXXXX XXXXXX LXX\",\n \"name\": {\n \"first_name\": \"\",\n \"middle_name\": \"\",\n \"last_name\": \"SXXXX XXXXXX LXX\"\n },\n \"doi\": \"\",\n \"father_name\": \"\",\n \"gender\": \"\",\n \"category\": \"Firm\",\n \"masked_aadhaar\": \"\",\n \"aadhaar_linked\": \"false\"\n }\n}"},{"id":"f334d202-169d-44b4-abe6-badb00a58cd6","name":"Verification Failed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"299"},{"key":"Date","value":"Thu, 09 May 2024 09:56:17 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_v2_8ezpzAu9tfSfxxxxx6e9R\",\n \"timestamp\": 1715247046058,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": null\n}"}],"_postman_id":"bedfb2f0-164c-4a7c-8931-aa9675b430a8"},{"name":"PAN Extended PLUS","id":"78952ceb-8d5e-4cb7-8a16-1c145af64dff","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended-plus","description":"

The PAN Extended Plus API is a newer version for PAN extended API. This API requires the input of the PAN number to fetch the details. By entering the PAN number as input you get the full name of PAN holder, along with d.o.b.
Note: This API works for PAN card that belong to category Person and Firm.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response:

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	pan_number	String	PAN card Number
8.2	full_name	String	Full name of the PAN card holder
8.3	name	Object	The name of the PAN card holder separated as full name, middle name and last name.
8.3.1	first_name	String	First name of the PAN card holder as per records.
8.3.2	middle_name	String	Middle name of the PAN card holder as per records if any.
8.3.3	last_name	String	The last name of PAN card holder as per records.
8.4	dob	String	DOB of the PAN card holder
8.5	father_name	String	Father's name of the PAN card holder as per records for Personal PAN card.
8.6	gender	String	Gender of the PAN card holder as 'M' or 'F', for personal PAN card.
8.7	category	String	Category of the PAN card, stating the Card is 'Person' or \"Firm\".

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN is entered - For Person	200	1	success	Successful request
When valid PAN is entered - For Firm	200	2	success	Successful request
Invalid PAN number entered	200	3	success	The given PAN number is invalid	Verification failed
All other mismatches	200	9

","urlObject":{"path":["v2","pan","pan-extended-plus"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"5cf22d29-4676-45aa-b671-75f3bf297ef4","name":"Successful Request - Person","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"304"},{"key":"Date","value":"Thu, 09 May 2024 10:06:14 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_plus_v2_MWGzfOQpXXXXXnpywSR2V\",\n \"timestamp\": 1715247250223,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"XXXXXXXXXX\",\n \"full_name\": \"KXXXXX SXXXXX GXXXXX DXXXXXXXXX\",\n \"name\": {\n \"first_name\": \"KXXXXX\",\n \"middle_name\": \"SXXXXX GXXXXX\",\n \"last_name\": \"DXXXXXXXXX\"\n },\n \"dob\": \"YYYY-MM-DD\",\n \"father_name\": \"SXXXXX GXXXXX KXXXXX MXXXXXX GXXXXX\",\n \"gender\": \"MALE\",\n \"category\": \"Person\"\n }\n}"},{"id":"c46ce0c9-13d2-4dca-9904-5c4ecea31fe3","name":"Successful Request - Firm","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"304"},{"key":"Date","value":"Thu, 09 May 2024 10:06:14 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_plus_v2_8lAm0xxxxxzGFc5K9pAKE0\",\n \"timestamp\": 1715247255057,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"pan_number\": \"XXXFXXXXXX\",\n \"full_name\": \"SXXXX DXXXXX LXX\",\n \"name\": {\n \"first_name\": \"\",\n \"middle_name\": \"\",\n \"last_name\": \"SXXXX DXXXXX LXX\"\n },\n \"dob\": \"YYYY-MM-DD\",\n \"father_name\": \"\",\n \"gender\": \"\",\n \"category\": \"Firm\"\n }\n}"},{"id":"607e8d80-7304-4793-b2e2-5c5a21a1c6f0","name":"Verification Failed - Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-extended-plus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"304"},{"key":"Date","value":"Thu, 09 May 2024 10:06:14 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_extended_plus_v2_ZG3vv2dcqdXXXXX2vBm\",\n \"timestamp\": 1715247258920,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": null\n}"}],"_postman_id":"78952ceb-8d5e-4cb7-8a16-1c145af64dff"},{"name":"PAN Contacts V2","id":"5fd0bed5-ead3-47df-8242-9814b531144a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts","description":"

This new PAN API helps in retrieving contact details of Person/Company, by providing the PAN number. The API response gives, address, mobile number and email-id associated with the PAN number in the request.

Note: This API works for PAN card that belong to category Person and Firm.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	id_number	String	Required	Unique PAN Number

Response:

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	gender	String	Gender of the PAN card holder as 'M' or 'F', for personal PAN card.
8.2	dob	String	DOB/DOI associated with the PAN card.
8.3	address	Object	Detailed address associated with the PAN entered.
8.3.1	address_line_1	String	Name/ Building Number
8.3.2	address_line_2	String	Detailed road information
8.3.3	address_line_3	String	Other address informations
8.3.4	address_line_4	String	City/Town
8.3.5	address_line_5	String	Other address information
8.3.6	pin_code	String	Postal code from the address
8.3.7	state	String	State as per address
8.4	pan_number	String	PAN card Number
8.5	first_name	String	First name of the PAN card holder as per records.
8.6	middle_name	String	Middle name of the PAN card holder as per records if any.
8.7	last_name	String	The last name of PAN card holder as per records.
8.8	full_name	String	Full name of the PAN card holder
8.9	email_id	String	email_id associated with the entered PAN number.
8.10	mobile_number	String	Mobile Number associated with the PAN number
8.11	masked_aadhaar	String	Masked aadhaar number linked to the given PAN
8.12	aadhar_link	String	true/ false indicating whether aadhaar is linked to the PAN.
8.13	tax	String	true/false indicating tax payment status

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN is entered - For Person	200	1	success	Successful request
When valid PAN is entered - For Company	200	1	success	Successful request
Invalid PAN number entered	200	2	success	The given PAN number is invalid	Verification failed
Inactive PAN number entered	200	3	success	The given PAN number is inactive	Verification failed
When No records found	200	4	success	No records found for the given PAN number	Verification failed
Validation error	400	-1	failed	Please provide a valid PAN number	Validation error
All other mismatches	200	9	success		Mismatch error

","urlObject":{"path":["v2","pan","pan-contacts"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"cc669716-2f38-4b45-b89c-c2e8bb405bac","name":"Successful Request - Person","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_contacts_v2_o6SeIhmEI9XyrJNw\",\n \"timestamp\": 1717137028623,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"gender\": \"M\",\n \"dob\": \"YYYY-MM-DD\",\n \"address\": {\n \"address_line_1\": \"Xxx xxxx xxxxx \",\n \"address_line_2\": \"Xxxx Xxxxx\",\n \"address_line_3\": \"Mumbai\",\n \"address_line_4\": \"MUMBAI\",\n \"address_line_5\": \"Aareymilk Colony S.O\",\n \"pin_code\": \"400065\",\n \"state\": \"Maharashtra\"\n },\n \"pan_number\": \"XXXXXXXXXX\",\n \"first_name\": \"XXXXX\",\n \"middle_name\": \"\",\n \"last_name\": \"XXXXX\",\n \"full_name\": \"XXXXX XXXXX\",\n \"email_id\": \"kxxx.kxxxxx@gmail.com\",\n \"mobile_number\": \"7xxxxxxxxx\",\n \"masked_aadhaar\": \"XXXXXXXX7357\",\n \"aadhar_link\": \"true\",\n \"tax\": \"true\"\n }\n}"},{"id":"949ff0c1-e505-43e3-a996-5cb5444a7959","name":"Successful Request - Company","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_contacts_v2_nsAxS8arTrbam1l1s2YR\",\n \"timestamp\": 1717137065106,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"gender\": \"\",\n \"dob\": \"YYYY-MM-DD\",\n \"address\": {\n \"address_line_1\": \"1xx XXXX XXXX/XX\",\n \"address_line_2\": \"1st Main Road, Kuxxxxxu Nxxxxx\",\n \"address_line_3\": \"Dxxxxxxxa, Kaxxxxxxxa Main Road\",\n \"address_line_4\": \"BANGALORE\",\n \"address_line_5\": \"\",\n \"pin_code\": \"560062\",\n \"state\": \"Karnataka\"\n },\n \"pan_number\": \"XXXXXXXXX\",\n \"first_name\": \"\",\n \"middle_name\": \"\",\n \"last_name\": \"\",\n \"full_name\": \"FXXXXX XXXXXX XXXXXXT PRIVATE LIMITED\",\n \"email_id\": \"asxxxxx.dxxxxxx@txxxxxxxx.in\",\n \"mobile_number\": \"8XXXXXXXXX\",\n \"masked_aadhaar\": \"\",\n \"aadhar_link\": \"false\",\n \"tax\": \"true\"\n }\n}"},{"id":"6f36d45f-8a48-4991-b058-49207052e832","name":"Verification Failed - Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_contacts_v2_ZQ7x3O0E8OduIdWEogh8\",\n \"timestamp\": 1717137100406,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is invalid\",\n \"data\": null\n}"},{"id":"39789d51-06a3-43ad-9a4f-0e37417c6946","name":"Verification Failed - Inactive PAN","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_contacts_v2_fCeKk394YAUqFEaYBWew\",\n \"timestamp\": 1717137111237,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": \"Verification failed\",\n \"message\": \"The given PAN number is inactive\",\n \"data\": null\n}"},{"id":"d48b3004-fbbf-4c03-894b-138c3a4a3540","name":"Validation error","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-contacts"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":""}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"pan_contacts_v2_zqPQm3cdsqgGApC0beSY\",\n \"timestamp\": 1717138164898,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid PAN number\",\n \"data\": null\n}"}],"_postman_id":"5fd0bed5-ead3-47df-8242-9814b531144a"}],"id":"b636a528-39d2-4440-a709-73e79bca07f2","description":"

The PAN Verification APIs allow you to instantly verify the PAN details of individuals or businesses prior to onboarding them or conducting any transactions with them. Our Advanced AI-based PAN Verification APIs utilize advanced technology to provide you with accurate results, informing you if the PAN is valid and issued by the government or not.

\n","_postman_id":"b636a528-39d2-4440-a709-73e79bca07f2"},{"name":"Passport","item":[{"name":"Verify Passport","id":"ab095e81-c785-4dcd-a2d4-32281c5d3c29","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"eu nostrud exercitation fugiat"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"dob\": \"yyyy-mm-dd\",\n \"id_number\": \"file_name_of_passport\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/passport-detail","description":"

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	dob	String	Required	DOB of the passport applicant in YYYY-MM-DD format
2	id_number	String	Required	Refer: Passport file Number definition

Response:

S. No	Key	Data Type	Description
1	data	Object	Details received from source
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	passport_number	String	Passport Number assciated with given file Number
1.3	full_name	String	Full Name of the passport holder
1.4	dob	String	DOB of pasport holder
1.5	date_of_application	String	Passport application submission date
1.6	file_number	String	Passport File Number
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	string	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When passport details are successfully fetched	200	1	success	Successful Request
When Incorrect file number/ DOB is provided	200	9	success	File number or DOB is not valid / not matching	Verification Failed.
When File ID is missing	400	-1	failed	Please enter valid Passport file number	Invalid Request
When DOB is missing	400	-1	failed	Please enter valid DOB. Supported format : yyyy-mm-dd	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["passport-detail"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"42c61535-4ee7-45aa-840d-bf9fb557bd2a","name":"Passport Details Verified successfully","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"dob\": \"YYYY-MM-DD\",\n \"id_number\": \"BN107XXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/passport-detail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 09 Dec 2022 11:00:25 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"202212091XXXXXXXXXX\",\n \"passport_number\": \"TXXXXXXX\",\n \"full_name\": \"PXXXXXXX DXXXXXXX\",\n \"dob\": \"XXXX-MM-DD\",\n \"date_of_application\": \"XXXX-MM-DD\",\n \"file_number\": \"BN107XXXXXXXXXX\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670583620440,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"passport_details_YwFN7A2XaYXXXXXXXXXX\"\n}"},{"id":"a0b0d53a-2fbe-4ce2-ae7c-91776d73f9f4","name":"DOB/File format is incorrect","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"dob\": \"YYYY-MM-DD\",\n \"id_number\": \"BN107XXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/passport-detail"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:45:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"202211201XXXXXXXXXX\",\n \"passport_number\": null,\n \"full_name\": null,\n \"dob\": \"YYYY-MM-DD\",\n \"date_of_application\": null,\n \"file_number\": \"BN107XXXXXXXXXX\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"success\",\n \"message\": \"File number or DOB is not valid / not matching\",\n \"timestamp\": 1668944745559,\n \"error\": \"Verification Failed.\",\n \"success\": true,\n \"txn_id\": \"passport_details_cbQW2Mbvs0XXXXXXXXXX\"\n}"},{"id":"f6664efc-caa8-4dd5-bb38-a437909ad3a9","name":"File ID missing","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"dob\": \"YYYY-MM-DD\",\n \"id_number\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/passport-detail"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 09 Dec 2022 11:01:07 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please enter valid Passport file number\",\n \"timestamp\": 1670583668346,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"passport_details_ifrKr49qkVGrErgUlH9s\"\n}"},{"id":"061aed4f-4ec6-4a30-94a5-c6a3da793077","name":"DOB is missing","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"dob\": \"\",\n \"id_number\": \"BN107XXXXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/passport-detail"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 09 Dec 2022 11:01:37 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please enter valid DOB. Supported format : yyyy-mm-dd\",\n \"timestamp\": 1670583697129,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"passport_details_MXn2V0POfuyt5Unp6xgv\"\n}"}],"_postman_id":"ab095e81-c785-4dcd-a2d4-32281c5d3c29"}],"id":"3a816462-a468-461c-b4c0-f8d8a7f82402","description":"

What is Passport verification API?

Passport verification API is a software interface that allows applications or systems to verify the authenticity and accuracy of an individual's passport information. It is designed to cross-check the data present on the passport against government databases or official records to confirm the identity of the passport holder.

Definition:

Passport file Number: User can find the passport file number on the last page of passport. This a unique identification number assigned to an individual's passport application by the passport issuing authority.

\n","_postman_id":"3a816462-a468-461c-b4c0-f8d8a7f82402"},{"name":"RC Check","item":[{"name":"RC Check","id":"9bfa1e0c-0a92-4c0f-8faa-4784aa1a739f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"rc_number\": \"ka01mz2666\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/rc/verify","description":"

The API will take the RC Number of the vehicle and share all the vehicle related details like chassis number, Insurance details, Owner details .

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	rc_number	String	Required	RC Number / Vehicle number

Response -

S. No	key	Data Type	Description
1	txn_id	Text	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Number	API response received time in milliseconds
3	status	Text	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Number	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Number	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	Text	The text content explains the reason if API request fails
7	message	Text	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received.
8.1	blacklist_status	Text	Blacklist status
8.2	body_type	Text	Body type of the vehicle
8.3	challan_details	Text	Challan details if there are any
8.4	color	Text	Color
8.5	cubic_capacity	Text	Cubic capacity
8.6	father_name	Text	Father's name of the owner
8.7	financed	Boolean	Possible values cane be true or false.
8.8	financer	Text	Name of the financer if there is any
8.9	fit_up_to	Text	Date in YYYY/MM/DD format
8.10	fuel_type	Text	Type of fuel
8.11	insurance_company	Text	Insurance company
8.12	insurance_policy_number	Text	Insurance policy number
8.13	insurance_upto	Text	Date of Insurance till it valid in YYYY/MM/DD format
8.14	latest_by	Text	Date in YYYY/MM/DD format
8.15	less_info	Boolean	Possible values can be true or false
8.16	maker_description	Text	Manufacturer company's name
8.17	maker_model	Text	Model
8.18	manufacturing_date	Text	Manufacturing date in MM/YYYY format
8.19	manufacturing_date_formatted	Text	Manufacturing date in MM/YYYY format
8.20	masked_name	Boolean	Possible values can be true or false
8.21	mobile_number	Text	Mobile Number
8.22	national_permit_issued_by	Text	National permit issuer's name if there is any
8.23	national_permit_number	Text	National permit issuer's number if there is any
8.24	national_permit_upto	Text	National permit date till it is valid if there is any
8.25	no_cylinders	Text	Number of cylinder
8.26	noc_details	Text	NOC deatils
8.27	non_use_from	Text	Non use detail (date in YYYY/MM/DD) if there is any
8.28	non_use_status	Text	Non use status is there is any
8.29	non_use_to	Text	Non use detail (date in YYYY/MM/DD) if there is any
8.30	norms_type	Text	Bharat Stage Norms . Possible values can be (I, II, III, IV, V, VI)
8.31	owner_name	Text	Name of the owner
8.32	owner_number	Text	Number of owners
8.33	permanent_address	Text	Permanent Address
8.34	permit_issue_date	Text	Date in YYYY/MM/DD format
8.35	permit_number	Text	Permit Number
8.36	permit_type	Text	Permit Type
8.37	permit_valid_upto	Text	Date in YYYY/MM/DD format
8.38	present_address	Text	Present Address
8.39	pucc_number	Text	Pucc Number
8.40	pucc_upto	Text	Date in YYYY/MM/DD format
8.41	rc_number	Text	RC Number
8.42	rc_status	Text	RC Status
8.43	registered_at	Text	Registration place
8.44	registration_date	Text	Date in YYYY/MM/DD format
8.45	seat_capacity	Text	Seat capacity
8.46	sleeper_capacity	Text	Sleeper capacity
8.47	standing_capacity	Text	Standing capacity
8.48	tax_paid_upto	Text	Date in YYYY/MM/DD format
8.49	tax_upto	Text	Date in YYYY/MM/DD format
8.50	unladen_weight	Text	Unladen weight
8.51	variant	Text	Variant
8.52	vehicle_category	Text	Vehicle category
8.53	vehicle_category_description	Text	Description of vehicle category
8.54	vehicle_chasi_number	Text	Chasi number
8.55	vehicle_engine_number	Text	Engine number
8.56	vehicle_gross_weight	Text	Vehhicle gross weight
8.57	wheelbase	Text	wheelbase

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When RC details are fetched successfully	200	1	success	Successful Request
When Invalid RC details are entered	200	2	success	Vehicle not found	Verification failed
When No RC details entered	400	-1	failed	Please provide a valid RC number	Validation error
All other mismatch errors	200	9

","urlObject":{"path":["v2","rc","verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"354603a4-ef1e-491e-a8b5-9a7118e2eecb","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rc_number\": \"{{rc_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/rc/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Thu, 21 Dec 2023 06:36:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"rc_verify_v2_4kor5JQSfCKbjIAASb40\",\n \"timestamp\": 1703140654162,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"blacklist_status\": \"NA\",\n \"body_type\": \"SOLO WITH PILLION (MOTORCYCLE)\",\n \"challan_details\": null,\n \"color\": \"DAPPER GREY\",\n \"cubic_capacity\": \"349\",\n \"father_name\": \"{{father_name}}\",\n \"financed\": false,\n \"financer\": \"\",\n \"fit_up_to\": \"20XX-06-XX\",\n \"fuel_type\": \"PETROL\",\n \"insurance_company\": \"ICICI LOMBARD\",\n \"insurance_policy_number\": \"{{insurance_policy_number}}\",\n \"insurance_upto\": \"20XX-05-XX\",\n \"latest_by\": \"2023-12-21\",\n \"less_info\": true,\n \"maker_description\": \"ROYAL-ENFIELD (UNIT OF EICHER LTD)\",\n \"maker_model\": \"HUNTER 350\",\n \"manufacturing_date\": \"5/2023\",\n \"manufacturing_date_formatted\": \"2023-05\",\n \"masked_name\": false,\n \"mobile_number\": \"\",\n \"national_permit_issued_by\": null,\n \"national_permit_number\": null,\n \"national_permit_upto\": null,\n \"no_cylinders\": \"1\",\n \"noc_details\": null,\n \"non_use_from\": null,\n \"non_use_status\": null,\n \"non_use_to\": null,\n \"norms_type\": \"BHARAT STAGE VI\",\n \"owner_name\": \"{{Owner_name}}\",\n \"owner_number\": \"1\",\n \"permanent_address\": \"{{permanent_address}}\",\n \"permit_issue_date\": null,\n \"permit_number\": \"\",\n \"permit_type\": \"\",\n \"permit_valid_from\": null,\n \"permit_valid_upto\": null,\n \"present_address\": \"{{present_address}}\",\n \"pucc_number\": \"Newv4\",\n \"pucc_upto\": \"2024-06-08\",\n \"rc_number\": \"{{rc_number}}\",\n \"rc_status\": \"ACTIVE\",\n \"registered_at\": \"BENGALURU CENTRAL RTO, Karnataka\",\n \"registration_date\": \"20XX-06-09\",\n \"seat_capacity\": \"2\",\n \"sleeper_capacity\": \"0\",\n \"standing_capacity\": \"0\",\n \"tax_paid_upto\": \"LTT\",\n \"tax_upto\": null,\n \"unladen_weight\": \"181\",\n \"variant\": null,\n \"vehicle_category\": \"2WN\",\n \"vehicle_category_description\": \"M-Cycle/Scooter\",\n \"vehicle_chasi_number\": \"{{chasi_number}}\",\n \"vehicle_engine_number\": \"{{engine_number}}\",\n \"vehicle_gross_weight\": \"360\",\n \"wheelbase\": \"1370\"\n }\n}"},{"id":"88265899-325d-4690-9ba0-6bc702ca015d","name":"Empty RC number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rc_number\": \"{{rc_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/rc/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Thu, 21 Dec 2023 06:36:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"rc_verify_v2_oxpAVr0cFiCvEthZZKLt\",\n \"timestamp\": 1703151111001,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid RC number\",\n \"data\": null\n}"},{"id":"bab5859e-0c0f-41d7-8e0a-d972cb5743fa","name":"Invalid RC number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"rc_number\": \"{{rc_number}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/rc/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"291"},{"key":"Date","value":"Thu, 21 Dec 2023 06:36:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"rc_verify_v2_lPYZZhhTlWQsfHM23T2r\",\n \"timestamp\": 1703151578683,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Vehicle not found\",\n \"data\": null\n}"}],"_postman_id":"9bfa1e0c-0a92-4c0f-8faa-4784aa1a739f"},{"name":"Vehicle Challan API","id":"79c73438-d0e3-4796-baf6-af27444c2229","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"\",\n \"chassis_number\":\"\"\n}"},"url":"https://api.idcentral.io/idc/v2/vehicle-challan","description":"

\"Vehicle Challan API\" enables the user to get a list of challans & the status of the challans linked to a vehicle.

Request - The request has to be passed in the body.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	rc_number	String	Required	RC number of a vehicle
2	chassis_number	String	Optional	An Vehicle Identification Number.

Response -

S. No	key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API.
2	timestamp	Number	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Number	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Number	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received.
8.1	challans	Object	Challan details
8.1.1	amount	Number	Challan amout to be paid
8.1.2	area	String	Area
8.1.3	date	Number	Date and time of Challan
8.1.4	offences	String	Offecnces details
8.1.4.1	penalty	Number	Penalty amount
8.1.4.2	offence_name	String	Offence description
8.1.5	state	String	State
8.1.6	accused_name	String	Name of the accuser
8.1.7	challan_no	String	Challan Number
8.1.8	challan_status	String	Status of Challan
8.1.9	owner_name	String	Owner of the Vehichle
8.1.10	payment_date	String	Payment Date
8.1.11	payment_source	Sring	Source of the payment
8.1.12	rc_dl_no	String	DL Number
8.1.13	transaction_id	String	Transaction ID
8.1.14	vehicle_class	String	Class of vehicle
8.2	vehicle_id	String	Vehicle ID
8.3	challan_details	String	Other Challan details if any

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status Code	Response Code	Message
1	Successful Scenario	200	1	Successful request
2	Invalid RC or Chassis number	200	2	Invalid RC or Chassis number
3	Invalid Chassis Number	400	-1	Invalid Chassis Number
4	Invalid RC Number	500	99	Invalid RC Number/No response from source
5	Invalid RC or No Challan found	200	9	Invalid RC or No challan found

","urlObject":{"path":["v2","vehicle-challan"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"deef511e-2860-447c-b3d1-4bbdc483f0ae","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"rc_number\",\n \"chassis_number\":\"chassis_number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/vehicle-challan"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"303"},{"key":"Date","value":"Thu, 12 Oct 2023 11:58:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"vehicle_challan_sFFxarHXY1NYPxQSuUKV\",\n \"timestamp\": 1697439184667,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"challans\": [\n {\n \"amount\": 500.0,\n \"area\": \"XXXXXX\",\n \"date\": \"2023-06-15 14:47:11\",\n \"offences\": [\n {\n \"penalty\": \"500\",\n \"offence_name\": \"Violation of traffic rules by the driver except the offences mentioned in Section in 184 a, b, d, e, f and without any indication changing the alignment\"\n },\n {\n \"penalty\": \"500\",\n \"offence_name\": \"Violation of traffic rules by the driver except the offences mentioned in Section in 184 a, b, d, e, f and without any indication changing the alignment\"\n }\n ],\n \"state\": \"XX\",\n \"accused_name\": \"\",\n \"challan_no\": \"XXXXXXXXXXXXX\",\n \"challan_status\": \"Pending\",\n \"owner_name\": \"XXXXXXX KUMAR\",\n \"payment_date\": \"\",\n \"payment_source\": \"\",\n \"rc_dl_no\": \"XXXXXXXX\",\n \"transaction_id\": \"NA\",\n \"vehicle_class\": \"\"\n }\n ],\n \"vehicle_id\": \"XXXXXXXX\",\n \"challan_details\": null\n }\n}"},{"id":"272f1d5c-4203-412c-af42-ae4e2ae22317","name":"Successful Scenario (No Challan details)","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"rc_number\",\n \"chassis_number\":\"chassis_number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/vehicle-challan"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"303"},{"key":"Date","value":"Thu, 12 Oct 2023 11:58:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"vehicle_challan_yZ4yRCvkd5Sh0SbiATVc\",\n \"timestamp\": 1697439128919,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"challans\": null,\n \"vehicle_id\": \"XXXXXXXXXX\",\n \"challan_details\": \"No challan found for this vehicle\"\n }\n}"},{"id":"3419a1b7-91cf-4f38-b90e-5efda95556fd","name":"Invalid Chassis Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"rc_number\",\n \"chassis_number\":\"chassis_number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/vehicle-challan"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"303"},{"key":"Date","value":"Thu, 12 Oct 2023 11:58:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"vehicle_challan_ZRy6xu4YHaJKrNBecZgJ\",\n \"timestamp\": 1697444608555,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid Chassis Number\",\n \"data\": null\n}"},{"id":"ba77f560-43e5-45ee-bf38-f045fc47408c","name":"Invalid RC Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"rc_number\",\n \"chassis_number\":\"chassis_number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/vehicle-challan"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"303"},{"key":"Date","value":"Thu, 12 Oct 2023 11:58:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"vehicle_challan_Il5D9thZpmbwJK9x9ayp\",\n \"timestamp\": 1697444719008,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 99,\n \"error\": \"Internal error\",\n \"message\": \"Invalid RC Number/No response from source\",\n \"data\": null\n}"},{"id":"d4708982-3c9b-4b6d-8ac1-7e4ecd425516","name":"Invalid RC or No challan found","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"rc_number\": \"rc_number\",\n \"chassis_number\":\"chassis_number\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/vehicle-challan"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"303"},{"key":"Date","value":"Thu, 12 Oct 2023 11:58:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"vehicle_challan_v2_DGzbt9xzH6sjXrnZn3iY\",\n \"timestamp\": 1710948488084,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"error\": \"Mismatch error\",\n \"message\": \"Invalid RC or No challan found\",\n \"data\": null\n}"}],"_postman_id":"79c73438-d0e3-4796-baf6-af27444c2229"}],"id":"e348734f-e214-4c26-8e4f-24ef635a3358","description":"

What is Vehicle registration certificate (RC)?

The Registration Certificate (RC) of your vehicle is the official document which states that your vehicle is registered with the Indian Government. It mentions the territorial boundary in which the vehicle can be used, engine and chassis number, fuel used, cubic capacity, and specifies the category of the vehicle.

The Motor Vehicles (MV) Act, 1988, requires every vehicle owner in India to have a valid registration certificate to operate a motor vehicle on Indian roadways. The MV Act prohibits driving a vehicle on Indian highways without a valid registration certificate.

Vehicle RC Check Verification API assists with laying out a connection between the vehicle and its proprietor, in this manner limiting the potential for extortion

Definition

RC Number / Vehicle Number: The RTO is the main authority on all road and motor-vehicle related matters. Once your car documentation is processed by the RTO, a unique alphanumerical registration ID is provided to you. A vehicle number plate is nothing but a metal board representation that unique registration ID. eg. KA 12 BH 1234.

\n","_postman_id":"e348734f-e214-4c26-8e4f-24ef635a3358"},{"name":"UAN","item":[{"name":"Get UAN","id":"47aca59d-f751-44ee-a3e9-34917234a6d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\n \"mobile_number\":\"XXXXXXXXXX\"\n\n}"},"url":"https://api.idcentral.io/idc/epfo/uan/mobile","description":"

IDcentral's Get UAN API is a non-intrusive and faster check to verify if an employee has worked in an organization during the claimed period of time.

The API allows you to ensure that:

You only employ individuals who are non-fraudulent and have made legitimate claims to working with their previous employers
You only partner with legitimate individuals who have/are related to a different / claimed employer currently or in the past

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	mobile_number	String	Required	Mobile Number

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
2	timestamp	Integer	API response receive time in milliseconds
3	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	A text content explains a reason if API request failed
7	message	String	A text content explains if API request was successful or not.
8	data	Object	Information fetched about givenmobile number
8.1	uan_list	Array List	List of all the associated UAN number with given mobile number

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When mobile number linked to UAN and able fetch UAN ID	200	1	success	Successful request
When mobile number is not linked to UAN. No UAN found	200	2	success	Verification failed	Verification failed
When no mobile number is passed	400	-1	failed	Please provide a valid mobile number	Validation error
When invalid mobile number is passed	400	-1	failed	Please provide a valid mobile number	Validation error
All other mismatch errors	200	9

","urlObject":{"path":["epfo","uan","mobile"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"89dbd139-15ef-49b0-9bd8-145b12994fe6","name":"Mobile Number linked to UAN number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\n \"mobile_number\":\"9689928280\"\n\n}"},"url":"https://api.idcentral.io/idc/epfo/uan/mobile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 04:57:46 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_uan_kgRGlnps9lZB8x2Uo766\",\n \"timestamp\": 1672117066108,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"uan_list\": [\n \"101081385643\"\n ]\n }\n}"},{"id":"e9b7df6a-09bd-4f39-b0ab-8bf40ad4cc09","name":"Mobile Number not linked with UAN","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\n \"mobile_number\":\"9620278091\"\n\n}"},"url":"https://api.idcentral.io/idc/epfo/uan/mobile"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 04:56:51 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_uan_JwG7OgPmxDqmVE3dlokl\",\n \"timestamp\": 1672117011297,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Provided mobile number doesn't have any UAN\",\n \"data\": null\n}"},{"id":"73ee0a80-023e-4ab4-a07f-5fc50e84ce27","name":"No Mobile number passed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\n \"mobile_number\":\"\"\n\n}"},"url":"https://api.idcentral.io/idc/epfo/uan/mobile"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 04:58:29 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_uan_CCCEApWrfdjkplX3Ctk4\",\n \"timestamp\": 1672117110595,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid mobile number\",\n \"data\": null\n}"},{"id":"f6c9488c-5bc4-43a1-89e3-0da88ee8dfd8","name":"Invalid Mobile Number passed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n\n \"mobile_number\":\"968992121228280\"\n\n}"},"url":"https://api.idcentral.io/idc/epfo/uan/mobile"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 27 Dec 2022 04:59:07 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_uan_fXU6aptNJMTPxkLJDncI\",\n \"timestamp\": 1672117148407,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Please provide a valid mobile number\",\n \"data\": null\n}"}],"_postman_id":"47aca59d-f751-44ee-a3e9-34917234a6d9"},{"name":"EPFO Details without OTP","id":"35cce6bd-c4cc-4ca3-a828-5c75452ac8b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/epfo/details","description":"

This EPFO API enables the user to get detailed history of an employee and their employment details as per the Employee Provident Fund Organisation's database.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	mobile_number	String	Required	Employee's mobile number linked to EPFO

Response

S. No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is \"success\", it confirms that the request is processed successfully, and a response is received. Conversely, if the value is \"failed\" it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	uan_details	String	UAN number of the employee, the employement details and other basic details will be displayed.
8.1.1	employement_details	Object	The last employement details of the employee registered with the EPFO is displayed.
8.1.1.2	date_of_joining	String	The date of joining with the current employer.
8.1.1.3	leave reason	String	This field provides a succinct explanation for the absence, as retrieved from the EPFO database.
8.1.1.4	establishment_name	String	The name of organization the employee is employed to.
8.1.1.5	date_of_exit	String	The last working day of employee at the mentioned organization is retrieved as obtained from the EPFO database.
8.1.1.6	member_id	String	This unique identifier corresponds to the member's record within the Employee Provident Fund Organization's database.
8.1.1.7	establishment_id	String	This identifier corresponds to the specific establishment or employer within the Employee Provident Fund Organization's database
8.1.2	basic_details	object	Basic details of the employee, such as gender, name, DOB, aadhar verification status etc are displayed.
8.1.2.1	aadhaar_verification_status	Integer	Displays if the aadhar of the employee is verified with EPFO.(Possible results are 0 and 1)
8.1.2.2	gender	String	The gender of the employee is displayed.
8.1.2.3	name	String	The employee name as per EPFO is displayed.
8.1.2.4	mobile	String	The mobile number registered with EPFO.
8.1.2.5	date_of_birth	String	The DOB of the employee as per the EPFO database is displayed, in YYYY-MM-DD format.
8.1.3	uan_numbers	String	The UAN number of employee as per the EPFO database.
8.1.4	employment_summary	Object	All employement details of the employee summarized as per the EPFO database.

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When the details are successfully retrieved	200	1	success	Successful Request
When the verification is failed and details are not retrieved	200	2	success	No matching records identified	Verification failed
Other mismatched errors	200	9	success

","urlObject":{"path":["v2","epfo","details"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"254692b9-1fa5-410d-a7e7-1cecaccf69e5","name":"Successful scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/epfo/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 09 Feb 2024 09:26:41 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_details_v2_QZhxcbMpE4SxwSfFCuVC\",\n \"timestamp\": 1707473614820,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"uan_details\": {\n \"XXXXXXXXXXXX\": {\n \"employment_details\": {\n \"date_of_joining\": \"XXXX-12-09\",\n \"leave_reason\": \"\",\n \"establishment_name\": \"XXXXXXXX LIMITED\",\n \"date_of_exit\": \"\",\n \"member_id\": \"XXXXXXXXXXXXXXX\",\n \"establishment_id\": \"XXXXXXXXXXXXXX\"\n },\n \"basic_details\": {\n \"aadhaar_verification_status\": 1,\n \"gender\": \"FEMALE\",\n \"name\": \"Xxxxxxxxx Xxxxxx\",\n \"mobile\": \"\",\n \"date_of_birth\": \"XXXX-XX-02\"\n }\n }\n },\n \"uan_numbers\": [\n \"XXXXXXXXXXXX\"\n ],\n \"employment_summary\": {\n \"date_of_exit_marked\": false,\n \"uan_count\": 1,\n \"recent_employer_data\": {\n \"date_of_joining\": \"XXXX-12-09\",\n \"establishment_name\": \"SUBEX LIMITED\",\n \"matching_uan\": \"XXXXXXXXXXX\",\n \"date_of_exit\": \"\",\n \"member_id\": \"XXXXXXXXXXXXXXXX\",\n \"establishment_id\": \"XXXXXXXXXXXXX\"\n },\n \"is_employed\": true\n },\n \"uan_data_source\": [\n {\n \"uan\": \"XXXXXXXXXXXXX\",\n \"source\": \"mobile\"\n }\n ]\n }\n}"},{"id":"74fe086e-b436-442e-a238-416e313b0bf9","name":"Verification failed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"","type":"text"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"mobile_number\" :\"XXXXXXXXXX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/epfo/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Fri, 09 Feb 2024 09:26:41 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"epfo_details_v2_dOBmeACqMT4oIDJoSg2a\",\n \"timestamp\": 1707472596416,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"No matching records identified\",\n \"data\": null\n}"}],"_postman_id":"35cce6bd-c4cc-4ca3-a828-5c75452ac8b3"}],"id":"a2df47d9-d7d8-4c16-b18e-5b4bd4d6e0a7","description":"

What Is an UAN Number?

UAN is a 12 digit unique number provided to each employee contributing to the Employees Provident Fund. This unique number is generated and assigned by the Employee Provident Fund Organisation (EPFO). The Ministry of Labour and Employment authenticates UAN under the directives of the Government of India.

This number remains the same for each employee throughout their life irrespective of the number of times they have joined new organisations.

\n","_postman_id":"a2df47d9-d7d8-4c16-b18e-5b4bd4d6e0a7"},{"name":"Udyam","item":[{"name":"Verify Udyam","id":"af7879d6-08bb-4a46-906c-83f0cc3c08e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"UDYAM-XX-XX-XX\"\r\n}"},"url":"https://api.idcentral.io/idc/v2/udyam/verify","description":"

The \"Verify Udyam API\" enables the user to verify the Udyam Aadhaar and gives all the details associated with it. The user can confidently onboard merchants knowing that the merchant exists, is genuine and is authorized to partake in the manufacture or service sector by the Ministry of MSME. This can help to prevent fraud and ensure that businesses are eligible for government schemes and benefits.

EndFragment

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Udyam Number to be Searched. Enter 19-digit Udyam Registration Number in the format of UDYAM-XX-00-0000000

Response -

S. No	key	Data Type	Description
1	txn_id	String	It is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	The text content explains the reason if API request fails
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	Object	Data contains the detailed information received
8.1	general_info	Array	Information about enterprise and the owner
8.1.1	udyam_registration_number	String	Udyam number
8.1.2	name_of_enterprise	String	Name of enterprise associated with the Udyam
8.1.3	major_activity	String	Specify the main business activity of an enterprise.
8.1.4	organisation_type	String	Type of organisation
8.1.5	social_category	String	The social category to which the owner or entrepreneur belongs
8.1.6	date_of_incorporation	String	The date on which the enterprise was officially registered
8.1.7	date_of_commencement_of_production_business	String	The date when the business operations started
8.1.8	dic	String	District where the enterprise is based out
8.1.9	msmedi	String	MSME Developemnt Institute it falls under
8.1.10	date_of_udyam_registration	String	Registration date
8.1.11	type_of_enterprise	String	Type of enterprise
8.2	enterprise_type	Object	Information of enterprise
8.2.1	data_year	String	The financial year for which the enterprise's financial data is being reported.
8.2.2	classification_year	String	The financial year for which the data on investment, turnover, and export is used to classify an enterprise as an MSME
8.2.3	enterprise_type	String	Classification of enterprise
8.2.4	classification_date	String	The date on which an enterprise was classified as an MSME
8.3	units_details	Array	Information about the physical location of an enterprise
8.4	official_address_of_enterprise	Array	Information about the physical location of an enterprise
8.4.1	flat_door_block_no	String	Flat/Door/Block numer
8.4.2	name_of_premises_building	String	Name of premises building
8.4.3	village_town	String	Village
8.4.5	block	String	Block
8.4.6	road_street_lane	String	Road/Street/Lane
8.4.7	city	String	City
8.4.8	state	String	State
8.4.9	pin	Integer	PIN
8.4.10	district	String	District
8.4.11	mobile	Integer	Mobile number
8.4.12	email	String	Email ID
8.5	national_industry_classification_codes	Array	Codes to classify the business activities of MSMEs.
8.5.1	nic2_digit	String	Two-digit code to classify the business activity
8.5.2	nic4_digit	String	Four-digit code to classify the business activity
8.5.3	nic5_digit	String	Five-digit code to classify the business activity
8.5.4	activity	String	Specify the business activities that an enterprise undertakes
8.5.5	date	String	Date

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status Code	Response Code	Message
1	Successful Scenario	200	1	Successful request
2	Udyam Number is not valid	200	2	Udyam Number is not valid
3	Any other status message apart from the listed above	200	9

","urlObject":{"path":["v2","udyam","verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"96a2e292-20b5-4ed4-b7e5-aad33a205d74","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"UDYAM-XX-XX-XX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/udyam/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 25 Jul 2023 11:23:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"verify_udyam_78E93HlztC3bDt2Ri3ii\",\n \"timestamp\": 1690284166018,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"general_info\": {\n \"udyam_registration_number\": \"UDYAM-XX-XX-XXXXXXX\",\n \"name_of_enterprise\": \"{{Enterprise_Name}}\",\n \"major_activity\": \"{{Major Activity}}\",\n \"organisation_type\": \"{{Type of Organisation}}\",\n \"social_category\": \"{{Category}}\",\n \"date_of_incorporation\": \"DD/MM/YYYY\",\n \"date_of_commencement_of_production_business\": \"DD/MM/YYYY\",\n \"dic\": \"{{District}}\",\n \"msmedi\": \"{{Development Institure}}\",\n \"date_of_udyam_registration\": \"DD/MM/YYYY\",\n \"type_of_enterprise\": \"{{Enterprise type}}\"\n },\n \"enterprise_type\": [\n {\n \"data_year\": \"2021-22\",\n \"classification_year\": \"2023-24\",\n \"enterprise_type\": \"{{Enterprise Type}}\",\n \"classification_date\": \"DD/MM/YYYY\"\n }\n ],\n \"units_details\": [],\n \"official_address_of_enterprise\": {\n \"flat_door_block_no\": \"{{Flat/Door/Block Number}}\",\n \"name_of_premises_building\": \"{{Name of Building}}\",\n \"village_town\": \"{{Town}}\",\n \"block\": \"{{Block}}\",\n \"road_street_lane\": \"{{Street}}\",\n \"city\": \"{{City}}\",\n \"state\": \"{{State}}\",\n \"pin\": \"XXXXXX\",\n \"district\": \"{{District}},\",\n \"mobile\": \"96*****XX\",\n \"email\": \"{{email id}}\"\n },\n \"national_industry_classification_codes\": [\n {\n \"nic2_digit\": \"{{nic2_digit}}\",\n \"nic4_digit\": \"{{nic4_digit}}\",\n \"nic5_digit\": \"{{nic5_digit}}\",\n \"activity\": \"{{Activity}}\",\n \"date\": \"DD/MM/YYYY\"\n }\n ]\n }\n}"},{"id":"6206d0e9-845c-4d26-9110-6678e31631d7","name":"Invalid Udyam Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"b4fa008b8401d8ab46e3959a4bc85414"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"UDYAM-XX-XX-XX\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/udyam/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 25 Jul 2023 11:23:52 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"verify_udyam_u8eje8aQkfGopuj1lfNR\",\n \"timestamp\": 1690284229744,\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Udyam Number is either blank or not valid\",\n \"message\": null,\n \"data\": null\n}"}],"_postman_id":"af7879d6-08bb-4a46-906c-83f0cc3c08e4"}],"id":"bf004c4b-fe39-46d8-b228-62173356a1e3","description":"

Udyam Aadhaar is a single-window registration system for micro, small and medium enterprises (MSMEs) in India. It provides a single platform for MSMEs to register their businesses, access government schemes and benefits, and track their progress. It also provides a range of other services to MSMEs, such as training, mentoring, and market linkages.

\n","_postman_id":"bf004c4b-fe39-46d8-b228-62173356a1e3"},{"name":"Voter ID","item":[{"name":"VoterID V2","id":"50d913c3-0596-4ef8-9e4d-786f9c0df4ef","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\":\"ABCD123456\"\n}"},"url":"https://api.idcentral.io/idc/v2/voter-id","description":"

This API will verify the legitimacy of a Voter ID. You will need to pass the Voter ID Number to verify the status of the Voter account. On successful validation, the API will return the complete voter ID details including name and address.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	The unique VoterID number

Response:

S. No	Key	Data Type	Description
1	txn_id	Text	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
2	timestamp	Number	API response receive time in milliseconds
3	status	Text	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
4	status_code	Number	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Number	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	Text	A text content explains a reason if API request failed
7	message	Text	A text content explains if API request was successful or not.
8	data	Object	Data as per the Voter Id records
8.1	gender	Text	Gender as per the Voter Id records Male - M, female - F
8.2	state	Text	State as per the Voter Id records
8.3	name	Text	Name as per the Voter Id records
8.4	dob	Text	Date of birth as per the voter ID records
8.5	age	Number	Age as per the voter ID records
8.6	area	Text	Village or area as per the voter ID records
8.7	district	Text	District as per the voter ID records
8.8	multiple	Boolean	-
8.9	id	Text	Unique transaction ID generated by the voter ID records
8.10	voter_id	Text	The unique Voter ID number
8.11	epic_no	Text	Voter Id unique serial number. Refer: Epic Number definition
8.12	relation_name	Text	Father or Husband Name of the Voter ID holder as per the Voter Id records
8.13	relation_type	Text	Relation Type with the relative as per the voter ID records
8.14	house_no	Text	House number as per the voter ID records
8.15	additional_check	Array	Any additional info as per the voter ID records
8.16	last_update	Text	Last update on the voter card as per the voter ID records
8.17	assembly_constituency	Text	Assembly constituency as per the voter ID records
8.18	assembly_constituency_number	Number	Assembly constituency number as per the voter ID records
8.19	polling_station	Text	Polling station as per the voter ID records
8.20	part_number	Number	Part number as per the voter ID records
8.21	part_name	Text	Part Name as per the voter ID records
8.22	slno_inpart	Number	Sl number in part as per the voter ID records
8.23	ps_lat_long	Text	Coordinates of the location as per the voter ID records
8.24	rln_name_v1	Text	Relation name as per the voter ID records in native language.
8.25	rln_name_v2	Text	Father / Spouse name in local language
8.26	rln_name_v3	Text	RLN name details
8.27	section_no	Number	Section number details
8.28	name_v1	Text	Name as per the voter ID records in native language
8.29	name_v2	Text	Name details
8.30	name_v3	Text	Name details
8.31	parliamentary_name	Text	Parliament name as per voter ID records
8.32	parliamentary_number	Number	Parliament number as per voter ID records
8.33	st_code	Text	St code as per the voter ID records
8.34	parliamentary_constituency	Text	Parliamentary constituency Name as per the voter ID records

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When Voter details are fetched successfully	200	1	success	Successful Request
When ID number entered is not in valid format	200	2	success	Please provide the valid voter id	Verification failed
When the entered ID number is invalid	400	-1	failed	Invalid voter id number	Validation Error
All other mismatch errors	200	9

","urlObject":{"path":["v2","voter-id"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f6c7d190-fe53-4d5c-a64a-11ef54fc81f7","name":"Successful scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\":\"ABCD123456\"\n}"},"url":"https://api.idcentral.io/idc/v2/voter-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Wed, 24 Apr 2024 10:35:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"voter_id_v2_YD7Cf00izzpy0ZGGbbba\",\n \"timestamp\": 1713956969275,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful Request\",\n \"data\": {\n \"gender\": \"F\",\n \"state\": \"Kerala\",\n \"name\": \"DXXXXXX XXXXXXXXXL\",\n \"dob\": null,\n \"age\": \"23\",\n \"area\": \"GHSS XXXXX XXXXXXX XXXXXX(XXXX XXXX XXXXX XX)\",\n \"district\": \"XXXXXXXXXXX\",\n \"multiple\": false,\n \"id\": \"241XXX017_XBI1432XX4_SXX\",\n \"voter_id\": \"XXXXXXXXXXX\",\n \"epic_no\": \"XXXXXXXXXX\",\n \"relation_name\": \"XXXXXX X\",\n \"relation_type\": \"XXXXXX\",\n \"house_no\": null,\n \"additional_check\": [],\n \"last_update\": null,\n \"assembly_constituency\": \"XXXXXXXXXX\",\n \"assembly_constituency_number\": \"X\",\n \"polling_station\": \"XXXXXXXX XX\",\n \"part_number\": \"64\",\n \"part_name\": \"XXXXXX XXXX XXXXX(XXXX XXXXX XXXXX)\",\n \"slno_inpart\": \"19\",\n \"ps_lat_long\": \"\",\n \"rln_name_v1\": \"XXXX XX\",\n \"rln_name_v2\": \"\",\n \"rln_name_v3\": \"\",\n \"section_no\": \"1\",\n \"name_v1\": \"XXXXXXX XXXXXXXXXX\",\n \"name_v2\": \"XXXXXXX XXXXXXXXXX\",\n \"name_v3\": \"\",\n \"parliamentary_name\": \"KXXXXXXX\",\n \"parliamentary_number\": \"1\",\n \"st_code\": \"S1X\",\n \"parliamentary_constituency\": \"KXXXXXXX\"\n }\n}"},{"id":"d81fb1c3-f082-4860-b4f0-5535cca45cd2","name":"Verification Failed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\":\"ABCD123456\"\n}"},"url":"https://api.idcentral.io/idc/v2/voter-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Wed, 24 Apr 2024 10:35:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"voter_id_v2_t5slQXjArE33L7FgpVAw\",\n \"timestamp\": 1713957176428,\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": \"Verification failed\",\n \"message\": \"Please provide the valid voter id\",\n \"data\": null\n}\n"},{"id":"44f95531-949a-491d-8acc-bb9813931e9e","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\":\"ABCD123456\"\n}"},"url":"https://api.idcentral.io/idc/v2/voter-id"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Content-Length","value":"212"},{"key":"Date","value":"Wed, 24 Apr 2024 10:35:26 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"voter_id_v2_3XHBaHAOhJD4ir3wnRUO\",\n \"timestamp\": 1713957258663,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"Invalid voter id number\",\n \"data\": null\n}"}],"_postman_id":"50d913c3-0596-4ef8-9e4d-786f9c0df4ef"}],"id":"dca352c3-c544-4e8a-b6cf-5c71b256f8fb","description":"

Voter ID is a legal government authorized identification document provided by the Election Commission of India. It is vastly used as the identity proof of an individual for verifying the identity in different government and private sectors. Hence, it is essential to verify whether the voter ID provided by the person is original or not to avoid any kind of fraud or theft.

Definition

Epic Number: EPIC (Electors Photo Identity Card) number is the voter ID number issued by the Election Commission of India (ECI). This number works as identity proof for Indian nationals who are above the age of 18. It also allows Indian nationals to cast votes in various elections conducted in the country. The EPIC number can be found on the voter ID card. It's right above the top of your photo on your voter identification card. The EPIC number is usually 10 digits long.

\n","_postman_id":"dca352c3-c544-4e8a-b6cf-5c71b256f8fb"},{"name":"Bulk API Generic Processor","item":[{"name":"Generic Bulk Processor-Submit Request","id":"101e136d-05f4-4c1c-924f-e3389a166121","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"endpoint\": \"{{api endpoint}}\",\r\n \"parameters\": {\r\n \"parameter_1\": 0, \r\n \"parameter_2\": 1,\r\n \"parameter_3\": 2 //....parameter_n: n-1\r\n },\r\n \"csv\": \"{{url of the input csv file}}\", \r\n \"concurrent_process\": 1 //set to 1-10 at a time. \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/submit-request","description":"

This endpoint allows users to initiate bulk processing for the required API by providing the specific API endpoint in the request. Users can run up to 10 concurrent requests at a time on the specified endpoint using the Bulk Processor API.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	endpoint	String	Required	The endpoint of the API for running the bulk process.
2	parameters	Object	Required	The parameters contain all the parameters and their corresponding values.
2.1	{{parameter_1}}	Integer	Required	The parameter_1 refers to the column index of the specified parameter within the CSV file. For instance, in the PAN API endpoint, if the input CSV file contains PAN numbers in the first column, then value of parameter_1 will be 0. Ex: id_number = 0, where id_number is the parameter_1 and 0 is the index of column in csv file
2.2	{{parameter_n}}	Integer	Required	All the parameters required for the API should be entered in the same format as shown above.
3	csv	String	Required	The URL of the input CSV file that contains input data for bulk processing.
4	concurrent_process	Integer	Required	The number of concurrent requests to be run during the process. The API supports running 1 to 10 requests concurrently.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S.No	Key	Data Type	Description
1	txn_id	String	It is a unique reference ID that is sent back to IDCentral's client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of the API.
2	timestamp	Integer	Time in milliseconds when the API call was made.
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request has been processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDCentral's internally mapped sub-status/response codes. Refer to: Errors and Status Codes.
6	error	String	The text content explains the reason if the API request fails.
7	message	String	This field confirms if the API request is successful or not and shows the respective message.
8	data	Object	The data contains the detailed information received.
8.1	request_id	String	A uniquely generated ID that is used in the Generic Bulk Processor Get Response API.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When all the inputs provided are valid.	200	1	success	Successful request
When file size is greater than 100 MB.	400	-1	failed	File exceeds maximum file size 104857600 bytes and csv size is 112619009	Validation error
When file formats is not supported.(Provided file format, other than .csv file)	400	-1	failed	Provided file format is not supported, Please provide the supported file format csv	Validation error
When \"concurrent_process\": >10	400	-1	failed	Maximum number of concurrent process limit reached. Please try with a lower number	Validation error
When concurrent_process : 0	400	-1	failed	concurrent_process cannot be zero or less than zero\"	Vaildation error
When invalid \"endpoint\" sent in the request.	400	-1	failed	Please enter valid endpoint	Validation error
When unrechable csv url sent in the request.	400	-1	failed	csv file unreachable	Validation error
When the number of records exceed 100000.	400	-1	failed	Maximum supported records are 100000. Total records found in csv file 1048575	Validation error
When sending csv file that consists of one field and the request has more than one parameter input.	400	-1	failed	Invalid column number in parameters	Validation error

","urlObject":{"path":["api-processor","submit-request"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"3590736f-7edb-4e50-808f-acf19e24522c","name":"Successful Request","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"endpoint\": \"{{api endpoint}}\",\r\n \"parameters\": {\r\n \"parameter_1\": 0, \r\n \"parameter_2\": 1,\r\n \"parameter_3\": 2 //....parameter_n: n-1\r\n },\r\n \"csv\": \"{{url of the input csv file}}\", \r\n \"concurrent_process\": 1 //set to 1-10 at a time. \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/submit-request"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:00:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_submit_request_i5M7ykRcnCpy7ObgwoZd\",\n \"timestamp\": 1718085243745,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"request_id\": \"1718085243868ZGirVbvv5I\"\n }\n}"},{"id":"78e36388-7f06-49e3-a01a-73f6435ceb67","name":"File Size exceeded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"endpoint\": \"{{api endpoint}}\",\r\n \"parameters\": {\r\n \"parameter_1\": 0, \r\n \"parameter_2\": 1,\r\n \"parameter_3\": 2 //....parameter_n: n-1\r\n },\r\n \"csv\": \"{{url of the input csv file}}\", \r\n \"concurrent_process\": 1 //set to 1-10 at a time. \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/submit-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:00:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_submit_request_IZirZtupTbUK6lzvtQPJ\",\n \"timestamp\": 1717407188233,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation Error\",\n \"message\": \"File exceeds maximum file size 104857600 bytes and csv size is 112619009\",\n \"data\": null\n}"},{"id":"8ba104e0-6c49-4b86-8005-e104f4aa336c","name":"Invalid File format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"endpoint\": \"{{api endpoint}}\",\r\n \"parameters\": {\r\n \"parameter_1\": 0, \r\n \"parameter_2\": 1,\r\n \"parameter_3\": 2 //....parameter_n: n-1\r\n },\r\n \"csv\": \"{{url of the input csv file}}\", \r\n \"concurrent_process\": 1 //set to 1-10 at a time. \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/submit-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:00:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_submit_request_gJ92HPXVLHY62iscZVD9\",\n \"timestamp\": 1716963703201,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Provided file format is not supported, Please provide the supported file format csv\",\n \"data\": null\n}"},{"id":"1c93c647-a290-47b7-863b-789f72451af7","name":"Maximum number of concurrent process exceeded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"endpoint\": \"{{api endpoint}}\",\r\n \"parameters\": {\r\n \"parameter_1\": 0, \r\n \"parameter_2\": 1,\r\n \"parameter_3\": 2 //....parameter_n: n-1\r\n },\r\n \"csv\": \"{{url of the input csv file}}\", \r\n \"concurrent_process\": 1 //set to 1-10 at a time. \r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/submit-request"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:00:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_submit_request_FpbbkUlyzQ8QNnGVrJ8y\",\n \"timestamp\": 1716967282821,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Maximum number of concurrent process limit reached. Please try with a lower number\",\n \"data\": null\n}"}],"_postman_id":"101e136d-05f4-4c1c-924f-e3389a166121"},{"name":"Generic Bulk Processor - Get Response","id":"727a725a-c817-4929-9ce8-b451ca35d554","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"request_id\": \"{{request_id}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/get-response","description":"

This endpoint helps users to check the status and download the response from the bulk process by providing the request_id generated during the generic bulk processor.

After generating the response URL with the request_id from the bulk process initiation, it remains valid for only 10 minutes.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	request_id	String	Required	The request_id is obtained as a response to initiating the bulk process. This is a unique ID for every bulk process initiated.

Response:

S.No	Key	Data Type	Description
1	txn_id	String	It is a unique reference ID that is sent back to IDCentral's client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of the API.
2	timestamp	Integer	Time in milliseconds when the API call was made.
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is 'success', it confirms that the request has been processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error.
4	status_code	Integer	The HTTP status code of the API. Refer to: Errors and Status Codes.
5	response_code	Integer	IDCentral's internally mapped sub-status/response codes. Refer to: Errors and Status Codes.
6	error	String	The text content explains the reason if the API request fails.
7	message	String	The text contain confirms whether the API request is successful or not and displays the respective message.
8	data	Object	The data contains the detailed information received.
8.1	s3PreSignedURL	Object	Contains the URL to the CSV file with the response for the bulk process. *Note: The URL is valid only for 10 minutes once generated.
8.1.1	url	String	URL to the CSV file with response data.
8.1.2	expireTimestamp	Integer	Timestamp indicating until when the URL is valid.
8.2	total	Integer	Total number of records process
8.3	completed	Integer	Number of records completed processing
8.4	pending	Integer	Number of records awaiting processing.
8.5	success	Integer	Number of records processed successfully.
8.6	failed	Integer	Number of records failed.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid request_id provided	200	1	Success	Successful request
When the API is processing the given request	200	2	Success	Processing
When invalid request_id entered	400	-1	failed	Invalid request_id	Validation error

","urlObject":{"path":["api-processor","get-response"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"0928d042-2e91-4189-bf91-86f5ae948253","name":"Successful Request","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"request_id\": \"{{request_id}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/get-response"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:06:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_get_response_tFXvmMWXXwxxxsAZ9DbiVPP\",\n \"timestamp\": 1718085284852,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"s3PreSignedURL\": {\n \"url\": \"\\nhttps://idc-bulk-api-processor.s3.ap-south-1.amazonaws.com/prod/1718085243868ZGirVbvv5Ixxxx.csvX-Amz-Credexxxxxxntial=AKIAUSRHKC7E4FQBF7DG%2F20240611%2Fap-south-1%2Fs3%2Faws4_xxxxrequestxx75e44dd67166269a8e9393d2eca7c3d6742257ded8c844xxxx2e03a3xxxxxx\",\n \"expireTimestamp\": 1718085884903\n },\n \"total\": 10,\n \"completed\": 10,\n \"pending\": 0,\n \"success\": 7,\n \"failed\": 3\n }\n}"},{"id":"3daaff9d-cc75-4957-8ecf-1360b7ae030a","name":"Processing Request","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"request_id\": \"{{request_id}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/get-response"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:06:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_get_response_SjEOHdsPsYpWrSEQAav8\",\n \"timestamp\": 1716968096354,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": null,\n \"message\": \"Processing\",\n \"data\": {\n \"s3PreSignedURL\": null,\n \"total\": 15,\n \"completed\": 7,\n \"pending\": 8,\n \"success\": 7,\n \"failed\": 0\n }\n}"},{"id":"16c6458b-f08a-4c52-808e-d5050649d354","name":"Invalid Request_id","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"request_id\": \"{{request_id}}\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/api-processor/get-response"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json","description":""},{"key":"Content-Length","value":"274"},{"key":"Date","value":"Tue, 11 Jun 2024 12:06:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"bulk_api_processor_get_response_IGWBRItdvs5PqQZMKBdD\",\n \"timestamp\": 1717248272919,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid request_id\",\n \"data\": null\n}"}],"_postman_id":"727a725a-c817-4929-9ce8-b451ca35d554"}],"id":"1f31930d-b8f0-4849-8fa9-1679360652e4","description":"

Processing across various IDCentral APIs is simplified with the robust and flexible in-house Generic Bulk Processing API. This API provides an easy and unified method to handle multiple queries simultaneously. The API accepts input in the form of CSV files provided as URL and returns the response in CSV format. The process is completed using two endpoints: submit the request for bulk processing using the Generic Bulk Processor - Submit Request, and then retrieve the output file using the Generic Bulk Processor - Get Response.

List of APIs that can be processed using Bulk API Generic Processor:

API	Endpoint
Aadhaar Verification (V1)	/aadhaar/verification
Bank Account Verification (V1)	/bank
Forgery Detection (V1)	/detect/forgery
Driving License	/driving-license
getGstInDetails	/gstin
getGstInByPan	/gstin-by-pan
ITR Compliance Check	/itr-compliance-check
PAN Aadhaar Linking Status (V1)	/pan/aadhaar/status
PAN Details (V1)	/pan/details
PAN Verification (V1)	/pan/verify
Verify Passport	/passport-detail
PAN to Name *	/v2/pan/pan-name
PAN KRA Verification	/v2/pan/pan-kra
PAN Verification	/v2/pan/pan-verify
PAN Details *	/v2/pan/pan-details
Basic Aadhaar Verification	/v2/aadhaar/aadhaar-verify
PAN Aadhaar Linking Status	/v2/aadhaar/pan-linking-status
Bank Account Verification	/v2/bank/verify-bank
UPI	/v2/bank/verify-upi
RC Verify (V1)	/rc/verify
Get UAN	/epfo/uan/mobile
Penny-Drop BAV	/v2/bank/penny-drop
Penny-Less BAV	/v2/bank/penny-less
Verify Udyam	/v2/udyam/verify
Face Match	/v2/face-match
Liveness	/v2/liveness
OCR	/v2/ocr
Vehicle Challan API	/v2/vehicle-challan
Advanced Document Reader	/v2/advanced-document-reader
Mobile Number to Name	/v2/upi/mobile
RC Check	/v2/rc/verify
EPFO Details without OTP	/v2/epfo/details
Forgery Detection V2	/v2/forgery-detect
PAN Verify Plus	/v2/pan/pan-verify-plus
VoterID V2	/v2/voter-id
PAN Extended V2	/v2/pan/pan-extended
PAN Extended PLUS	/v2/pan/pan-extended-plus
PAN Contacts V2	/v2/pan/pan-contacts

","_postman_id":"1f31930d-b8f0-4849-8fa9-1679360652e4"},{"name":"To be deprecated","item":[{"name":"Aadhaar","item":[{"name":"Offline Aadhaar KYC","item":[{"name":"Aadhaar - Generate OTP","id":"af878be9-ee2f-45dd-93ed-5872c18e0bc0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aadhar/","description":"

You need the Aadhaar holder's consent to get the Aadhaar holder's details from the Aadhaar database. The Aadhaar holder provides this consent in the form of an OTP. Use the Aadhaar - Generate OTP to send an OTP to the mobile number linked to the Aadhaar you want to verify.

The response shows whether the OTP has been sent along with a unique client id which is required to validate the OTP and authenticate the Aadhaar details.

The OTP generated is valid for 10 minutes. post 10 minutes need to recall this API to authenticate the Aadhaar card.

Best Practices for Generating OTP

If API response is 'success' with status_code: 200 and response_code: 1 then users are requsted to wait for 60 seconds before generating a new OTP for the same Aadhaar using the Generate OTP to Verify Aadhaar API. This mainly occurs when OTP has been successfully generated but not received to to the user
If response is 'failed' then client can re-try the API immediately.
Generated OTP is valid for 10 minutes only.

Request:

Aadhaar number to be passed via endpoint URL

Response:

S.No	Key	Data Type	Description
1	data	Object	Data received after sending OTP to the registered mobile number
1.1	client_id	String	Unique identifier of this object/ query which will be used
1.2	otp_sent	Boolean	This Key field confirms whether OTP was sent to registered mobile number or not. If value `true` then OTP sent successfully and if value `false` then not sent
1.3	if_number	Boolean	This Key field confirms if the given Aadhaar number is linked to mobile number or not. If value `true` then Mobile number is linked and if `false` then not linked
1.4	valid_aadhaar	Boolean	This Key field confirms if given Aadhaar number is valid Aadhaar number or not. If value `true` the valid Aadhaar number and if `false` then not valid
5	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
6	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
7	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
8	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
9	message	String	A text content explains if API request was successful or not.
10	timestamp	Integer	API response receive time in milliseconds
11	error	String	A text content explains a reason if API request failed
12	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
13	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
14	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When OTP is successfully generated with valid Aadhar	200	1	success	Successful Request
All other mismatch errors	200	9
When Invalid Aadhaar is entered	400	-1	failed	Please Provide the Valid Aadhaar Card Number	Invalid Aadhaar Number
When Incorrect Aadhaar is entered	400	-1	failed	Please Provide the Valid Aadhaar Card Number	Invalid Aadhaar Number
When mobile number is not linked with Aadhaar	400	-1	failed	Mobile number not linked with aadhhar number	Invalid Mobile Number
When UID is locked	400	-1	failed	Unlock UID from UIDAI portal	UID Locked
When Aadhaar is suspended or cancelled	400	-1	failed	Please Provide the Valid Aadhaar Card Number	Invalid Aadhar Number
When user tries to generate OTP within 60 seconds from the previously generated OTP	429	60	failed	Rate Limited, Please try again after 60sec	Rate Limited

","urlObject":{"path":["aadhar",""],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"e749a7f4-d7fc-4a4b-ae4f-98b76bc8b1c2","name":"OTP successfully generated","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:14:09 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"aadhaar_v2_teWjvjxbzgbkOvGmrjhl\",\n \"otp_sent\": true,\n \"if_number\": true,\n \"valid_aadhaar\": true\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1667902448790,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_M72WOqX48F9WGR3NM7BD\"\n}"},{"id":"4a65cc45-8b50-4794-941e-af07dbad09d6","name":"Invalid Aadhaar No","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:14:33 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Aadhaar Card Number\",\n \"timestamp\": 1667902474459,\n \"error\": \"Invalid Aadhar Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_ctvjy38ZGvB0eR7C6kYX\"\n}"},{"id":"67c8c8c1-180d-405a-8103-1a2e87bb0786","name":"Incorrect Format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:16:31 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Aadhaar Card Number\",\n \"timestamp\": 1667902592370,\n \"error\": \"Invalid Aadhar Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_Vc77Lm4iEC7yJYxCXsnr\"\n}"},{"id":"eef92738-d74b-4eae-8bc1-3039c2d56f48","name":"Rate Limit","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Too Many Requests","code":429,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:33:24 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 429,\n \"response_code\": 60,\n \"message_code\": null,\n \"message\": \"Rate Limited, Please try again after 60sec\",\n \"timestamp\": 1667903604355,\n \"error\": \"Rate Limited.\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_ub0AhyNhRHaGEO34G6dJ\"\n}"},{"id":"1a63b91c-bf27-443f-ad23-ab50760f9be0","name":"Mobile not linked with Aadhaar","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Mon, 14 Nov 2022 11:38:17 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Mobile number not linked with aadhhar number\",\n \"timestamp\": 1668425890847,\n \"error\": \"Invalid Mobile Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_ppr4nyJLCqO65rpsjYcl\"\n}"},{"id":"614bc5e5-4bc6-4b8d-9f7c-b2edb86da403","name":"Locked UID","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 25 Nov 2022 09:26:03 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Unlock UID from UIDAI portal\",\n \"timestamp\": 1669368362745,\n \"error\": \"UID Locked\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_TrgoXFNRecXXXXXXXXXX\"\n}"},{"id":"ea1fb25e-154b-42c4-ae66-e4f92ce6d1eb","name":"Aadhaar Suspended or Cancelled","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json","disabled":true}],"url":"https://api.idcentral.io/idc/aadhar/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 25 Nov 2022 11:14:17 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Aadhaar Card Number\",\n \"timestamp\": 1669374857885,\n \"error\": \"Invalid Aadhar Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_NRb4iukrw4XXXXX\"\n}"}],"_postman_id":"af878be9-ee2f-45dd-93ed-5872c18e0bc0"},{"name":"Aadhaar - Submit OTP","id":"716fb6b4-52cf-41cb-8d57-4e56d3b22a01","protocolProfileBehavior":{"disabledSystemHeaders":{"content-type":true},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_LdabNsBqMkBaaXXXXXXXX\",\r\n \"otp\": \"450695\"\r\n}"},"url":"https://api.idcentral.io/idc/aadhar/otp","description":"

This API will validate the OTP entered by the customer to authenticate with UIDAI. The Aadhaar holder enters the received OTP. Once successfully validated aadhaar holder's details associated with the corresponding aadhaar number, like name, address, mobile number, age, date of birth etc. from the UIDAI Aadhaar database. The client_id generated from the \"Aadhaar - Generate OTP API\" request along with the OTP received by the customer on his Aadhaar-linked mobile phone are to be passed as parameters.

IDcentral APIs validate the downloadable Aadhaar XML file to read off KYC information and authenticate the same.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	client_id	String	Required	The client_id you have received from Generate OTP - Aadhaar OKYC API response.
2	otp	Integer	Required	The 6 digit OTP you have received on the registered phone number for offline Aadhaar verification.

Response:

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the Aadhaar Records
1.1	client_id	String	The client_id you have received from Generate OTP - Aadhaar OKYC API response.
1.2	full_name	String	Full Name as per Aadhaar Records
1.3	aadhaar_number	String	Aadhaar Number
1.4	dob	String	Date of Birth as per Aadhaar Records (yyyy-mm-dd)
1.5	gender	String	Gender as per Aadhaar Records. If Male, it will show 'M' and if Female. it will show 'F'.
1.6	address	Object	Address details as per Aadhaar Records
1.6.1	country	String	Country of residence as per Aadhaar Records
1.6.2	dist	String	District as per Aadhaar Records
1.6.3	state	String	State as per Aadhaar Records
1.6.4	po	String	Post Office as per Aadhaar Records
1.6.5	loc	String	Location as per Aadhaar Records
1.6.6	vtc	String	VTC (Village Town City) name as per Aadhaar Records
1.6.7	subdist	String	Sub-District / Taluka name as per Aadhaar Records
1.6.8	street	String	Street details as per Aadhaar Records
1.6.9	house	String	House No. as per Aadhaar Records
1.6.10	landmark	String	Landmark details as per Aadhaar Records
1.7	face_status	Boolean	If face found in the aadhaar XML file. If `true` then it confirms the face is found and if `false` then face not found
1.8	face_score	Integer	Face score based on if face found in Aadhaar XML found
1.9	zip	String	Pincode as per the Aadhaar Recor
1.10	profile_image	String	Profile Image fetched from the shared XML file. The image file is in base64 format
1.11	has_image	String	This key param value confirms if Aadhaar XML file has image or not. Expected values: `true false`
1.12	raw_xml	String	Aadhaar raw XML file storage path from AWS S3.
1.13	zip_data	String	AWS S3 path of Aadhaar XML file in compressed format.
1.14	care_of	String	Care of (Father or Husband) person name of the Aadhaar holder as per Aadhaar records
1.15	share_code	String	Share code of the Aadhaar. This share is used to unlock the zipped XML file
1.16	mobile_verified	Boolean	Status of the mobile verification as per Aadhaar records
1.17	reference_id	String	reference ID as per the Aadhaar records
1.18	aadhaar_pdf	String	AWS S3 path of Aadhaar XML file converted to PDF format
2	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
3	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
4	message	String	A text content explains if API request was successful or not.
5	success	Boolean	if successful API response, the value as true else false
6	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
7	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
8	timestamp	Integer	API response receive time in milliseconds
9	error	String	A text content explains a reason if API request failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When correct OTP and client_id is passed	200	1	success	Successful Request
When incorrect client_id is passed while submitting the OTP	400	-1	failed	Pass the Client_id key value generated in Generate OTP API	Invalid Client Id
When incorrect OTP is passed	400	-1	failed	Please pass the valid OTP sent to the registered mobile number	Invalid OTP
When empty OTP is passed	400	-1	failed	Pass the OTP sent to the registered mobile number	OTP should be mandatory
All other mismatch errors	200	9

","urlObject":{"path":["aadhar","otp"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"bebc243b-5560-4157-991c-454ad6002e8e","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"bfaaa120e302b31fb4e3e349f5eb0efd"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_ZCbiewmpZnXXXXXXXXXX\",\r\n \"otp\": \"324126\"\r\n}"},"url":"https://api.idcentral.io/idc/aadhar/otp"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 02:35:40 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"token\": null,\n \"client_id\": \"aadhaar_v2_ZCbiewmpZnXXXXXXXXXX\",\n \"full_name\": \"XXXXXXXX XXXXXXXX XXXXXX\",\n \"aadhaar_number\": \"XXXXXXXX4341\",\n \"dob\": \"XXXX-XX-XX\",\n \"gender\": \"M\",\n \"address\": {\n \"country\": \"India\",\n \"dist\": \"Pune\",\n \"state\": \"Maharashtra\",\n \"po\": \"Bhadas\",\n \"loc\": \"Asade,Bhads\",\n \"vtc\": \"Asade\",\n \"subdist\": \"Mulshi\",\n \"street\": \"\",\n \"house\": \"\",\n \"landmark\": \"\"\n },\n \"face_status\": false,\n \"face_score\": -1,\n \"zip\": \"412108\",\n \"profile_image\": \"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\",\n \"has_image\": true,\n \"raw_xml\": \"https://aadhaar-kyc-docs.s3.amazonaws.com/subex/aadhaar_xml/434120221109080540730/434120221109080540730-2022-11-09-023540863269.xml?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5PAM3NMHW%2F20221109%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20221109T023540Z&X-Amz-Expires=432000&X-Amz-SignedHeaders=host&X-Amz-Signature=aff3f890d172cab4a5cc50514f1f86a56041878c9e2b6813d9865ad27ec95bc1\",\n \"zip_data\": \"https://aadhaar-kyc-docs.s3.amazonaws.com/subex/aadhaar_xml/434120221109080540730/434120221109080540730-2022-11-09-023540796871.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAY5K3QRM5PAM3NMHW%2F20221109%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Date=20221109T023540Z&X-Amz-Expires=432000&X-Amz-SignedHeaders=host&X-Amz-Signature=fd4caa66acc66a93608132ec52743a1f5375b3f4a046f3923b85f7b3a34c1a6c\",\n \"care_of\": null,\n \"share_code\": \"1963\",\n \"mobile_verified\": false,\n \"reference_id\": \"434120221109080540730\",\n \"aadhaar_pdf\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1667961340287,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_IsCUL0moYBXXXXXXXXXX\"\n}"},{"id":"8bf2f2b8-8935-4555-b40a-38a98225f45f","name":"Incorrect Client ID","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"TXNBKSK45GOY3\",\r\n \"otp\": \"833623\"\r\n}"},"url":"https://api.idcentral.io/idc/aadhar/otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:34:58 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Pass the Client_id key value genearated in Generate OTP API\",\n \"timestamp\": 1667903698170,\n \"error\": \"Invalid Client Id\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_hsCkzydlPXXXXXXXXXX\"\n}"},{"id":"b1b2a720-3c06-4a2f-a2be-d3c76d7adee9","name":"Invalid OTP","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_iiJijsbsqdXXXXXXXXXX\",\r\n \"otp\": \"833623\"\r\n}"},"url":"https://api.idcentral.io/idc/aadhar/otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:40:29 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please pass the valid OTP sent to the registered mobile number\",\n \"timestamp\": 1667904011527,\n \"error\": \"Invalid OTP\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_LigNxY1yCfXXXXXXXXXX\"\n}"},{"id":"992154be-8eed-41f0-bdf6-448c26713314","name":"Passed empty OTP value","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"client_id\": \"aadhaar_v2_iiJijsbsqdYXXXXXXXXXX\",\r\n \"otp\": \"\"\r\n}"},"url":"https://api.idcentral.io/idc/aadhar/otp"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 08 Nov 2022 10:41:12 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Pass the OTP sent to the registered mobile number\",\n \"timestamp\": 1667904072837,\n \"error\": \"OTP should be mandatory\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_aadhar_verification_edUJWIGfpXXXXXXXXXX\"\n}"}],"_postman_id":"716fb6b4-52cf-41cb-8d57-4e56d3b22a01"}],"id":"25865573-e29b-4bf8-af1d-4174b2599075","_postman_id":"25865573-e29b-4bf8-af1d-4174b2599075","description":""},{"name":"Basic Aadhaar Verification","id":"da4ce3ff-3637-4d82-90fd-f0d0efecb3fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"abc abc bcbe\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aadhaar/verification","description":"

Basic Aadhaar Verification allows for a real time Aadhaar number verification. Aadhaar uses a certain sequence of digits, not every 12-digit number is a genuine Aadhaar. The basic information, such as the gender, age range, last three digits of the mobile number, and registration address state, are also returned by this API in addition to validating the accuracy of the Aadhaar number.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	aadhaar_number	String	Required	Unique 12 digit Aadhaar number

Response Model

S. No	Key	Data Type	Description
1	data	Object	Information fetched from Aadhaar
1.1	State	String	Confirms State of the Aadhaar card holder
1.2	age_band	String	It confirm age band in which customer falls into.
1.3	gender	String	Gender of a Aadhaar card holder
1.4	mobile	String	Registered Mobile number with Aadhaar
1.5	aadhaar_number	Staring	Aadhaar Number
1.6	aadhaar_exists	String	It confirms whether given aadhaar number is valid or not.
2	status	Staring	A text content confirms if API request was successfully completed or not. If value success then request was successfully processed and received response. and if failed then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
4	response_code	String	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	Integer	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	Staring	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid Aadhaar is entered	200	1	success	Successful Request
When incorrect Aadhaar is entered	200	9	failed	verification_failed	verification_failed
When invalid Aadhaar is entered	400	-1	failed	Please Provide the Valid Aadhaar Number	Invalid Aadhar Number
All other mismatch errors	200	9

","urlObject":{"path":["aadhaar","verification"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"249676dd-b731-410b-a501-18f661d16f5f","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"XXXXXXXX4341\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aadhaar/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:41:09 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"state\": \"Maharashtra\",\n \"age_band\": \"30-40\",\n \"gender\": \"MALE\",\n \"mobile\": \"xxxxxxx280\",\n \"aadhaar_number\": \"XXXXXXXX4341\",\n \"aadhaar_exists\": \"true\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1667958067817,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aadhaar_verification_whSmXg0jDVXXXXXXXXXX\"\n}"},{"id":"348030eb-7d21-4a5b-bc50-4a8207dc9d93","name":"Invalid Aadhar","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"abc abc bcbe\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aadhaar/verification"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:40:31 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Aadhaar Number\",\n \"timestamp\": 1667958031354,\n \"error\": \"Invalid Aadhar Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"aadhaar_verification_L66hhGAh3yxZcQicQsAt\"\n}"},{"id":"b828fec3-b5bf-4c0c-8fed-d679e793e5f7","name":"Incorrect Aadhar","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"XXXXXXXX4341\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aadhaar/verification"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:41:41 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"state\": null,\n \"age_band\": null,\n \"gender\": null,\n \"mobile\": null,\n \"aadhaar_number\": \"378221184341\",\n \"aadhaar_exists\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"verification_failed\",\n \"message\": \"verification_failed\",\n \"timestamp\": 1667958101403,\n \"error\": \"verification_failed\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"aadhaar_verification_uwByslPEh5XXXXXXXXXX\"\n}"}],"_postman_id":"da4ce3ff-3637-4d82-90fd-f0d0efecb3fe"},{"name":"PAN Aadhaar Linking Status","id":"93b1efbc-4451-4437-9988-132a90b96b7e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"XXXXXXXXXX\",\n \"pan\": \"XXXXXXXX\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/aadhaar/status","description":"

As per CBDT India circular issued in 2022, it is now mandatory for individuals who have been allotted PAN numbers to link their PAN with Aadhaar. This API offers a real time validation of such linking status for a given pair of PAN and Aadhaar number.

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	aadhaar_number	String	Required	Unique 12 digit Aadhaar number
2	pan	String	Required	PAN card number

Response

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the Aadhaar - PAN linking Records
1.1	message	String	Confirms whether given PAN is linked with Aadhaar or not
2	status_code	String	The http status code of the API. Refer Errors and Status Codes
3	status	Staring	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
4	response_code	String	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	error	String	A text content explains a reason if API request failed
6	txn_id	Staring	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When user Aadhaar and PAN is successfully Linked	200	1	success	Your PAN AYXXXXXX1P is already linked to given Aadhaar 37XXXXXXXX41
When user PAN is not linked to Aadhaar	200	9	success	This PAN is linked to some other Aadhaar <45XXXXXXXX32> If details entered by you are correct please lodge a request under Grievances or contact Helpdesk to delink Aadhaar and link to this PAN.	verification_failed
When Invalid PAN is entered	200	9	success	PAN does not exist.	verification_failed
When invalid Aadhaar is entered	200	9	success	Please enter a valid 12 digit Aadhaar number.	verification_failed
All other mismatch errors	200	9

","urlObject":{"path":["pan","aadhaar","status"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"6f756bd7-4aeb-49b0-818c-f02fe2f25f69","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"XXXXXXXX4341\",\n \"pan\": \"XXXXB9611P\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/aadhaar/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 14 Oct 2022 06:39:53 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"Your PAN AYXXXXXX1P is already linked to given Aadhaar 37XXXXXXXX41\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1665729592878,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"pan_aadhaar_status_Tnu0LJoEV5XXXXXXXXXX\"\n}"},{"id":"4961f956-8934-4a40-88ba-9cfef765c737","name":"PAN not linked to given Aadhaar","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"XXXXXXXX4341\",\n \"pan\": \"XXXXX6701E\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/aadhaar/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 14 Oct 2022 06:43:17 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"This PAN is linked to some other Aadhaar <45XXXXXXXX32> If details entered by you are correct please lodge a request under Grievances or contact Helpdesk to delink Aadhaar and link to this PAN.\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"success\",\n \"message\": \"This PAN is linked to some other Aadhaar <45XXXXXXXX32> If details entered by you are correct please lodge a request under Grievances or contact Helpdesk to delink Aadhaar and link to this PAN.\",\n \"timestamp\": 1665729797339,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"pan_aadhaar_status_rIE1G06VrtXXXXXXXXXX\"\n}"},{"id":"f7d413d0-c90b-4c22-ba6d-39d02967bee6","name":"Invalid Aadhaar","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"478222184341\",\n \"pan\": \"ACLPL6701E\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/aadhaar/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:37:32 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"Please enter a valid 12 digit Aadhaar number.\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"success\",\n \"message\": \"Please enter a valid 12 digit Aadhaar number.\",\n \"timestamp\": 1667957851816,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"pan_aadhaar_status_eCR5mmej0bXXXXXXXXXX\"\n}"},{"id":"32826101-dc0c-48fa-9523-2b6c0fdbdc96","name":"Invalid PAN","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"aadhaar_number\": \"378222184341\",\n \"pan\": \"BCLPL6701E\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/aadhaar/status"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:38:08 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"PAN does not exist.\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"success\",\n \"message\": \"PAN does not exist.\",\n \"timestamp\": 1667957888341,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"pan_aadhaar_status_Tb8HlPv5VXXXXXXXXXX\"\n}"}],"_postman_id":"93b1efbc-4451-4437-9988-132a90b96b7e"}],"id":"4e114b01-cb44-4dbd-a199-3f8024cc6935","_postman_id":"4e114b01-cb44-4dbd-a199-3f8024cc6935","description":""},{"name":"PAN","item":[{"name":"PAN Details","id":"c1231189-724f-4741-9fa3-6bad12d0d46f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"panNumber\": \"AYHPB9611P\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/details","description":"

PAN details API is used get the basic PAN details of the PAN card holder. It requires PAN number to be entered. It gives basic demographic details.

PAN Status Code - Possible Values & Meaning

PAN status is shares the details about PAN card. If a PAN card holder deseased, if PAN card is invalid / valid or PAN being blocked by my misconduct and reported. The status will be marked.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status Code	Meaning
E	Valid
F	Fake
X	Deactivated
D	Deleted
N	Invalid
EA	Amalgamation
EC	Acquisition
ED	Death
EI	Dissolution
EL	Liquidated
EM	Merger
EP	Partition
ES	Split
EU	Under Liquidation
I	Inoperative

Aadhaar Seeding Status - Possible Values & Meaning

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Aadhar Seeding Status Code	Meaning
Y	Seeding Successful
R	Seeding Unsuccessful
Blank	Not Seeded
NA	Not Applicable

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Type	Required	Description
1	panNumber	String	Required	Unique PAN Number

Response

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the PAN Records
1.1	name	String	PAN card holder's name as registered in NSDL database
1.2	number	String	PAN card Number
1.3	type_of_holder	String	Category of tax payer as registered with NSDL. (eg. Business / Person)
1.4	type_of_holder_code	String	Category of PAN - Code.
1.5	is_individual	Staring	Category of PAN - Confirms if the PAN is individual or Business. If value as `true` then this belongs to an individual person and if `false` then belongs to business
1.6	is_valid	String	It confirms whether PAN number exists or not. If value `true` then PAN number is valid and if `false` then PAN number is invalid
1.7	first_name	String	First Name of the PAN card holder
1.8	middle_name	String	Middle Name of the PAN card holder
1.9	last_name	String	Last Name of the PAN card holder
1.10	title	String	Title (Mr/Ms/Mrs/Sri)
1.11	pan_status	String	It confirms whether PAN number is valid or not
1.12	pan_status_code	String	PAN status code. Refer: Pan Status Code - Possible Values & Meaning
1.13	aadhaar_seeding_status	String	Aadhaar-PAN seeding status. This field confirms if Aadhaar-PAN is linked or not. Refer: Aadhar Seeding Status - Possible Values & Meaning
1.14	aadhaar_seeding_status_code	String	Aadhaar- PAN seeding status code. Refer: Aadhar Seeding Status - Possible Values & Meaning
1.15	last_updated_on	Staring	A Date when PAN details were last updated
2	status	Staring	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
4	response_code	String	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	String	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	Staring	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid PAN is entered	200	1	success	Successful Request
When Incorrect PAN is entered	200	9	failed	Invalid Pan Number	Invalid Request
All other mismatch errors	200	9
When Invalid PAN is entered	400	-1	failed	Please Provide the Valid Pan Card Number	Invalid Pan Card Number

","urlObject":{"path":["pan","details"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"ca84898b-76e3-4ce5-803b-bfbf033001ae","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"panNumber\": \"XXXXX9611P\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:43:37 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"name\": \"XXXXXX XXXXXXXX D\",\n \"number\": \"XXXXX9611P\",\n \"type_of_holder\": \"Individual or Person\",\n \"type_of_holder_code\": \"P\",\n \"is_individual\": \"true\",\n \"is_valid\": \"true\",\n \"first_name\": \"XXXXXXXX\",\n \"middle_name\": \"XXXXXXXX\",\n \"last_name\": \"XXXXXX\",\n \"title\": \"Shri\",\n \"pan_status\": \"VALID\",\n \"pan_status_code\": \"E\",\n \"aadhaar_seeding_status\": \"Successful\",\n \"aadhaar_seeding_status_code\": \"Y\",\n \"last_updated_on\": \"12/07/2017\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1667958217652,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"pan_verify_AhLs7LtVRvXXXXXXXXXX\"\n}"},{"id":"ac507b6c-8595-4055-a09d-ecefa79921ba","name":"Invalid PAN","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"panNumber\": \"exercitation Excepteur cillum qui\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/details"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:43:09 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Pan Card Number\",\n \"timestamp\": 1667958189538,\n \"error\": \"Invalid Pan Card Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"pan_verify_HcQTRUbBRDXXXXXXXXXX\"\n}"},{"id":"a543bc3f-c2bf-49ac-9881-c990e246f48a","name":"Incorrect PAN","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"panNumber\": \"AYHPB9611Q\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/details"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:44:29 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"pan Number is not valid\"\n },\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": null,\n \"message\": \"Invalid Pan Number\",\n \"timestamp\": 1667958268894,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"pan_verify_1bE3ctHHmeXXXXXXXXXX\"\n}"}],"_postman_id":"c1231189-724f-4741-9fa3-6bad12d0d46f"},{"name":"PAN to Name","id":"2a943ad7-cc09-40e9-823a-ab5d3b0c849b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/{{pan_number}}","description":"

PAN to Name API helps to get the Pan Holder Name by using PAN card Unique number.

Request: The PAN card number is passed via endpoint URL.

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	key	Data Type	Description
1	data	Object	Information fetched from the PAN Records
1.1	client_id	String	Unique identifier of this object/ query which will be used as an reference ID
1.2	pan_number	String	PAN Number
1.3	full_name	String	PAN Card Holder Full Name as per the PAN records
1.4	category	String	Category of tax payer as registered with NSDL. (eg. Business / Person)
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Integer	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message
When valid PAN details are entered	200	1	success	Successful Request
Invalid PAN is entered	400	-1	failed	Please Provide the Valid Pan Card Number
All other mismatch errors	200	9

","urlObject":{"path":["pan","{{pan_number}}"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"59192b29-9f01-4cc4-a40a-988582ba9c09","name":"Success Scenario","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/{{pan_number}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 04:37:51 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"indian_pan_to_name_NkVRZ9dYOLXXXXXXXXXX\",\n \"pan_number\": \"XXXXX9611P\",\n \"full_name\": \"XXXXXXXX XXXXXXXX XXXXXX\",\n \"category\": \"Individual or Person\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1669696670777,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"indian_pan_to_name_NkVRZ9dYOLXXXXXXXXXX\"\n}"},{"id":"b5643649-ebe7-4c34-9057-5b03fca66cf1","name":"Incorrect PAN","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 04:38:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"message\": \"pan Number is not valid\"\n },\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": null,\n \"message\": \"Invalid Pan Number\",\n \"timestamp\": 1669696721875,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"indian_pan_to_name_0bpkJZshnXXXXXXXXXXX\"\n}"},{"id":"a06d1b11-237c-455e-a9cd-192604cf2861","name":"Invalid PAN number","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 04:39:35 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Pan Card Number\",\n \"timestamp\": 1669696775476,\n \"error\": \"Invalid Pan Card Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_pan_to_name_6rhlruz1wSXXXXXXXXXX\"\n}"}],"_postman_id":"2a943ad7-cc09-40e9-823a-ab5d3b0c849b"},{"name":"PAN KRA Verification","id":"8b05df0a-ce32-4cf0-8179-4575067ab92e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/{{pan_number}}/kra","description":"

PAN KRA Verification API helps in the PAN Card KRA (KYC Registration Agency) verification process. This API checks if the given PAN number is already available with KRA database or not. In this API we can verify the KRA status instantly by passing the request value as unique PAN card Number.

What is KRA?

Earlier, the investors could easily complete their KYC process by simply opening an account with any of the SEBI intermediaries and submitting relevant documents. Later, this process caused very high duplication of KYC records as the customer had to undergo the process of KYC with each entity separately. Therefore, in order to bring uniformity in the KYC process and eliminate such duplications, SEBI introduced the concept of KRA (KYC Registration Agency).

As per the SEBI guidelines of 2011, the investors who wish to invest in Mutual Funds or become KYC complaint have to register with any one of the authorized agencies. Once the customers are registered or are KYC compliant, they can start Investing in Mutual Funds.

There are 5 KYC Registration Agencies

CVL KRA
CAMS KRA
Karvy KRA
NSDL KRA
NSE KRA

Request: The PAN Card number is passed via endpoint URL

Response:

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the PAN KRA Records
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	pan_number	String	PAN Number passed in request
1.3	pan_kra_status	String	This Key field confirms if gieven PAN number is KRA compliant or not. if value `True` then PAN is KRA compliant and if `False` then KRA not compliant.
1.4	pan_kra_agency	String	This Key field confirms the name of KRA authorised agency name if `pan_kra_status` is `True.` This key field will show `null` if `pan_kra_status` is `False`
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	KRA Status	Error
When valid KRA linked PAN is entered	200	1	success	Successful Request	True
When valid non KRA linked PAN is entered	200	1	success	Successful Request	False
When invalid PAN is entered	400	-1	failed	Please Provide the Valid Pan Card Number		Invalid Pan Card Number
All other mismatch errors	200	9

","urlObject":{"path":["pan","{{pan_number}}","kra"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"955c0d9d-fff7-48ea-aa5e-b0c066e129ef","name":"Success Scenario","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan/{{pan_number}}/kra"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 05:46:05 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"202212071XXXXXXXXXX\",\n \"pan_number\": \"XXXXX9611P\",\n \"pan_kra_status\": \"True\",\n \"pan_kra_agency\": \"CVL KRA\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670391961183,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_pan_kra_pTg0s4cnKBXXXXXXXXXX\"\n}"},{"id":"089aef56-bb6e-4d9d-91ab-a275a1f18432","name":"Incorrect PAN","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan//kra"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:52:34 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Pan Card Number\",\n \"timestamp\": 1667958754503,\n \"error\": \"Invalid Pan Card Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_pan_kra_cZ3hx99NoWXXXXXXXXXX\"\n}"},{"id":"9a712187-de17-45d1-a1c5-8abb3258f9dc","name":"When PAN is not linked","originalRequest":{"method":"GET","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/pan//kra"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 07:27:46 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"pan_kra_apsYaCaUnyXXXXXXXXXX\",\n \"pan_number\": \"XXXXX8869F\",\n \"pan_kra_status\": \"False\",\n \"pan_kra_agency\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1667978855618,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_pan_kra_NH5mx0LxCDXXXXXXXXXX\"\n}"}],"_postman_id":"8b05df0a-ce32-4cf0-8179-4575067ab92e"},{"name":"PAN Verification","id":"439e67e4-dd83-4a3c-8d5f-023ca973a18b","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXX\",\r\n \"dob\": \"YYYY-MM-DD\",\r\n \"full_name\": \"XXXXXXXXXX\"\r\n}"},"url":"https://api.idcentral.io/idc/pan/verify","description":"

PAN verification API is a robust way to verify the authenticity of a PAN card number from the databse of government issuing authority. This API requests PAN Card Unique Number, Full Name and Date of Birth from end user.

In Response, The PAN card will get verified successfully only when the requests three input values are valid as per the Pan Card Records.

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	id_number	String	Required	The Unique PAN Card number
2	dob	String	Required	Date of Birth as per the PAN card (YYYY-MM-DD) format
3	full_name	String	Required	Full Name of the PAN Holder as per PAN card

Response:

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the PAN Records
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	pan_number	String	PAN Number passed in request
1.3	full_name	String	Full Name of the PAN Holder as per the request
1.4	dob	String	Date of Birth of the PAN Holder as per the request
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	String	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid details are passed and matched	200	1	success	Successful Request
When valid details do not match	200	9	failed	UNPROCESSABLE ENTITY	UPSTREAM_ERROR
When no DOB value is passed	400	-1	failed	Date of birth should not be null	Invalid Request
When invalid PAN is entered	400	-1	failed	Please Provide the Valid Pan Card Number	Invalid Pan Card Number
All other response code	200	9

","urlObject":{"path":["pan","verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"6bfbb793-9dd1-42a3-95c9-ba8f535b1afc","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"XXXXX4650M\",\r\n\r\n \"dob\": \"YYYY-MM-DD\",\r\n\r\n \"full_name\": \"XXXXXXX XXXXX\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 06:50:07 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"pan_ygZorzWyUDXXXXXXXXXX\",\n \"pan_number\": \"XXXXX4650M\",\n \"full_name\": \"XXXXXXX XXXXX\",\n \"dob\": \"YYYY-01-02\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670395807902,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_pan_verification_FccBsEWfwcXXXXXXXXXX\"\n}"},{"id":"5baed48d-c09a-43a1-b985-b5786a82f1de","name":"Empty DOB","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"XXXXX4650M\",\r\n\r\n \"dob\": \"\",\r\n\r\n \"full_name\": \"XXXXXXX XXXXX\"\r\n\r\n}"},"url":"https://api.idcentral.io/idc/pan/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 10:05:57 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Date of birth should not be null\",\n \"timestamp\": 1670407558635,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_pan_verification_jHkVJa5ox9DNHtoqC6x9\"\n}"},{"id":"b89eb44a-dd67-48d9-b770-b9ffe353d866","name":"Invalid PAN Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\r\n \"id_number\": \"AYHIPKHUU0\",\r\n\r\n \"dob\": \"YYYY-01-02\",\r\n\r\n \"full_name\": \"XXXXXXX XXXXX\"\r\n\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/pan/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 10:07:13 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please Provide the Valid Pan Card Number\",\n \"timestamp\": 1670407633226,\n \"error\": \"Invalid Pan Card Number\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_pan_verification_aOL9f0NrFHsXnuFaRWsu\"\n}"},{"id":"8b1d41bd-f976-4700-b85b-5c9c729b801f","name":"Details Do not match","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"XXXXXXXXXX\",\r\n \"dob\": \"1992-12-18\",\r\n \"full_name\": \"Prashant D Shide\"\r\n}"},"url":"https://api.idcentral.io/idc/pan/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 09 Nov 2022 01:56:23 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"pan_nLInOepOJdXXXXXXXXXX\",\n \"pan_number\": \"XXXXX9611P\",\n \"full_name\": \"XXXXXXX D SHIDE\",\n \"dob\": \"YYYY-02-18\"\n },\n \"status\": \"failed\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": null,\n \"message\": \"UNPROCESSABLE ENTITY\",\n \"timestamp\": 1667958982808,\n \"error\": \"UPSTREAM_ERROR\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_pan_verification_EuyRCmHMQEXXXXXXXXXX\"\n}"}],"_postman_id":"439e67e4-dd83-4a3c-8d5f-023ca973a18b"},{"name":"PAN Advanced","id":"e5e93ef1-7616-471f-bea8-888c432394eb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"{{pan_number}}\"\n}"},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced","description":"

The \"PAN Advanced API\" allows user to fetch data associated with that PAN number including linked aadhaar number.

Request -

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	PAN number

Response:

S.No	Key	Data Type	Description
1	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API
2	timestamp	Integer	API response received time in milliseconds
3	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
4	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
5	response_code	String	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	error	String	This text content explains the reason if API request has failed
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	data	String	Data contains the detailed information received
8.1	aadhaar_number	Integer	Aadhaar number linked to the PAN number
8.2	pan	String	PAN number
8.3	first_name	String	First name
8.4	middle_name	String	Middle name
8.5	last_name	String	Last name
8.6	gender	String	Gender of the person
8.7	dob	String	date of birth in DD-MM-YYYY format
8.8	address	String	Address
8.9	city	String	City in address
8.10	state	String	State in address
8.11	pincode	Integer	Pincode in address
8.12	country	String	Country in address
8.13	email	String	Email linked to the PAN number
8.14	mobile_no	Integer	Mobile number linked to the PAN number

Scenarios Covered:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Scenario	Status	Status Code	Response Code	Message
1	Successful Scenario when valid PAN number is passed	success	200	1	Successful request
2	When PAN is not linked to Aadhaar Card	success	200	2	Successful request, Aadhaar not linked
3	When invalid PAN format is passed	success	200	3	Invalid PAN format
4	When invalid PAN is passed	success	200	4	PAN Details not found
5	When empty PAN is passed	failed	400	-1	Invalid request, PAN required

","urlObject":{"path":["v2","pan","pan-advanced"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"06fbdba4-59dd-4102-b41d-6432c3dfb201","name":"Successful Scenario","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"{{pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 12 May 2023 08:53:58 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_pan_0GN2kzT6BNvRw9uJh1xj\",\n \"timestamp\": 1683881636995,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"aadhaar_number\": \"{{aadhaar_number}}\",\n \"pan\": \"{{pan_number}}\",\n \"first_name\": \"{{first_name}}\",\n \"middle_name\": \"\",\n \"last_name\": \"{{last_name}}\",\n \"gender\": \"male\",\n \"dob\": \"{{DD-MM-YYYY}}\",\n \"address\": \"{{address}}\",\n \"city\": \"{{city}}\",\n \"state\": \"{{state}}\",\n \"pincode\": \"{{pincode}}\",\n \"country\": \"\",\n \"email\": \"\",\n \"mobile_no\": \"\"\n }\n}"},{"id":"621baf38-2328-495c-bfac-1ccbe3a6b393","name":"Invalid PAN format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"{{invalid_pan_format}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 12 May 2023 09:01:30 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_pan_jL05iXaa0QVB7h7O5kyi\",\n \"timestamp\": 1683882090145,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"error\": null,\n \"message\": \"Invalid PAN format\",\n \"data\": null\n}"},{"id":"80c861bc-9a5f-4daf-aafc-24fae35a38eb","name":"Invalid PAN","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"{{invalid_pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 12 May 2023 09:02:02 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_pan_ev548KEetllonKtgYp6G\",\n \"timestamp\": 1683882121107,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 4,\n \"error\": null,\n \"message\": \"PAN Details not found\",\n \"data\": null\n}"},{"id":"17c6db25-da33-4b8c-aa8e-a52296447e39","name":"When empty PAN is passed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 16 May 2023 04:23:44 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_pan_jtFVWhJVful4tH9JbBBn\",\n \"timestamp\": 1684211023996,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"error\": \"Validation error\",\n \"message\": \"Invalid request, PAN required\",\n \"data\": null\n}"},{"id":"c37337d5-7052-4f2f-bf88-6643f6fe2dbd","name":"When PAN is not linked to aadhaar card","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}"},{"key":"isConsentGranted","value":"true"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id_number\": \"{{pan_number}}\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/v2/pan/pan-advanced"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 16 May 2023 04:24:23 GMT"},{"key":"Keep-Alive","value":"timeout=20"},{"key":"Connection","value":"keep-alive"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"advanced_pan_efPKjdkSj8wCSEX0WZ78\",\n \"timestamp\": 1684211062283,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"error\": null,\n \"message\": \"Successful request, Aadhaar not linked\",\n \"data\": {\n \"aadhaar_number\": \"0\",\n \"pan\": \"{{pan_number}}\",\n \"first_name\": \"{{first_name}}\",\n \"middle_name\": \"\",\n \"last_name\": \"{{last_name}}\",\n \"gender\": \"male\",\n \"dob\": \"{{DD-MM-YYYY}}\",\n \"address\": \"{{address}}\",\n \"city\": \"{{city}}\",\n \"state\": \"{{state}}\",\n \"pincode\": \"{{pincode}}\",\n \"country\": \"\",\n \"email\": \"\",\n \"mobile_no\": \"\"\n }\n}"}],"_postman_id":"e5e93ef1-7616-471f-bea8-888c432394eb"}],"id":"4eff8987-5e0e-4d75-884f-c4d9e93af713","_postman_id":"4eff8987-5e0e-4d75-884f-c4d9e93af713","description":""},{"name":"Bank Account Verification","item":[{"name":"Bank Account Verification","id":"1cba2a42-9451-43a1-879d-2997b87792c1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank","description":"

Bank Account Verification API helps you verify the bank account by depositing Rs. 1 to the Bank account holder account and in response you get customer name.

Bank account verification uses the IMPS network. Verification will return the account holder name for any valid IFSC of the bank where the account exists.

If client wishes to get reponse codes recieved from NPCI of the transaction, an additional parameter \"extended_data\" can be added in request body.

Definition

Extended Data - Extended Data is an additional data fileds that we get along with full name in response. there can be only 2 possible values for it, either true or false.

False - When you set it as false Bank Account Verification API gives you only beneficiary name in response.

NPCI Online Response Code : Online response code is a code that is generated by NPCI's systems in real-time in response to a transaction request made by a user or a merchant.

All the response codes and their description are given in the below table.

S.No	NPCI Back Office Response Code	Online Response Code	Description
1	0	00	TRANSACTION APPROVED
2	1	XC	INVALID TRANSACTION
3	6	XD	INVALID AMOUNT FIELD
4	7	E15	INVALID RESPONSE CODE
5	8	91	PROCESSOR DOWN
6	39	UB	UNABLE TO PROCESS
7	12	12	INVALID ACCOUNT
8	17	61	EXCEEDS ACCOUNT LIMIT
9	18	XF	INVALID MESSAGE
10	37	37	CURRENCY CONVERSION ERROR
11	38	94	DUPLICATE TRANSACTION
12	CU	08	HOST (CBS) OFFLINE
13	IU	08	ISSUER NODE OFFLINE
14	M0	M0	VERIFICATION SUCCESSFUL ORGINAL TRXN DECLINED
15	M1	M1	INVALID BENEFICIARY MOBILE NO/MAS
16	M2	M2	AMOUNT LIMIT EXCEEDED
17	M3	M3	ACCOUNT BLOCKED/FROZEN
18	M4	M4	NRE ACCOUNT
19	M5	M5	ACCOUNT CLOSED
20	M6	M6	LIMIT EXCEEDED FOR MEMBER BANK
21	MP	MP	BENIFICARY BANK NOT ENABLE FOR P2A
22	MW	MW	FOREIGN INWARD REMITTANCE FOR P2P ONLY
23	MI	MI	CUSTOMER TX. LIMIT EXCEEDED
24	MN	MN	FOREIGN INWARD REMITTANCE NOT ALLOWED
25	48	ZI	SUSPECTED FRAUD
26	78	78	TRANSFER AMOUNT EXCEEDS LIMIT
27	86	92	TRANSFER AMOUNT EXCEEDS LIMIT
28	MJ	MJ	INVALID BENEFICIARY IFSC CODE OR NBIN
29	MR	MR	TRANSACTION AMOUNT LESS THAN RS.1
30	22	22	TRANSACTION NOT ALLOWED AS AMOUNT IS GREATER THAN 2 LAKHS (APPLICABLE FOR BANKS WHERE NDC IS GREATER THAN 2 LAKHS)
31	MQ	MQ	TRANSACTION NOT ALLOWED AS INVALID PAYMENT REFERENCE
32	MS	MS	TRANSACTION NOT ALLOWED AS INVALID REMITTER ACC. NO
33	MT	MT	TRANSACTION NOT ALLOWED AS GENERAL ERROR
34	24	24	INSUFFICENT BALANCE IN POOL A/C
35	96	96	CHECK TRANSACTION LIMIT EXCEEDED
36	FR	59	SUSPECTED FRAUD, DECLINE / TRANSACTION DECLINED BASED ON RISK SCORE
37	77	77	SUSPECTED FRAUD, TRANSACTION DECLINED BASED ON RISK SCORE

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_number	String	Required	Bank account to be validated (6 to 40 character limit)
2	ifsc	String	Required	IFSC of the bank account to be validated (standard IFSC format - length 11, first four bank IFSC and 5th 0)
3	extended_data	Boolean	Optional	Possible values true / false. Set this as true when you Extended Data is required, else set it as false.

Response

S. No	key	Data Type	Description
1	data	Object	Information fetched from the asscoiated Bank Records
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	account_exists	Boolean	Status to validate if provided bank account is valid and active. if value `true` then account exists and if `false` then account does not exist.
1.3	upi_id	String	UPI id associated with account number
1.4	full_name	String	Full name of the account holder as per Bank records
1.5	remarks	String	Remark from Bank records
1.6	Note-When extended_data is set as true. npci_bo_response_code	String	NPCI back office response code which is generated by NPCI's back-end systems
1.7	Note-When extended_data is set as true. npci_online_response_code	String	Online response code is a code which is generated by NPCI's systems in real-time
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Sr. No	Scenario	Status Code	Response Code	Remark	Message	Error Message
1	Incorrect Account Number is provided - Correct format	200	2	NPCIERROR:INVALID BENEFICIARY MOB NO/MMID AND REVERSAL IS SUCCESSFUL	Invalid beneficiary details	verification_failed
2	Invalid IFSC code is provided	200	3	IMPSERROR: INVALID IFS CODE	Invalid_ifsc	verification_failed
3	Shared Account Number and IFSC code don't exist	200	4	NPCIERROR: BENEFICIARY IS NOT REGISTERED AND REVERSAL IS SUCCESSFUL	Invalid beneficiary details	verification_failed
4	Invalid account number provided	200	2	NPCIERROR: INVALID TO ACCOUNT NUMBER	INVALID ACCOUNT NUMBER	verification_failed
5	Account type is NRE account	200	5	NPCIERROR:BENEFICIARY ACCOUNT IS NRE ACCOUNT AND REVERSAL IS SUCCESSFUL	Beneficiary account is NRE account	verification_failed
6	User account is blocked/ frozen	200	3	NPCIERROR:BENEFICIARY ACCOUNT BLOCKED/FROZEN AND REVERSAL IS SUCCESSFU	Beneficiary account is blocked/frozen	verification_failed
7	When Beneficiary Account is Closed	200	3	Beneficiary account is closed	UNPROCESSABLE ENTITY
	All other mismatch error	200	9

","urlObject":{"path":["bank"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"460e5b45-41ad-4d00-8a68-4ea8e37d5009","name":"Success Scenario when Extended data is true","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9210xxxxxxxxxxxxx\",\r\n \"ifsc\": \"xxxxxxxxx\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 13:38:14 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268096807\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXX XXXXX\",\n \"remarks\": null,\n \"npci_bo_response_code\": \"00\",\n \"npci_online_response_code\": \"00\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1680097095181,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_vY5c01wr4e7nWb1uopc1\"\n}"},{"id":"e667c310-9b90-4598-8a75-b9434079a26e","name":"Success Scenario when Extended data is false","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 13:38:36 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268096824\",\n \"account_exists\": true,\n \"upi_id\": null,\n \"full_name\": \"XXXXXXXX XXXXX \",\n \"remarks\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1680097116336,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_CsT41nNKoR3kK47ob1QD\"\n}"},{"id":"c95f0a80-17fe-4d72-99bb-dee2ccc8868f","name":"Invalid IFS Code","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 13:45:40 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268097009\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"remarks\": \"IMPSERROR:Invalid IFS Code\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"message_code\": \"success\",\n \"message\": \"Invalid IFSC\",\n \"timestamp\": 1680097540556,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_q6L4C0SxrYn1js5Dc2L2\"\n}"},{"id":"539ec620-364a-4edd-95a5-f26bc0df1245","name":"Beneficiary Account is Blocked or Frozen","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 14:42:14 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268098096\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"remarks\": \"NPCIERROR:BENEFICIARY ACCOUNT BLOCKED/FROZEN AND REVERSAL IS SUCCESSFUL\",\n \"npci_bo_response_code\": \"M3\",\n \"npci_online_response_code\": \"M3\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"message_code\": \"success\",\n \"message\": \"Beneficiary account is blocked/frozen\",\n \"timestamp\": 1680100933492,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_TnCKw9zra18MKQRHj48J\"\n}"},{"id":"d3b327d9-009f-457d-9660-54bcca3b832c","name":"Invalid Account Number","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 14:42:56 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"bank_validation_gtczFlaZTukZntiljhTA\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"remarks\": \"Invalid Account Number\",\n \"npci_bo_response_code\": null,\n \"npci_online_response_code\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"message_code\": \"verification_failed\",\n \"message\": \"UNPROCESSABLE ENTITY\",\n \"timestamp\": 1680100970599,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_c1qpEdb76YndUtq1avWm\"\n}"},{"id":"7ce43c1a-3ad0-4ecd-b76d-61c471dd6a27","name":"Invalid Beneficiary details","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\": \"9XXXXXXXXXX\",\r\n \"ifsc\": \"XXXXXXXXXX\",\r\n \"extended_data\": false\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 29 Mar 2023 14:44:29 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268098169\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"remarks\": \"NPCIERROR:INVALID BENEFICIARY MOB NO/MMID AND REVERSAL IS SUCCESSFUL\",\n \"npci_bo_response_code\": \"M1\",\n \"npci_online_response_code\": \"M1\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 2,\n \"message_code\": \"success\",\n \"message\": \"Invalid beneficiary details\",\n \"timestamp\": 1680101068757,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_NxLPhuivxVu8BGvgQB59\"\n}"},{"id":"9355de7d-d344-45d0-888e-63f999347608","name":"Account is closed","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXX\",\r\n \"ifsc\":\"XXXXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 05 Apr 2023 10:32:54 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"bank_validation_WuSuqMrqOfDpbitEtqvg\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": null,\n \"remarks\": \"Beneficiary account is closed\",\n \"npci_bo_response_code\": \"M3\",\n \"npci_online_response_code\": \"M3\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 3,\n \"message_code\": \"verification_failed\",\n \"message\": \"UNPROCESSABLE ENTITY\",\n \"timestamp\": 1680690769577,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_129WjE8jWOhlkmmhKb3E\"\n}"},{"id":"0eca7ad5-3e4f-499f-a142-8fd088ebc6be","name":"NRE Account","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"id_number\":\"XXXXXXXXXXX\",\r\n \"ifsc\":\"XXXXXXXX\",\r\n \"extended_data\": true\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/idc/bank"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 05 Apr 2023 10:41:11 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"3022070415268346716\",\n \"account_exists\": false,\n \"upi_id\": null,\n \"full_name\": \"\",\n \"remarks\": \"NPCIERROR:BENEFICIARY ACCOUNT IS NRE ACCOUNT AND REVERSAL IS SUCCESSFUL\",\n \"npci_bo_response_code\": \"M4\",\n \"npci_online_response_code\": \"M4\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 5,\n \"message_code\": \"success\",\n \"message\": \"Beneficiary account is NRE account\",\n \"timestamp\": 1680691270212,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_bank_account_sc29jZEHWov6swnRaUVl\"\n}"}],"_postman_id":"1cba2a42-9451-43a1-879d-2997b87792c1"},{"name":"UPI","id":"99cc9d73-eeec-4a1a-855b-91ba28c7a976","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"text"}}},"url":"https://api.idcentral.io/idc/bank/{{UPIID}}","description":"

This API can be used to verify if a provided VPA is correct and belongs to an active current or savings bank account. This also returns the name of the account holder.

What is VPA / UPI ID?

Request: The UPI ID/ VPA is passed via endpoint URL.

Note: VPA / UPI ID validation structure is explained below.

Alphanumeric
Supports period (.), hyphen (-), at sign (@), and underscore (_).
- Underscore _(__) and dot (.) gets accepted before and after at sign (@), but hyphen (-) get accepted only before the at sign (@)
\n
100 character limit

Response:

S. No	Key	Data Type	Description
1	data	Object	Information fetched from the UPI Records
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	account_exists	Boolean	Status to validate if provided UPI ID exists and is valid. if value `true` then given UPI ID is valid and if value as `false` then UPI ID not valid.
1.3	upi_id	String	UPI ID passed in the request
1.4	full_name	String	Name of the UPI payment address holder. This is same as the name registered with associated bank account
1.5	remarks	String	Remarks from UPI records
1.6	ifsc_details	Object	IFSC details of given UPI ID associated bank account
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When valid UPI ID is entered	200	1	success	Successful Request
When invalid UPI ID is entered	200	9	failed	Transaction failed, please try again later	verification_failed
All other response code	200	9

","urlObject":{"path":["bank","{{UPIID}}"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"cc6070ce-8091-4766-9aa5-6cc2c3409ac6","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"text"}}},"url":"https://api.idcentral.io/idc/bank/{{UPIID}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 06:53:09 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"upi_validation_rQjiwknMCnXXXXXXXXXX\",\n \"account_exists\": true,\n \"upi_id\": \"XXXXXXXXXX@ybl\",\n \"full_name\": \"XXXXXXXX XXXXXXXX XXXXXX\",\n \"remarks\": \"\",\n \"ifsc_details\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670395988633,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_upi_id_uPggjcYeU9XXXXXXXXXX\"\n}"},{"id":"5d656608-6011-4c3c-b83c-c7b434068c12","name":"Invalid UPI ID","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"text"}}},"url":"https://api.idcentral.io/idc/bank/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 10:10:18 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"upi_validation_RduuumcpCWXXXXXXXXXX\",\n \"account_exists\": false,\n \"upi_id\": \"XXXXXXXXXX@ybl\",\n \"full_name\": null,\n \"remarks\": \"\",\n \"ifsc_details\": null\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"verification_failed\",\n \"message\": \"UNPROCESSABLE ENTITY\",\n \"timestamp\": 1670407817239,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_upi_id_TigeowGeXAXXXXXXXXXX\"\n}"}],"_postman_id":"99cc9d73-eeec-4a1a-855b-91ba28c7a976"}],"id":"f9a54080-b878-45d7-b5cb-4654e235b497","_postman_id":"f9a54080-b878-45d7-b5cb-4654e235b497","description":""},{"name":"Face Biometrics","item":[{"name":"Face Match","id":"d2126418-2239-4571-9086-0738e3f795ff","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":"/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/WIN_20220124_14_15_19_Pro.jpg"},{"key":"selfie_image","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/WIN_20220217_12_56_11_Pro.v4.png"}]},"url":"https://api.idcentral.io/idc/onboarding/face/match","description":"

The Face Match API enables you to match two face images without the need for prior enrolment. You can upload two face image files in the supported format, and the API will return a match score and the face IDs of the two images. The match score represents the likelihood that the images are of the same person, with a higher score indicating a higher degree of similarity between the faces.

Supported file format and other details:

In this Face Match API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
Max faces in a frame: 1.
File size should exceed 5 MB.
Image shouldn't be compressed.

Request: The request has to be passed in form-data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_image	file	Required	Document image file in jpeg, jpg, jpe, jif, jfif, jfi, or png format
2	selfie_image	file	Required	Selfie/photo image in jpeg, jpg, jpe, jif, jfif, jfi, or png format

Response:

S. No	Key	Data Type	Description
1	data	Object	Information fetched when Face match is performed
1.1	verified	Boolean	The success or failure status of a face match is determined by comparing the similarity score to a pre-set threshold value. For example, if the threshold value is set at 85 and the similarity score obtained from the face match is greater than or equal to 85, then the match is considered successful and the value returned will be \"true\". If the similarity score is less than 85, then the match is considered unsuccessful and the value returned will be \"false\".
1.2	similarity	Float	Refer: Similarity definition
1.3	threshold	Float	Refer: Threshold definition
1.4	selfie_type	String	The type of the selfie
1.5	id_document_face_image	String	Document image in base64 format
1.6	selfie_face_image	String	Selfie image in base64 format
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	timestamp	Integer	API response received time in milliseconds
9	responseTimestamp	Integer	API response received time in milliseconds
10	error	String	This text content explains the reason if API request has failed
11	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
12	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Verified Status	Status	Message	Error
When uploaded Document and selfie matches	200	1	true	Success	Successful Request
When given uploaded document and selfie do not match	200	1	false	success	Successful Request
When uploaded image size is more than 5 MB and system does not accept	400	-1		failed	File exceeds maximum file size 500000 bytes and WIN_20220217_12_56_11_Pro.v4.png size is 7744155	Invalid Request
When uploaded document file type system does not accept	400	-1		failed	Please provide the supported image files (jpeg, jpg, jpe, jif, jfif, jfi, and png). api-doc.htm is not supported	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","face","match"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"619a1db5-eecf-4234-a02b-8e467188c76d","name":"Face Matches","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Photo.jpg"]},{"key":"selfie_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Photo.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/face/match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 13 Dec 2022 13:02:56 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"verified\": true,\n \"similarity\": 100,\n \"threshold\": 85,\n \"selfie_type\": \"\",\n \"id_document_face_image\": \"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\",\n \"selfie_face_image\": null\n },\n \"status\": \"success\",\n \"status_code\": \"200\",\n \"statusCode\": null,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670936576516,\n \"responseTimestamp\": 1670936576516,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"face_match_ZePpsMeHosXXXXXXXXXXX\"\n}"},{"id":"caac5eda-23f8-4fa4-a569-fd5b37060953","name":"Face does not Match","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Photo.jpg"]},{"key":"selfie_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/single photo.jpeg"]}]},"url":"https://api.idcentral.io/idc/onboarding/face/match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 13 Dec 2022 13:04:24 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"verified\": false,\n \"similarity\": 0.0887526199221611,\n \"threshold\": 85,\n \"selfie_type\": \"\",\n \"id_document_face_image\": \"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\",\n \"selfie_face_image\": null\n },\n \"status\": \"success\",\n \"status_code\": \"200\",\n \"statusCode\": null,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670936664521,\n \"responseTimestamp\": 1670936664521,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"face_match_lmBePv3FV4XXXXXXXXXX\"\n}"},{"id":"d2965bcc-fe13-4381-a38e-57c9e66f6223","name":"File Size Exceeded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":[]},{"key":"selfie_image","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/idc/onboarding/face/match"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": 400,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"File exceeds maximumm file size 500000 bytes and WIN_20220217_12_56_11_Pro.v4.png size is 7744155\",\r\n \"timestamp\": 1647501543364,\r\n \"error\": \"Invalid Request\",\r\n \"success\": false,\r\n \"count\": 0\r\n}"},{"id":"e96e9f23-9ce8-404b-9f31-5dbea5a314e4","name":"File Format Issue","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{APIKEY}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":[]},{"key":"selfie_image","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/idc/onboarding/face/match"},"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": 400,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). api-doc.htm is not supported\",\r\n \"timestamp\": 1647501595393,\r\n \"error\": \"Invalid Request\",\r\n \"success\": false,\r\n \"count\": 0\r\n}"},{"id":"3efe1bd9-4d36-408c-9076-fbf314ab5e9f","name":"Selfie Image is missing","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/marguerite-729510__340.jpg"]},{"key":"selfie_image","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/onboarding/face/match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 06:45:25 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": \"400\",\n \"statusCode\": null,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the selfie Image\",\n \"timestamp\": 1668926725914,\n \"responseTimestamp\": 1668926725914,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"face_match_Me0uhZ9r6BXXXXXXXXXX\"\n}"},{"id":"bea15e73-b31e-4084-be29-9251e2a798db","name":"Document Image is missing","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":[]},{"key":"selfie_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/marguerite-729510__340.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/face/match"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 06:48:08 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": \"400\",\n \"statusCode\": null,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the Document Image\",\n \"timestamp\": 1668926888902,\n \"responseTimestamp\": 1668926888902,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"face_match_z3h5KQB8uXXXXXXXXXX\"\n}"}],"_postman_id":"d2126418-2239-4571-9086-0738e3f795ff"}],"id":"238584e4-948c-4ff9-a57b-59eac7aa2967","_postman_id":"238584e4-948c-4ff9-a57b-59eac7aa2967","description":""},{"name":"Liveness","item":[{"name":"Liveness Check","id":"5363f5a7-b50b-4edb-88f9-42ac3ca7f3ac","protocolProfileBehavior":{"disabledSystemHeaders":{},"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":"/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/face is large.jpg"},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/onboarding/check_liveness","description":"

Supported file format and other details:

The input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
\n
Minimal Image height: 480 px.
\n
Minimal face size: 350 px (desktop), 225 px (mobile).
\n
Minimum padding for face: 10 px.
\n
Maximum faces in a frame: 1.
\n
Image shouldn't be compressed.
\n
Ideal face posture: Frontal face.
\n
Face orientation position: Vertical.
\n

To evaluate the performance, there are two metrics BPCER and APCER.

BPCER: BPCER stands for \"Bonafide Presentation Classification Error Rate\". It represents the rate at which the liveness check incorrectly categorizes genuine attempts as spoof or fraudulent attempts. A lower BPCER indicates better accuracy in distinguishing between genuine and spoof presentations.
\n
APCER: APCER stands for \"Attack Presentation Classification Error Rate\". It represents the rate at which the liveness check correctly identifies spoof or fraudulent attempts as genuine attempts. A lower APCER indicates a more robust system capable of detecting various spoofing attacks effectively.
\n

Note: This API should be used only in situations where the user has control over the camera and is able to capture a photo of the customer directly. It should not be used when allowing the customer to upload an image file from their own device.

The recommended maximum distance between the face and the device is 1.5 feet.
\n
The user's ears should be visible when liveness is being checked.
\n
Enhanced illumination on facial areas and immediate surroundings may substantially elevate the BPCER.
\n
Poorly-lit settings and tinted light sources can notably boost BPCER.
\n
The presence of motion blur effects can notably increase BPCER, affecting the accuracy of distinguishing between a live person and a spoof.
\n
Implementing texture filtering can markedly elevate APCER, thereby raising the likelihood of permitting unauthorized individuals access.
\n

Definition:

threshold: In facial recognition systems, the threshold is a setting used for authentication, verification, or identification. The system decides whether a facial template match is acceptable or not based on whether the match score is higher or lower than the set threshold. This threshold is adjustable according to the system's requirements.
\n
device: The device mentioned refers to the supporting device on which the user intends to utilize this API. Currently this API supports mobile or desktop OS setting (Possible values are IOS, Android, Desktop or Unknown).
\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

device	Definition
IOS	This refers to device which has IOS operating system, including iPhone and iPad.
Android	his refers to device which has Android operating system, including Android phones and tablets.
Desktop	This refers to device which has Desktop devices, including Desktop computer and laptop
Unknown	This refers to the devices which are unknown to the user.

calibration: The calibration refers to the process of configuring and fine-tuning the face recognition system to optimize its performance and accuracy. It involves adjusting various parameters to enhance the system's ability to accurately identify and match faces in different scenarios and conditions. Possible values are Soft, Regular, and Hardened.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Calibration	Definition
Soft	If the Calibration is set to \"Soft,\" it aims to be more forgiving and accommodating to legitimate users.
Regular	If the Calibration is set to \"Regular\", it aims to prioritize accuracy by being cautious and minimizing the chances of allowing impostors to be recognized as authorized individuals. It maintains balance between the \"Soft\" and \"Hardened\" calibration.
Hardened	Hardened If the Calibration is set to \"Hardened,\" it aims to prioritize maximizing security and being very cautious and strict.

image_quality_score: The image_quality_score is used to evaluate multiple parameters related to image quality, including blur, reflection, sharpness, exposure, and orientation (pitch, yaw, roll), as well as the positions of the eyes and mouth. It returns a quality score that indicates how well the image meets the system's requirements.
\n
score: The score in liveness detection serves as a confidence measure to determine whether the person in the image is a live individual or a fake representation, such as a pre-captured image, a sequence of images displayed on-screen, or a physical mask used by malicious actors with fraudulent intentions.
\n
result: The final decision about whether the face is genuine or fake is determined by the liveness score and the threshold. If the score is higher than the threshold, it is considered genuine or accepted, while if it is lower than the threshold, it is considered fake or rejected.
\n

Request: The request has to be passed in form-data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	image	file	Required	Selfie image
2	threshold	integer	Required	Refer: Threshold definition
3	device	String	Optional	Refer: Device definition
4	calibration	String	Optional	Refer: Calibration definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information fetched from Liveness check
1.1	threshold	Float	The default threshold value applied for the image.
1.2	image_quality_score	Float	The quality score of the input image
1.3	score	Float	Liveness score of the image
1.4	result	String	The liveness status of the image as pass or fail
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success', it confirms that the request is processed successfully, and a response is received. Conversely, if the value is 'failed', it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer Errors and Status Codes
4	response_code	Integer	IDC’s internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
6	message	String	This field confirms if the API request is successful or not and shows respective message
7	timestamp	Integer	API response received time in milliseconds
8	error	String	This text content explains the reason if API request has failed
9	success	Boolean	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
10	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

Scenarios Covered

Scenario	Status Code	Response Code	Status	Message	Error
Successful Request	200	1	success	Successful Request
Face match failed. Faces don't match as per the given threshold.	200	2	success	Face match failed. Faces don't match as per the given threshold.	Verification failed
Multiple Faces Found in [Document] / [Photo]	200	3	success	Multiple Faces Found in Document	Verification failed
No Faces Found in [Document] / [Photo]	200	4	success	No Faces Found in Document	Verification failed
Invalid Image Format.	200	5	success	Invalid Image Format.	Verification failed
Other mismatched errors	200	9	success
Conflicting Input Types	400	-1	failed		Validation error
Invalid Image Base64 format	400	-1	failed	Invalid Image Base64 format	Validation error
Invalid Image URL format	400	-1	failed	Invalid Image URL format	Validation error
Image URL Unreachable	400	-1	failed	Image URL Unreachable	Validation error
Unsupported image file	400	-1	failed	Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png).	Validation error
File exceeds maximumm file size 5000000 bytes and [Document]/[Photo] size is [File Size]	400	-1	failed	File exceeds maximumm file size 5000000 bytes and [Document]/[Photo] size is [File Size]	Validation error

","urlObject":{"path":["onboarding","check_liveness"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7f97b668-3ffe-461a-8586-bfba44c05229","name":"Liveness Success - Face of a real person","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/VISA/Photo.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/onboarding/check_liveness"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 09:50:00 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"threshold\": 80,\n \"image_quality_score\": 99,\n \"score\": 99.99,\n \"result\": \"pass\"\n },\n \"status\": \"success\",\n \"status_code\": 1,\n \"response_code\": 1,\n \"message_code\": null,\n \"message\": \"Successful Request\",\n \"timestamp\": 1670406600176,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"passive_liveness_check_A2LTVnZHTbXXXXXXXXXX\"\n}"},{"id":"a8442f82-cde1-428c-8820-0a60e0f90f8a","name":"Liveness Success - When face is not of a real person","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Prashant Pan Card P1.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/onboarding/check_liveness"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:41:46 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 2,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Failed to predict landmarks\",\n \"timestamp\": 1668361306392,\n \"error\": \"FAILED_TO_PREDICT_LANDMARKS\",\n \"success\": false,\n \"txn_id\": \"passive_liveness_check_MjR1tn5FYiXXXXXXXXXX\"\n}"},{"id":"0f2fbbc9-fa0d-42f4-8954-673eaace2cdd","name":"Face Too Small","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/liveness failure.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/idc/onboarding/check_liveness"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Relative face size is too small\",\n \"timestamp\": 1647953252705,\n \"error\": \"FACE_TOO_SMALL\",\n \"success\": false,\n \"txn_id\": null\n}"},{"id":"50a34268-d3f4-4e5b-b74b-aec456a79da6","name":"Face Close To Border","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/liveness check success.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/idc/onboarding/check_liveness"},"_postman_previewlanguage":"Text","header":[],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\r\n \"data\": null,\r\n \"status\": \"failed\",\r\n \"status_code\": -1,\r\n \"response_code\": -1,\r\n \"message_code\": null,\r\n \"message\": \"Face is too close to one or more borders\",\r\n \"timestamp\": 1647953180060,\r\n \"error\": \"FACE_CLOSE_TO_BORDER\",\r\n \"success\": false,\r\n \"txn_id\": null\r\n}"},{"id":"a160be43-202d-49c9-bb32-3ed79d6ed0aa","name":"Face Not Found","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/liveness check success.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/idc/onboarding/check_liveness"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Unable to find any face from the requested image file, please provide the valid image file\",\n \"timestamp\": 1647952714312,\n \"error\": \"FACE_NOT_FOUND\",\n \"success\": false,\n \"txn_id\": null\n}"},{"id":"eeebb53b-b646-4149-a0e2-fbd9b47d05e6","name":"File Size Exceeds","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"},{"warning":"This is a duplicate header and will be overridden by the Content-Type header generated by Postman.","key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/DSC00203.JPG"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/onboarding/check_liveness"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 13 Nov 2022 17:34:11 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 2,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"File exceeds maximumm file size 5000000 bytes and DSC00203.JPG size is 21233664\",\n \"timestamp\": 1668360851980,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"passive_liveness_check_aVU3sDhbasz08L5WmDJ6\"\n}"},{"id":"bbf0a812-b4b6-4d97-9de6-7a33d08ef8de","name":"Invalid File Format","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json","type":"text"},{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"Content-Type","value":"multipart/form-data","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","src":["/C:/Users/saikrishna.grande/OneDrive - Subex Limited/Pictures/Camera Roll/liveness check success.jpg"]},{"key":"threshold","value":"80","type":"text"},{"key":"device","value":"Unknown","type":"text"},{"key":"calibration","value":"Regular","type":"text"}]},"url":"https://api.idcentral.io/idc/idc/onboarding/check_liveness"},"_postman_previewlanguage":"json","header":[{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the supported image files(jpeg, jpg, jpe, jif, jfif, jfi, and png). 20220324120615.pdf is not supported\",\n \"timestamp\": 1647952825470,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": null\n}"}],"_postman_id":"5363f5a7-b50b-4edb-88f9-42ac3ca7f3ac"}],"id":"79d02a1f-c859-4773-b1a1-861475146497","_postman_id":"79d02a1f-c859-4773-b1a1-861475146497","description":""},{"name":"Aadhaar UID masking","item":[{"name":"Aadhaar UID Masking","id":"09d44a03-70ba-4f33-9cd0-9964becf0212","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","value":null}]},"url":"https://api.idcentral.io/idc/onboarding/aadhaar_masking","description":"

Request:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_image	File	Required	Valid Aadhaar card to be masked

Response:
Upon successful verification, API returns the masked image in Base64 format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	status_code	String	The http status code of the API. Refer: Errors and Status Codes
2	timestamp	Integer	API response receive time in milliseconds
3	Image	Image	Note: Masked file is generated upon completing the masking.
4	message	String	A text content explains if API request was successful or not.
5	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When masked file is generated	200	1	success	Note: Masked can be downloaded upon completing masking
When un supported file is uploaded	-1			Please provide the supported image files( jpeg, jpg, jpe, jif, jfif, jfi and png). Prashant_Aadhar Card.pdf is not supported	Input Error
When file size exceeds max size limit	2			File size cannot exceed 2 MB and DSC00203.JPG size is 21233664 bytes	Size Exceeded
When non Aadhaar document is uploaded	0	0	failed		Low Quality Image
All other mismatch errors	200	9

","urlObject":{"path":["onboarding","aadhaar_masking"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"37a0a811-437d-41dd-b808-620fd9a8343e","name":"Invalid File format","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":[]}]},"url":"https://api.idcentral.io/idc/onboarding/aadhaar_masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:52:48 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status_code\": -1,\n \"timestamp\": 1668941568634,\n \"data\": null,\n \"error\": \"Input Error\",\n \"message\": \"Please provide the supported image files( jpeg, jpg, jpe, jif, jfif, jfi and png). Prashant_Aadhar Card.pdf is not supported\",\n \"txn_id\": null\n}"},{"id":"cec371c3-6b03-4239-a495-2ce522ea0dbd","name":"File Size Exceeds","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/DSC00203.JPG"]}]},"url":"https://api.idcentral.io/idc/onboarding/aadhaar_masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 10:57:55 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status_code\": 2,\n \"timestamp\": 1668941875664,\n \"data\": null,\n \"error\": \"Size Exceeded\",\n \"message\": \"File size cannot exceed 2 MB and DSC00203.JPG size is 21233664 bytes\",\n \"txn_id\": null\n}"},{"id":"6206cff4-b15d-4882-a9d5-77ae41fce905","name":"Non Aadhar Document uploaded","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/Photo.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/aadhaar_masking"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 11:00:12 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"failed\",\n \"responseTimestamp\": 1668942012190,\n \"data\": null,\n \"error\": \"Low Quality Image\",\n \"statusCode\": null,\n \"response_code\": 0,\n \"status_code\": 0,\n \"message_code\": null,\n \"message\": null,\n \"success\": false,\n \"txn_id\": null\n}"}],"_postman_id":"09d44a03-70ba-4f33-9cd0-9964becf0212"}],"id":"edfcbec9-8a7a-4e86-8ea3-c0fa59f5c104","_postman_id":"edfcbec9-8a7a-4e86-8ea3-c0fa59f5c104","description":""},{"name":"Document Extraction","item":[{"name":"OCR","id":"15934140-90d7-490d-86f3-695b8119a66d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":"/C:/Users/upasana.gupta/OneDrive - Subex Limited/Downloads/MicrosoftTeams-image (40).png"},{"key":"id_document_back_image","type":"file","value":null,"disabled":true}]},"url":"https://api.idcentral.io/idc/onboarding/ocr/{{country_code}}/id/{{document_type}}","description":"

IDcentral's OCR API enables the extraction of information from various ID card formats such as PAN Card, Aadhaar Card, and Passport through scanning or uploading a picture. This process is completed within seconds and accurately provides data that can be readily filled in the appropriate fields, resulting in a faster and error-free form-filling experience and smoother customer onboarding.

What is OCR?

Definition

Key Name - Confidence: Confidence score indicates the overall accuracy of the character recognition. It ranges between 0 and 100. A score of 100 is likely an exact match, while a score of 0 means, that no matching answer was found. The higher the score- the greater the confidence.
Key Name - Value: The value parameter displays the extracted information in a standardized format. For instance, in the case of OCR, if the extracted date of birth (DOB) is in the format MM/DD/YYYY and the standard format used by the IDC is DD/MM/YYYY, the value parameter will present the DOB as 28/01/1992.
Key Name - Content: The content parameter displays the extracted information from the document, such as the date of birth (DOB) obtained through OCR. If the DOB is extracted in the format MM/DD/YYYY, it will be displayed as it is in the content value.
MRZ: Machine readable zone (MRZ), is basically a document holder’s personal information in an encoded format to maintain confidentiality. It is 2 or 3 lines of coded information, a series of characters, numbers and separators whose initial objective was to speed up the automatic reading of a person’s personal data.

Supported Documents and Constraints:

As of now, we support the following types of documents for extracting data from image files to JSON format.

India:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	Aadhaar
VID	Voter Id
PAN	PAN
DL	Driving License
PSPT	Passport

Nepal:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
CTZ	Citizenship Certificate
VID	Voter Id
PAN	PAN
DL	Driving License
PSPT	Passport

Maldives:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Document Type	Description
NID	National ID
PSPT	Passport
WP	Work Permit

Supported file formats: In this OCR API the input file should be allowed with jpeg, jpg, jpe, jif, jfif, jfi, and png file formats.
File size should not exceed 5 MB.
Country Code to be in ISO-3166-1 format (eg. for India it is 'IN').

baseUrl: The Base URL of the API.

country_code: The default country code according to ISO-3166-1 alpha-2. For instance, IN for India.

document_type: The document code of the selected document type in supported documents table.

Request: The request has to be passed in form data format.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	id_document_image	file	Required	Document image file in jpeg, jpg, jpe, jif, jfif, jfi, or png format
2	id_document_back_image	file	Required	The back side of the document image in jpeg, jpg, jpe, jif, jfif, jfi, or png format

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is performed
1.1	ocrs	Object	Document Image file: Front Side
1.2	ocrsBackImage	Object	Document Image file: Back Side
2	status	String	The text content indicates whether the API request has been successfully completed or not. If the value is “success”, it confirms that the request is processed successfully, and a response is received. Conversely, if the value is “failed”, it confirms that the request has failed due to an error
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	statusCode	Integer	The http status code of the API. Refer: Errors and Status Codes
5	response_code	Integer	IDC's internally mapped sub-status / response codes. Refer: Errors and Status Codes
6	message_code	String	The text content confirms if API response status message received successfully or not. If the value is “success” then the request is successfully processed and has received message response and if the value is “failed” then it has happened due to error
7	message	String	This field confirms if the API request is successful or not and shows respective message
8	timestamp	Integer	API response received time in milliseconds
9	responseTimestamp	Integer	API response received time in milliseconds
10	error	String	This text content explains the reason if API request has failed
11	success	String	This key field confirms if API request is successful or not. If the value is “true” the API request is successful and if the value is “false” then the API request fails
12	txn_id	String	This is a Unique reference ID which is sent back to IDC’s client with each response. This reference ID helps in verifying the request. The client can use this ID to check the status of API

OCR Model for Aadhaar Card:

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is perfomed
1.1	ocrs	Object	Front Side Image details
1.1.1	name	String	Name of the document holder extracted from DOC
1.1.2	id_number	String	The unique Id number of the document extracted from the DOC.
1.1.3	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints:
1.1.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD:MM:YYYY
1.1.5	gender	String	Gender information extracted from the DOC.
1.1.6	address	String	address extracted from the DOC.
1.1.7	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')
1.2	ocrsBackImage	Object	Back side image details
1.2.1	name	String	name of the document holder extracted from DOC
1.2.2	id_number	String	The unique Id number of the document extracted from the DOC.
1.2.3	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints
1.2.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD: MM: YYYY
1.2.5	gender	String	Gender information extracted from the DOC.
1.2.6	address	String	Address extracted from the DOC.
1.2.7	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')

OCR Model for Pan Card:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is perfomed
1.1	ocrs	Object	Front Side Image details
1.1.1	id_type	String	The type of the document ID. Refer: Supported Documents and Constraints
1.1.2	name	String	name of the document holder extracted from DOC
1.1.3	father_name	String	father name of the document holder extracted from DOC.
1.1.4	date_of_birth	String	Date of the Birth of the document holder extracted from DOC. the Date of birth value format will be DD: XX MM: XX YYYY: XXXX
1.1.5	id_number	String	The unique Id number of the document extracted from the DOC.
1.1.6	extracted_country	String	Country Details in ISO-3166-1 format (eg. for India it is 'IN')

OCR Model for Voter ID:

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is performed
1.1	document_type	String	Voter ID back Image details
1.2	address	Object	Address Details
1.2.1	value	String	Complete Address extracted from Voter ID
1.2.2	confidence	Integer	OCR confidence score in the range 0-100.
1.2.3	first_line	String	Address first line
1.2.4	second_line	String	Address second line
1.2.5	locality	String	Address locality
1.2.6	landmark	String	Address landmark
1.2.7	house_number	String	Address house number
1.2.8	district	String	Address district
1.2.9	city	String	Address City
1.2.10	state	String	Address state
1.2.11	country	String	Address country
1.2.12	zip	String	Address zip code
1.3	zip	Object	Zip details with value and confidence score on extracted data
1.4	epic_number	Object	Voter ID details with value and confidence score on extracted data
1.5	dob	Object	DOB details with value and confidence score on extracted data
1.6	doi	Object	DOI details with value and confidence score on extracted data
1.7	gender	Object	Gender details with value and confidence score on extracted data
1.8	age	Object	Age details with value and confidence score on extracted data
1.9	document_type	Object	Voter ID front Image details
1.10	full_name	Object	Details with value and confidence score on extracted data
1.11	age	Object	Age details with value and confidence score on extracted data
1.12	care_of	Object	Father's Name / Spouse Name details with value and confidence score on extracted data
1.13	dob	Object	DOB details with value and confidence score on extracted data
1.14	doc	Object	DOC details with value and confidence score on extracted data
1.15	gender	Object	Gender details with value and confidence score on extracted data
1.16	epic_number	Object	Voter ID details with value and confidence score on extracted data

OCR Model for Passport:

(Note: IDcentral Passport OCR API supports passports of 150+ countries)

S. No	Key	Data Type	Description
1	data	Object	Information extracted when OCR is performed
1.1	front	Object	Document Front Side details
1.1.1	ocr	Object	OCR details
1.1.1.1	document_type	Object	Document Type details with value and content details on extracted data
1.1.1.2	place_of_issue	Object	Place of issue details with value and content details on extracted data
1.1.1.3	nationality	Object	Nationality details with value and content details on extracted data
1.1.1.4	last_name	Object	Last Name details with value and content details on extracted data
1.1.1.5	date_of_birth	Object	DOB details with value and content details on extracted data
1.1.1.6	document_number	Object	Passport Number details with value and content details on extracted data
1.1.1.7	date_of_issue	Object	DOI details with value and content details on extracted data
1.1.1.8	sex	Object	Gender details with value and content details on extracted data
1.1.1.9	country_region	Object	Country details with value and content details on extracted data
1.1.1.10	date_of_expiration	Object	DOE details with value and content details on extracted data
1.1.1.11	place_of_birth	Object	Place of Birth details with value and content details on extracted data
1.1.1.12	first_name	Object	First Name details with value and content details on extracted data
1.1.2	mrz	Object	MRZ details from Passport
1.1.3	sex	Object	Gender details with value and content details on extracted data
1.1.4	date_of_expiration	Object	DOE details with value and content details on extracted data
1.1.5	country_region	Object	Country details with value and content details on extracted data
1.1.6	nationality	Object	Nationality details with value and content details on extracted data
1.1.7	last_name	Object	Last Name details with value and content details on extracted data
1.1.8	date_of_birth	Object	DOB details with value and content details on extracted data
1.1.9	first_name	Object	First Name details with value and content details on extracted data
1.1.10	document_number	Object	Passport Number details with value and content details on extracted data

Scenarios Covered

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When system has successfully captured the details	200	1	success	Successful Request
When invalid doc type is selected	400	-1	failed	The Document type provided in request is not valid/not supported by IDC system. Please provide the valid document type	Invalid Request
When invalid country code is provided	400	-1	failed	The Country code provided in request is not valid/not supported by IDC system. Please provide the valid country code	Invalid Request
when invalid or incorrect image is provided	400	-1	failed	Invalid or incorrect image	Mismatching or Invalid Document
When file size is more than 5 MB	400	-1	failed	File exceeds maximum file size 5000000 bytes and DSC00203.JPG size is 21233664	Invalid Request
Any other mismatch error	200	9

","urlObject":{"path":["onboarding","ocr","{{country_code}}","id","{{document_type}}"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"1fde2ff6-55fb-473a-8815-dcda418699d6","name":"Success - Aadhaar Front and Back","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Aadhar Card_page-0001.jpg"]},{"key":"id_document_back_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Aadhar Back.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/ocr/{{country_code}}/id/NID"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 08:00:37 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"ocrs\": {\n \"name\": \"XXXXXXXX XXXXXXXX XXXXXXXX\",\n \"id_number\": \"XXXX XXXX 4341\",\n \"id_type\": \"IN-NID\",\n \"date_of_birth\": \"DD: 15 MM: 02 YYYY: 1992\",\n \"gender\": \"MALE\",\n \"address\": \"XXXXXXXX XXXXXXXX XXXXXXXX Asade , Bhads Asade Bhadas Mulshi Pune Maharashtra 412108\",\n \"extracted_country\": \"IN\"\n },\n \"ocrsBackImage\": {\n \"name\": \"\",\n \"id_number\": \"XXXX XXXX 4341\",\n \"id_type\": \"IN-NID\",\n \"date_of_birth\": \"\",\n \"gender\": \"\",\n \"address\": \"XX XXXXXX , XXXX , XXXXXX , XXXXX , Maharashtra XXXXXX\",\n \"extracted_country\": \"IN\"\n }\n },\n \"status\": \"success\",\n \"status_code\": \"200\",\n \"statusCode\": \"200\",\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670400030272,\n \"responseTimestamp\": 1670400030272,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"in_nid_ocr_8kTwo4B6KfXXXXXXXXXX\"\n}"},{"id":"bbe98bf5-b738-4154-8a98-e73ba157db13","name":"Success - PAN card OCR","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/PAN sample/Suhel_Pan Card.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/ocr/IN/id/PAN"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Wed, 07 Dec 2022 08:02:04 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"ocrs\": {\n \"id_type\": \"IN-PAN\",\n \"name\": \"XXXX XXXXX KHAN\",\n \"father_name\": \"XXXXXXXX MURTAZA\",\n \"date_of_birth\": \"DD: 07 MM: 09 YYYY: 1989\",\n \"id_number\": \"XXXXX6922K\",\n \"extracted_country\": \"IN\"\n },\n \"ocrsBackImage\": null\n },\n \"status\": \"success\",\n \"status_code\": \"200\",\n \"statusCode\": \"200\",\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1670400120984,\n \"responseTimestamp\": 1670400120984,\n \"error\": null,\n \"success\": true,\n \"txn_id\": \"in_pan_ocr_cGoP4BzEQeXXXXXXXXXXXX\"\n}"},{"id":"99f6c53e-25ba-41e5-bb4c-a7e405fce548","name":"Success - Passport OCR","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"},{"key":"isConsentGranted","value":"true","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Passport_page-0001.jpg"]}]},"url":"https://api.idcentral.io/idc/onboarding/ocr/IN/id/PSPT"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Security-Policy","value":"default-src 'self'"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 13 Dec 2022 07:12:20 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"txn_id\": \"in_pspt_ocr_2GAm6u7WdBXXXXXXXXXX\",\n \"timestamp\": 1670915537174,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"error\": null,\n \"message\": \"Successful request\",\n \"data\": {\n \"front\": {\n \"ocr\": {\n \"document_type\": {\n \"value\": \"P\",\n \"content\": \"P\"\n },\n \"place_of_issue\": {\n \"value\": \"BENGALURU\",\n \"content\": \"BENGALURU\"\n },\n \"nationality\": {\n \"value\": \"IND\",\n \"content\": \"भारतीय/INDIAN\"\n },\n \"last_name\": {\n \"value\": \"XXXXXX\",\n \"content\": \"XXXXXX\"\n },\n \"date_of_birth\": {\n \"value\": \"XXXX-02-XX\",\n \"content\": \"XX/02/XXXX\"\n },\n \"document_number\": {\n \"value\": \"XXXXXXXXX\",\n \"content\": \"XXXXXXXX\"\n },\n \"date_of_issue\": {\n \"value\": \"2019-03-10\",\n \"content\": \"03/10/2019\"\n },\n \"sex\": {\n \"value\": \"M\",\n \"content\": \"M\"\n },\n \"country_region\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"date_of_expiration\": {\n \"value\": \"2029-10-02\",\n \"content\": \"02/10/2029\"\n },\n \"place_of_birth\": {\n \"value\": \"XXXXXX , XXXXX\",\n \"content\": \"XXXXX , XXXXX\"\n },\n \"first_name\": {\n \"value\": \"XXXXXX XXXXXX\",\n \"content\": \"XXXXXX XXXXXX\"\n }\n },\n \"mrz\": {\n \"sex\": {\n \"value\": \"M\",\n \"content\": \"M\"\n },\n \"date_of_expiration\": {\n \"value\": \"2029-10-02\",\n \"content\": \"291002\"\n },\n \"country_region\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"nationality\": {\n \"value\": \"IND\",\n \"content\": \"IND\"\n },\n \"last_name\": {\n \"value\": \"XXXXX\",\n \"content\": \"XXXXXX\"\n },\n \"date_of_birth\": {\n \"value\": \"XXXX-02-XX\",\n \"content\": \"XXXXXX\"\n },\n \"first_name\": {\n \"value\": \"XXXXXX XXXXXX\",\n \"content\": \"XXXXXXThe API will take the RC Number of the vehicle and share all the vehicle related details like chassis number, Insurance details, Owner details .

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Date Type	Required	Description
1	rc_number	String	Required	RC Number / Vehicle number

Response:

S. No	Key	Data Type	Description
1	data	Object	Data as per the Driving License records
1.1	blacklist_status	String	It confirms if given RC is flagged blacklisted or not.
1.2	body_type	String	Body type of the vehicle
1.3	challan_details	String	If confirms if any challans been there on given RC number
1.4	color	String	Color of the vehicle
1.5	cubic_capacity	String	Cubic capacity of the engine for given RC number
1.6	father_name	String	Vehicle owner's father's name
1.7	financed	String	It confirms of this RC number is being financed by any financial institute
1.8	financer	String	If the vehicle being financed then the name of the financer
1.9	fit_up_to	String	Date till which vehicle will be considered to be fit to drive
1.10	fuel_type	String	fuel type of vehicle
1.11	insurance_company	String	Name of insurance company from which ower has bought the vehicle insurance
1.12	insurance_policy_number	String	Insurance policy number
1.13	insurance_upto	String	Validity of the current insurance
1.14	latest_by	String	Date on which the RC details were fethed. Current date
1.15	less_info	Boolean	LESS info about RC number. Possible value `true` and `false`
1.16	maker_description	String	Name of the automaker
1.17	maker_model	String	Vehicle Model
1.18	manufacturing_date	String	Manufacturing date
1.19	masked_name	Boolean	if maksed name of the owner vailable or not. Poissible values `true` and `false`
1.20	mobile_number	String	Mobile number of the vehicle owner
1.21	national_permit_issued_by	String	If vehicle is a transport vehicle then permit details will be mentioned
1.22	national_permit_number	String	if vehicle type is transport type, Permit number will be mentioned
1.23	national_permit_upto	String	National Permit validity
1.24	no_cylinders	String	Number of cylinders available in the vehicle
1.25	noc_details	String	NOC details available for vehicle if any
1.26	non_use_from	String	NOC validation start date
1.27	non_use_status	String	Status of the NOC
1.28	non_use_to	String	Non Use to Details
1.29	norms_type	String	Norms type details
1.30	owner_name	String	Name of the vehicle owner
1.31	owner_number	String	Mobile number of the owner
1.32	permanent_address	String	Owner permanent address
1.33	permit_issue_date	String	Permit issue date
1.34	permit_number	String	Permit Number
1.35	permit_type	String	Permit type
1.36	permit_valid_from	String	Permit valid from date
1.37	permit_valid_upto	String	Permit valid end date
1.38	present_address	String	Current address of the owner
1.39	pucc_number	String	PUCC number
1.40	pucc_upto	String	PUCC valid upto
1.41	rc_number	String	RC Number / vehicle number
1.42	rc_status	String	RC Status. Possible values `ACTIVE` and `INACTIVE`
1.43	registered_at	String	City of vehicle registration
1.45	registration_date	String	RC registration date
1.46	seat_capacity	String	Seat capacity of the vehicle
1.47	sleeper_capacity	String	Vehicle sleeper capacity if any
1.48	standing_capacity	String	Vehicle standing capacity
1.49	tax_paid_upto	String	Tax paid details
1.50	tax_upto	String	Tax details
1.51	unladen_weight	String	Unleden weight of the vehicle
1.52	variant	String	Vehicle variant type
1.53	vehicle_category	String	Vehicle categoty details
1.54	vehicle_category_description	String	Vehicle categoty description
1.55	vehicle_chasi_number	String	Vehicle chassis number
1.56	vehicle_engine_number	String	Vehicle Engine number
1.57	vehicle_gross_weight	String	Vehicle gross weight
1.58	wheelbase	String	Vehicle wheel base details
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When RC details are fetched successfully	200	1	success	Successful Request
When Invalid RC details are entered	200	9	success	RC Verification Failed.	verification_failed
When No RC details entered	400	-1	failed	Please provide the valid rc/chassis number	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["rc","verify"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"c9c9b377-c28d-4e21-ada7-0d3bb06bc3e7","name":"Success Scenario","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"rc_number\": \"{{rc_number}}\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/rc/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 08:17:04 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"blacklist_status\": null,\n \"body_type\": \"\",\n \"challan_details\": null,\n \"color\": \"GREY\",\n \"cubic_capacity\": \"109.0\",\n \"father_name\": \"XXXXXXXX\",\n \"financed\": null,\n \"financer\": null,\n \"fit_up_to\": \"2028-06-18\",\n \"fuel_type\": \"PETROL\",\n \"insurance_company\": \"Kotak Mahindra General Insurance\",\n \"insurance_policy_number\": \"XXXXXXXXXX\",\n \"insurance_upto\": \"2023-09-21\",\n \"latest_by\": \"2022-11-29\",\n \"less_info\": true,\n \"maker_description\": \"HONDA MOTORCYCLE AND SCOOTER INDIA (P) LTD\",\n \"maker_model\": \"HONDA ACTIVA 110\",\n \"manufacturing_date\": \"6/2013\",\n \"masked_name\": false,\n \"mobile_number\": \"\",\n \"national_permit_issued_by\": null,\n \"national_permit_number\": null,\n \"national_permit_upto\": null,\n \"no_cylinders\": \"1\",\n \"noc_details\": \"NA\",\n \"non_use_from\": null,\n \"non_use_status\": null,\n \"non_use_to\": null,\n \"norms_type\": \"Not Available\",\n \"owner_name\": \"XXXXXXX XXXXXX\",\n \"owner_number\": \"1\",\n \"permanent_address\": \"AT XXXX POST XXXXX , TAL XXXXX DIST PUNE,PUNE, -412108\",\n \"permit_issue_date\": \"1900-01-01\",\n \"permit_number\": null,\n \"permit_type\": \"\",\n \"permit_valid_from\": \"1900-01-01\",\n \"permit_valid_upto\": null,\n \"present_address\": \"AT XXXXX POST XXXXX , TAL XXXXXX DIST PUNE,PUNE, -412108\",\n \"pucc_number\": \"MH0120XXXXXXXXXX\",\n \"pucc_upto\": null,\n \"rc_number\": \"MHXXKBXXXX\",\n \"rc_status\": \"ACTIVE\",\n \"registered_at\": \"PUNE, Maharashtra\",\n \"registration_date\": \"2013-06-19\",\n \"seat_capacity\": \"2\",\n \"sleeper_capacity\": \"NA\",\n \"standing_capacity\": \"NA\",\n \"tax_paid_upto\": \"LTT\",\n \"tax_upto\": null,\n \"unladen_weight\": \"111\",\n \"variant\": null,\n \"vehicle_category\": \"2WN\",\n \"vehicle_category_description\": \"M-Cycle/Scooter\",\n \"vehicle_chasi_number\": \"ME4JF50XXXXXXXXXX\",\n \"vehicle_engine_number\": \"JF5XXXXXXXXXX\",\n \"vehicle_gross_weight\": \"0\",\n \"wheelbase\": \"NA\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1669709823079,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"rc_verify_xyfxIBDT8sXXXXXXXXXX\"\n}"},{"id":"30eeb476-6610-4a32-9772-e905dab35aae","name":"Invalid RC Number","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"rc_number\": \"DL5CJ538\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/rc/verify"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 08:17:37 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 9,\n \"message_code\": \"success\",\n \"message\": \"RC Verification Failed.\",\n \"timestamp\": 1669709851743,\n \"error\": \"verification_failed\",\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"rc_verify_bXY2yh2p7qNsAMN0yZuh\"\n}"},{"id":"e6df4ca0-cead-417c-bd2d-51cb7f98b9f3","name":"No RC details entered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\"rc_number\": \"\"}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/rc/verify"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 08:18:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid rc/chassis number\",\n \"timestamp\": 1669709911119,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"rc_verify_asJETe41XHsAH5UVbitn\"\n}"}],"_postman_id":"ceae73f3-15f2-4ff8-af9d-39c8c5bd9136"}],"id":"3855a7ed-dc12-413f-82ca-c535ecfd6551","_postman_id":"3855a7ed-dc12-413f-82ca-c535ecfd6551","description":""},{"name":"AML V2","item":[{"name":"search","item":[{"name":"createSearch","id":"0d34034f-1c9c-4391-a390-62e13417adec","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"client_ref\": null,\n \"filters\": {\n \"birth_year\": null,\n \"country_codes\": [],\n \"types\": [\n \"sanction\",\n \"warning\",\n \"fitness-probity\",\n \"pep-class-1\",\n \"pep-class-2\",\n \"pep-class-3\",\n \"pep-class-4\",\n \"adverse-media-v2-property\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-narcotics-aml-cft\",\n \"adverse-media-v2-violence-aml-cft\",\n \"adverse-media-v2-terrorism\",\n \"adverse-media-v2-cybercrime\",\n \"adverse-media-v2-general-aml-cft\",\n \"adverse-media-v2-regulatory\",\n \"adverse-media-v2-financial-difficulty\",\n \"adverse-media-v2-violence-non-aml-cft\"\n ]\n },\n \"fuzziness\": 0.1,\n \"search_term\": \"jagan mohan\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search","description":"

createSearch API is used to search about particular entityType (eg. An independent search entry can be created for individual named 'Vijay Mallya'. Search entry will be created.)

Request

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	client_ref	String	Optional	A string representing the client reference. This must contain only alphanumeric characters, spaces, dashes and underscores.
2	filters	String	Required	Refer: filters definition
3	fuzziness	Float	Required	Refer: fuzziness definition
4	search_term	String	Required	A string representing the name of the entity or an Object

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	String	Generated search_id is shown
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When search is created successfully	200	1	success	success
When search term details are missing	400	-1	failed		Please provide the search term
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"c9059b45-1898-4453-a391-8d5ec22cb4f1","name":"Search Entry created Successfully","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"client_ref\": \"123vijay\",\n \"filters\": {\n \"birth_year\": null,\n \"country_codes\": [],\n \"types\": [\n \"sanction\",\n \"warning\",\n \"fitness-probity\",\n \"pep-class-1\",\n \"pep-class-2\",\n \"pep-class-3\",\n \"pep-class-4\",\n \"adverse-media-v2-property\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-narcotics-aml-cft\",\n \"adverse-media-v2-violence-aml-cft\",\n \"adverse-media-v2-terrorism\",\n \"adverse-media-v2-cybercrime\",\n \"adverse-media-v2-general-aml-cft\",\n \"adverse-media-v2-regulatory\",\n \"adverse-media-v2-financial-difficulty\",\n \"adverse-media-v2-violence-non-aml-cft\"\n ]\n },\n \"fuzziness\": 0.1,\n \"search_term\": \"Vijay Mallya\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 10:14:45 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"1122740003\",\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669544084344,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_J0sQ13nAHGFd9QcOYqxL\"\n}"},{"id":"8e37c5f5-c5b8-47da-b66f-4282834befc4","name":"Search Term details not provided","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"client_ref\": \"123vijay\",\n \"filters\": {\n \"birth_year\": null,\n \"country_codes\": [],\n \"types\": [\n \"sanction\",\n \"warning\",\n \"fitness-probity\",\n \"pep-class-1\",\n \"pep-class-2\",\n \"pep-class-3\",\n \"pep-class-4\",\n \"adverse-media-v2-property\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-narcotics-aml-cft\",\n \"adverse-media-v2-violence-aml-cft\",\n \"adverse-media-v2-terrorism\",\n \"adverse-media-v2-cybercrime\",\n \"adverse-media-v2-general-aml-cft\",\n \"adverse-media-v2-regulatory\",\n \"adverse-media-v2-financial-difficulty\",\n \"adverse-media-v2-violence-non-aml-cft\"\n ]\n },\n \"fuzziness\": 0.1\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 19:23:43 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": null,\n \"timestamp\": 1669749823747,\n \"error\": \"Please provide the search term\",\n \"success\": false,\n \"txn_id\": \"aml_v2_ajYXEqkKBuK3KUe6dRKV\"\n}"}],"_postman_id":"0d34034f-1c9c-4391-a390-62e13417adec"},{"name":"getSearchDetails","id":"6ace1b6a-a478-4af2-960f-5ee0b07e101b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/","description":"

getSearchDetails API is used to fetch all the matches found for the given search entry. Given the searchId, it shows all the possible matches found. Each record is called an entity and has entityId assigned with other corresponding details.

Request: search_id to be passed via endpoint URL

Response:

S. No	Key	Data Type	Description
1	data	Object	Record details about particular search_id
1.1	results	Object	Records associated with search_id
1.1.1	id	String	Unique entityId for the particular record/match of search_id
1.1.2	name	String	Name of entity, such as person name (e.g. \"Vijay Mallya\")
1.1.3	riskLevel	String	Refer: risk_level definition
1.1.4	matchStatus	String	Refer: match_status definition
1.1.5	types	Object	Refer: Filterstypes definition
1.1.6	countries	String	Associated country / countries' names for a person or company
1.1.7	entityType	String	Refer: Entity definition
1.1.8	whitelisted	String	Refer: is_whitelisted definition
1.1.9	relevance	Object	Refer: Relevance definition
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message
When search is created successfully	200	1	success	success
When invalid Search Id entered	500	88	failed
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",""],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"423b0072-c60d-4763-8a9c-b9f4dd026be9","name":"Search Summery","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 05:53:15 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"results\": [\n {\n \"id\": \"KDI7IBLVH86W6GG\",\n \"name\": \"Mallya Vijay\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-cybercrime\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-general-aml-cft\",\n \"adverse-media-v2-narcotics-aml-cft\",\n \"adverse-media-v2-other-financial\",\n \"adverse-media-v2-other-minor\",\n \"adverse-media-v2-other-serious\",\n \"adverse-media-v2-property\",\n \"adverse-media-v2-terrorism\",\n \"adverse-media-v2-violence-aml-cft\",\n \"adverse-media-v2-violence-non-aml-cft\",\n \"pep\",\n \"pep-class-1\",\n \"pep-class-2\",\n \"pep-class-4\"\n ],\n \"countries\": \"Canada, China, India, Malaysia, Pakistan, Sri Lanka, Thailand, United Kingdom, United States\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"OCABD1CRR71V7RY\",\n \"name\": \"Vijay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-general-aml-cft\",\n \"warning\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"RRQ4GHRPUZ2L2V3\",\n \"name\": \"Vijay Mallya Virat Kohli\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-other-minor\",\n \"adverse-media-v2-terrorism\"\n ],\n \"countries\": \"India, United Kingdom\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"D5HFD66635Y34LD\",\n \"name\": \"Yogesh Naik Vijay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-other-minor\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"X8S73IGC1573SRJ\",\n \"name\": \"Malla Vijaya Prasad\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-other-minor\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_fuzzy\"\n ]\n },\n {\n \"id\": \"79YQS8QINSXSSKT\",\n \"name\": \"Viljay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-fraud-linked\"\n ],\n \"countries\": null,\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_fuzzy\"\n ]\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669269194746,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_KTGpZ1Q9k2nSrCcRIFjK\"\n}"},{"id":"798afd32-97c9-46c0-928b-2c7fe3a8ef9f","name":"Invalid Search ID entered","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/11227400031"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Tue, 29 Nov 2022 19:28:08 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 500,\n \"response_code\": 88,\n \"message_code\": null,\n \"message\": null,\n \"timestamp\": 1669750087833,\n \"error\": null,\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"aml_v2_wtkUGmJxQlEFoZjHnhsC\"\n}"}],"_postman_id":"6ace1b6a-a478-4af2-960f-5ee0b07e101b"},{"name":"getEntityDetails","id":"3201b7f8-7b94-427b-b364-a08729684d6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{APIKEY}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/773864417/entity/HKC8EOIIDCLVWG3","description":"

getEntityDetails API is used get the record of a independent entity from the search performed. Search_id and associated entityId is required to be passed. The API response is the detailed record about selected entityId.

Request: Uniquely generated search_id and associated entity_Id to be passed via endpoint URL

Response:

S. No	Key	Data Type	Description
1	data	Object	Entity Details
1.1	id	String	Unique entity_id
1.2	name	String	Name of entity, such as person name (e.g. \"Vijay Mallya\")
1.3	countries	String	Associated country / countries' names for a person or company
1.4	entityType	String	Refer: Entity definition
1.5	dob	String	Date of Birth for entity (yyyy or yyyy-mm-dd)
1.6	aka	Object	Array of alternative names for the entity. Note that the \"name\" field is present at the minimum.
1.7	associates	Object	Array of names of associated entities. Note that the \"name\" field present at the minimum, also the \"association\" (such as \"Spouse\", \"Brother\" etc...) and \"comment\" fields.
1.8	sanction_List	Object	Refer: sanction_List definition
1.9	pep_Data	Object	Refer: pep_data definition
1.10	adverse_Media	Object	Refer: adverse_Media definition
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When entity details are successfully fetched	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search","773864417","entity","HKC8EOIIDCLVWG3"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"32a8e55e-9f10-40ae-95d3-6c617f288b17","name":"Entity Details fetched successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/1118736157/entity/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Strict-Transport-Security","value":"max-age=0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 05:57:35 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": \"KDI7IBXXXXXXXXXX\",\n \"name\": \"Mallya Vijay\",\n \"countries\": \"Canada, China, India, Malaysia, Pakistan, Sri Lanka, Thailand, United Kingdom, United States\",\n \"entityType\": \"person\",\n \"dob\": \"1956\",\n \"aka\": [\n \"விஜய் மல்லையா\",\n \"ビジェイ・マリヤ\",\n \"Vijay Mally\",\n \"Vijay Malaya\",\n \"Vijaya Mallya\",\n \"Виджай Маля\",\n \"Vijay Mallya\",\n \"Shri Vijay Mallya\",\n \"Vijaya Mallaya\",\n \"فيجاي ماليا\",\n \"ਵਿਜੇ ਮਾਲਿਆ\",\n \"Vijay Vittal Mallya\",\n \"Виджай Маллья\",\n \"Vijay Mallaya\",\n \"Mallya Vijay\",\n \"baron Vijay Mallya\",\n \"Vija Mallya\",\n \"Vijay Malya\",\n \"Vijay Vithal Mallya\",\n \"വിജയ് മല്യ\",\n \"विजय माल्या\",\n \"विजय मल्ल्या\",\n \"Vijay Mallyas\",\n \"維傑·馬爾雅\"\n ],\n \"associates\": [\n \"Rekha Mallya(spouse)\",\n \"Sameera Tyabjee(spouse)\",\n \"Sameera Tyabjee Mallya(spouse)\",\n \"Siddharth Mallya(child)\"\n ],\n \"sanction_List\": {\n \"Date of Birth\": \"1956\",\n \"Gender\": \"male\",\n \"Original Country Text\": \"United Kingdom\",\n \"Nationality\": \"India\"\n },\n \"dfat_Australia_Consolidated_SanctionsList\": {},\n \"eu_External_Action_Service_Consolidated_list_of_Sanctions\": {},\n \"united_Kingdom_HM_Treasury_Office_of_Financial_Sanctions_Implementation_Consolidated_List\": {},\n \"iceland_Sanctions_List\": {},\n \"malta_Financial_Services_Authority_MFSA_National_Sanctions_Suspended\": {},\n \"monaco_Economic_Sanctions\": {},\n \"dfatd_Canada_Special_Economic_Measures_Act_Designations\": {},\n \"france_Tresor_Direction_Generale_Liste_Unique_de_Gels\": {},\n \"switzerland_SECO_List\": {},\n \"belgium_Consolidated_List_of_the_National_and_European_Sanctions\": {},\n \"pep_Data\": {\n \"Party\": \"Independent politician\",\n \"Date Of Birth\": \"1955-12-18\",\n \"PEP_Data\": null,\n \"Political Position\": \"Chairperson, Entrepreneur, Indian businessman and politician, Member Of The Rajya Sabha, Politician, \",\n \"Country\": \"India\",\n \"Gender\": \"male\",\n \"Original Country Text\": \"India\",\n \"Nationality\": \"India\",\n \"Original Place Of Birth Text\": \"Bantwal\"\n },\n \"adverse_Media\": {\n \"Date Of Birth\": \"1956\",\n \"Country\": \"Canada, China, India, Malaysia, Pakistan, Sri Lanka, Thailand, United Kingdom, United States, \",\n \"Original Country Text\": \"Canada, India, United Kingdom, United States, China, Malaysia, Pakistan, International, Sri Lanka, Thailand, \"\n }\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669269454518,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_bRPmonQXEHM8wBTyC0Yt\"\n}"}],"_postman_id":"3201b7f8-7b94-427b-b364-a08729684d6a"},{"name":"getSearchSummary","id":"f4fe0661-068f-44e9-8d5a-5dbdd9acf511","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search","description":"

getSearchSummary API is used get the list of searches have been performed from an account.

Request: No request details to be passed.

Response:

S. No	Key	Data Type	Description
1	data	Object	Search record details
1.1	id	String	A search ID generated when search was performed for an entity.
1.2	created_at	String	Timestamp in milliseconds about search create date
1.3	search_term	String	A string representing the name of the entity or an Object
1.4	client_ref	String	Your reference for this person/entity for which you are searching. Used for tracking searches and auto-whitelisting recurring results
1.5	matchStatus	String	Refer: Match_status definition
1.6	risk_level	Object	Refer: Risk_level definition
1.7	searcher	String	Show searches performed by a specific user
1.8	assignee	String	Show searches assigned to a specific user
1.9	total_matches	String	count of the matches found/ entity count
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	String	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When search is created successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"7006d68c-bb7e-4dc1-b567-440673fd3c44","name":"List of search fetched successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Strict-Transport-Security","value":"max-age=0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 05:58:10 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": 1118XXXXXXXX,\n \"created_at\": \"2022-11-24 05:52:23\",\n \"search_term\": \"Vijay Mallya\",\n \"client_ref\": \"abc123\",\n \"match_status\": \"Potential Match\",\n \"risk_level\": \"unknown\",\n \"searcher\": \"Linus Xavier\",\n \"assignee\": \"Linus Xavier\",\n \"total_matches\": 0\n },\n {\n \"id\": 1118734460,\n \"created_at\": \"2022-11-24 05:47:54\",\n \"search_term\": \"jagan mohan\",\n \"client_ref\": null,\n \"match_status\": \"Potential Match\",\n \"risk_level\": \"unknown\",\n \"searcher\": \"Linus Xavier\",\n \"assignee\": \"Linus Xavier\",\n \"total_matches\": 0\n },\n {\n \"id\": 1099088436,\n \"created_at\": \"2022-11-10 05:39:30\",\n \"search_term\": \"Prashant Bharam\",\n \"client_ref\": null,\n \"match_status\": \"No Match\",\n \"risk_level\": \"unknown\",\n \"searcher\": \"XXXX XXXX\",\n \"assignee\": \"XXX XXXXX\",\n \"total_matches\": 0\n }\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669269489470,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_Kqnfu3TBaPXXXXXXXXXX\"\n}"}],"_postman_id":"f4fe0661-068f-44e9-8d5a-5dbdd9acf511"},{"name":"getSearchSummary - by Search ID","id":"a308db55-a895-445b-b8b2-a1d2dea7df72","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/search/:search_id/case","description":"

If client wishes to get the details about particular search, they can use getSearchSummary API to get the search details.

Request: search_id to be passed via endpoint URL

Response:

S. No	Key	Data Type	Description
1	data	Object	Details about particular search_id
1.1	id	String	Unique search_id
1.2	created_at	String	Search created date
1.3	search_term	String	NA string representing the name of the entity or an Object
1.4	client_ref	String	Your reference for this person/entity for which you are searching. Used for tracking searches and auto-whitelisting recurring results
1.5	match_status	String	Refer: Match_status definition
1.6	risk_level	Object	Refer: Risk_level definition
1.7	searcher	Object	Show searches performed by a specific user
1.8	assignee	String	Show searches assigned to a specific user
1.9	total_matches	Integer	Count of entity matches found for a search
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When independent search details are successfully fetched	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",":search_id","case"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[{"id":"c1ff3198-7cea-460e-b6ce-ad2de26d02d9","description":{"content":"

(Required) search_id

\n","type":"text/plain"},"type":"any","value":"","key":"search_id"}]}},"response":[{"id":"ce952237-0484-48df-8f1d-84cce29a27cc","name":"Search ID summary fetched Successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id/case","protocol":"https","host":["api","idcentral","io"],"path":["idc","aml","v2","search",":search_id","case"],"variable":[{"key":"search_id","value":"1118736157","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Strict-Transport-Security","value":"max-age=0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:01:55 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"id\": 1118XXXXXXXXX,\n \"created_at\": \"2022-11-24 05:52:23\",\n \"search_term\": \"Vijay Mallya\",\n \"client_ref\": \"abc123\",\n \"match_status\": \"Potential Match\",\n \"risk_level\": \"unknown\",\n \"searcher\": \"XXXXXX XXXXXX\",\n \"assignee\": \"XXXXXX XXXXX\",\n \"total_matches\": 0\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669269714500,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_qpuMMmYL2GXXXXXXXXX\"\n}"}],"_postman_id":"a308db55-a895-445b-b8b2-a1d2dea7df72"},{"name":"updateSearch","id":"6e0c5992-2b67-44de-9fc6-c33ce7fe3ea5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"entities\": [\n \"KDI7IBLVH86W6GG\"\n ],\n \"is_whitelisted\": \"true\",\n \"match_status\": null,\n \"risk_level\": null\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search/:search_id","description":"

updateSearch API is used update the details of the search and entity of a particular search.

Request: search_id be passed as path variable

(Note: If user wishes to update search details)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	match_status	String	Optional	Refer: Match_status definition
2	risk_level	String	Optional	Refer: risk_level definition
3	limit	Integer	Optional	The number of matches retrieved (max. 100)
4	tags	Object	Optional	Object of name => value pairs ( name must be string ), must be existing tags

(Note: If user wishes to update entity details from the selected search)

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	entities	Object	Optional	Refer: Entity definition
2	is_whitelisted	String	Optional	Refer: is_whitelisted definition
3	match_status	String	Optional	Refer: match_status definition
4	risk_level	String	Optional	Refer: Risk_level definition

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	String	Update search details
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	String	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	Integer	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Integer	This key field confirms if API request was successful or not. If value true the API request was success and if false then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When search / entity details are updated successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",":search_id"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[{"id":"823d2ff6-e1ab-45bc-9fc3-510e44a8997d","description":{"content":"

(Required) search_id

\n","type":"text/plain"},"type":"any","value":"","key":"search_id"}]}},"response":[{"id":"84343e83-805d-47d2-9407-da063d2ea64c","name":"Search Details updated Successfully","originalRequest":{"method":"PATCH","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"match_status\": \"false_positive\",\n \"risk_level\": \"medium\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id","protocol":"https","host":["api","idcentral","io"],"path":["idc","aml","v2","search",":search_id"],"variable":[{"key":"search_id","value":"","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:29:15 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"Updated Successfully\",\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669271355510,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_fQSn1liyOB0Mi2Up1oAa\"\n}"},{"id":"9ff856de-837c-4286-830e-59389563481b","name":"Update search entity","originalRequest":{"method":"PATCH","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"entities\": [\n \"KDI7IBLXXXXXXXXX\"\n ],\n \"is_whitelisted\": \"true\",\n \"match_status\": null,\n \"risk_level\": null\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id","host":["https://api.idcentral.io/idc"],"path":["aml","v2","search",":search_id"],"variable":[{"key":"search_id","value":"","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"Strict-Transport-Security","value":"max-age=0"},{"key":"X-Frame-Options","value":"DENY"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:11:22 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"Updated Successfully\",\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669270281846,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_chizWyKOTIohGkDVpyMt\"\n}"}],"_postman_id":"6e0c5992-2b67-44de-9fc6-c33ce7fe3ea5"},{"name":"updateSearcEntities","id":"a26d2eee-f147-4e3a-aad0-7f47b1a1c3fe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"esse exercitation ullamco sint id"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"entities\": [\n \"exercitation occaecat cupidatat et\",\n \"labore velit in Lorem nisi\"\n ],\n \"is_whitelisted\": false,\n \"match_status\": \"minim esse incididunt\",\n \"risk_level\": \"quis a\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search/:search_id/entiies","description":"

updateSearchEntities API is used update the details of particular entity from a search.

Request: search_id to be passed as path variable

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	entities	Object	Optional	List of entities. Details will be updated for given entity_ids
2	is_whitelisted	String	Optional	Refer: is_whitelisted definition
3	match_status	String	Optional	Refer: match_status definition
4	risk_level	String	Optional	Refer: risk_level definition
5	limit	Integer	Optional	The number of matches retrieved (max. 100)
6	tags	Object	Optional	Object of name => value pairs ( name must be string ), must be existing tags

Response:

S. No	Key	Data Type	Description
1	data	Object	Updated entity details
1.1	results	Object	Records associated with search entry
1.1.1	id	String	Unique entity ID
1.1.2	name	String	Name of entity, such as person name (e.g. \"Vijay Mallya\")
1.1.3	riskLevel	String	Refer: Risk_level definition
1.1.4	matchStatus	String	Refer: match_status definition
1.1.5	types	Object	What kind of alert or warning is associated with the entity (from \"sanction\", \"pep\", \"warning\")
1.1.6	countries	String	Associated country names for a person or company
1.1.7	entityType	String	Refer: Entity definition
1.1.8	whitelisted	String	Refer: is_whitelisted
1.1.9	relevance	Object	Refer: relevence definition
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When search / entity details are updated successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",":search_id","entiies"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[{"id":"656eea50-ecdc-4cf1-afd1-3b9f6ab1c907","description":{"content":"

(Required) search_id

\n","type":"text/plain"},"type":"any","value":"esse exercitation ullamco sint id","key":"search_id"}]}},"response":[{"id":"7068c62e-2fca-4d4c-911f-6268159c5e5a","name":"search entity update","originalRequest":{"method":"PATCH","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"entities\": [\n \"KDI7IBLVH86W6GG\"\n ],\n \"is_whitelisted\": \"false\",\n \"match_status\": null,\n \"risk_level\": null\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id/entiies","protocol":"https","host":["api","idcentral","io"],"path":["idc","aml","v2","search",":search_id","entiies"],"variable":[{"key":"search_id","value":"","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 24 Nov 2022 06:30:22 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"results\": [\n {\n \"id\": \"KDI7IBLVH86W6GG\",\n \"name\": \"Mallya Vijay\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-cybercrime\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-general-aml-cft\",\n \"adverse-media-v2-narcotics-aml-cft\",\n \"adverse-media-v2-other-financial\",\n \"adverse-media-v2-other-minor\",\n \"adverse-media-v2-other-serious\",\n \"adverse-media-v2-property\",\n \"adverse-media-v2-terrorism\",\n \"adverse-media-v2-violence-aml-cft\",\n \"adverse-media-v2-violence-non-aml-cft\",\n \"pep\",\n \"pep-class-1\",\n \"pep-class-2\",\n \"pep-class-4\"\n ],\n \"countries\": \"Canada, China, India, Malaysia, Pakistan, Sri Lanka, Thailand, United Kingdom, United States\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"OCABD1CRR71V7RY\",\n \"name\": \"Vijay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-general-aml-cft\",\n \"warning\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"RRQ4GHRPUZ2L2V3\",\n \"name\": \"Vijay Mallya Virat Kohli\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-other-minor\",\n \"adverse-media-v2-terrorism\"\n ],\n \"countries\": \"India, United Kingdom\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"D5HFD66635Y34LD\",\n \"name\": \"Yogesh Naik Vijay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-financial-aml-cft\",\n \"adverse-media-v2-other-minor\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_exact\"\n ]\n },\n {\n \"id\": \"X8S73IGC1573SRJ\",\n \"name\": \"Malla Vijaya Prasad\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-fraud-linked\",\n \"adverse-media-v2-other-minor\"\n ],\n \"countries\": \"India\",\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_fuzzy\"\n ]\n },\n {\n \"id\": \"79YQS8QINSXSSKT\",\n \"name\": \"Viljay Mallya\",\n \"riskLevel\": \"None\",\n \"matchStatus\": \"Potential Match\",\n \"types\": [\n \"adverse-media\",\n \"adverse-media-v2-fraud-linked\"\n ],\n \"countries\": null,\n \"entityType\": \"person\",\n \"whitelisted\": false,\n \"relevance\": [\n \"name_fuzzy\"\n ]\n }\n ]\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669271419507,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_Rkhoi2lGWUTvbALAlxdU\"\n}"}],"_postman_id":"a26d2eee-f147-4e3a-aad0-7f47b1a1c3fe"},{"name":"addComment","id":"c70d5b19-673b-4cfc-a308-1f20693efbe4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"comment\": \"Testing_123\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.idcentral.io/idc/aml/v2/search/:search_id/comments","description":"

Add comment on search or create comment on entity. The user that the API Key used was created with will be the assigned user for the comment and the timestamp will be the time the endpoint is called.

NOTE: Comment will be appended alongside any existing comments. To add multiple comments call the endpoint for each comment.

Request: search_id be passed as a path variable

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	comment	String	Required	The comment that will be added

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	data	String	Details on whether comment is added successfully or not
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When comment is added successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",":search_id","comments"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[{"id":"458d506f-1e55-4186-812a-2d99efcb4a89","description":{"content":"

(Required) search_id

\n","type":"text/plain"},"type":"any","value":"","key":"search_id"}]}},"response":[{"id":"24f13a52-f9dc-4ab0-9cd0-4cbdd14f82cb","name":"Comment added successfully","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"comment\": \"Testing_123\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id/comments","host":["https://api.idcentral.io/idc"],"path":["aml","v2","search",":search_id","comments"],"variable":[{"key":"search_id","value":"1122740003","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 13:39:55 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": \"Updated Successfully\",\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669556395060,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_g7EMIZL3IfMOHmGYxxC1\"\n}"}],"_postman_id":"c70d5b19-673b-4cfc-a308-1f20693efbe4"},{"name":"getCommentSummary","id":"341d7ead-ffd9-4513-8b5a-df8a1d688bd8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/search/:search_id/comments","description":"

getCommentSummary API retrieve comments for a specific search. It shows list of added comments for a search.

Request: search_id be passed as a path variable

Response:

S. No	Key	Data Type	Description
1	data	Object	Details of comments history
1.1	id	String	Uniquely generated comment_id
1.2	created_at	String	Comment added time
1.3	message	String	Content of the comment
1.4	user_id	Integer	User who has added the comment
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if failed then message `failed` to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When comment list is fetched successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","search",":search_id","comments"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[{"id":"fc38bb14-17f3-45c5-ab68-901c05996eac","description":{"content":"

(Required) search_id

\n","type":"text/plain"},"type":"any","value":"esse exercitation ullamco sint id","key":"search_id"}]}},"response":[{"id":"7b8d6c8b-085e-4e12-8103-535742b1b43b","name":"Comment Summary fetched successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":{"raw":"https://api.idcentral.io/idc/aml/v2/search/:search_id/comments","protocol":"https","host":["api","idcentral","io"],"path":["idc","aml","v2","search",":search_id","comments"],"variable":[{"key":"search_id","value":"","description":"(Required) search_id"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 14:24:24 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": [\n {\n \"id\": \"638368833cf496bf3e996f2c\",\n \"created_at\": \"2022-11-27T13:39:15.609000\",\n \"message\": \"abctesting123\",\n \"user_id\": 13884\n },\n {\n \"id\": \"638368b4061b393baa510a29\",\n \"created_at\": \"2022-11-27T13:40:04.431000\",\n \"message\": \"Testing_123\",\n \"user_id\": 13884\n },\n {\n \"id\": \"63836932cb548b1bbb839714\",\n \"created_at\": \"2022-11-27T13:42:10.096000\",\n \"message\": \"Testing_123\",\n \"user_id\": 13884\n },\n {\n \"id\": \"6383693e55cd884433301103\",\n \"created_at\": \"2022-11-27T13:42:22.054000\",\n \"message\": \"Testing_123\",\n \"user_id\": 13884\n }\n ],\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669559064589,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_6eO85tIsDV8IF7Hlt0lQ\"\n}"}],"_postman_id":"341d7ead-ffd9-4513-8b5a-df8a1d688bd8"}],"id":"b06303f7-6110-48a5-9a7d-3b04c6b9266f","description":"

You can perform search about any person, company, organization using Search API suite. Search API suite IDcentral's AML search API offers coverage to

1,000+ AML, PEP, sanctions and other adverse media lists
Monitors financial transactions and flags suspicious users
Extends the net of AML/CFT monitoring to linked users
Secure your business & customer network with high coverage

IDC search API suite consists of below APIs.

createSearch
getSearchDetails
getSearchSummary
getEntityDetails
getSearchSummary

\n","_postman_id":"b06303f7-6110-48a5-9a7d-3b04c6b9266f"},{"name":"bulkUpload","id":"fb0c9479-9adb-4429-bfd7-4f7763b37e76","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"esse exercitation ullamco sint id"},{"key":"Content-Type","value":"multipart/form-data"}],"body":{"mode":"formdata","formdata":[{"key":"0","value":"e","description":"

undefined

\n","type":"text"},{"key":"1","value":"s","description":"

undefined

\n","type":"text"},{"key":"2","value":"s","description":"

undefined

\n","type":"text"},{"key":"3","value":"e","description":"

undefined

\n","type":"text"},{"key":"4","value":" ","description":"

undefined

\n","type":"text"},{"key":"5","value":"e","description":"

undefined

\n","type":"text"},{"key":"6","value":"x","description":"

undefined

\n","type":"text"},{"key":"7","value":"e","description":"

undefined

\n","type":"text"},{"key":"8","value":"r","description":"

undefined

\n","type":"text"},{"key":"9","value":"c","description":"

undefined

\n","type":"text"},{"key":"10","value":"i","description":"

undefined

\n","type":"text"},{"key":"11","value":"t","description":"

undefined

\n","type":"text"},{"key":"12","value":"a","description":"

undefined

\n","type":"text"},{"key":"13","value":"t","description":"

undefined

\n","type":"text"},{"key":"14","value":"i","description":"

undefined

\n","type":"text"},{"key":"15","value":"o","description":"

undefined

\n","type":"text"},{"key":"16","value":"n","description":"

undefined

\n","type":"text"},{"key":"17","value":" ","description":"

undefined

\n","type":"text"},{"key":"18","value":"u","description":"

undefined

\n","type":"text"},{"key":"19","value":"l","description":"

undefined

\n","type":"text"},{"key":"20","value":"l","description":"

undefined

\n","type":"text"},{"key":"21","value":"a","description":"

undefined

\n","type":"text"},{"key":"22","value":"m","description":"

undefined

\n","type":"text"},{"key":"23","value":"c","description":"

undefined

\n","type":"text"},{"key":"24","value":"o","description":"

undefined

\n","type":"text"},{"key":"25","value":" ","description":"

undefined

\n","type":"text"},{"key":"26","value":"s","description":"

undefined

\n","type":"text"},{"key":"27","value":"i","description":"

undefined

\n","type":"text"},{"key":"28","value":"n","description":"

undefined

\n","type":"text"},{"key":"29","value":"t","description":"

undefined

\n","type":"text"},{"key":"30","value":" ","description":"

undefined

\n","type":"text"},{"key":"31","value":"i","description":"

undefined

\n","type":"text"},{"key":"32","value":"d","description":"

undefined

\n","type":"text"}]},"url":"https://api.idcentral.io/idc/aml/v2/upload","description":"

bulkUpload API is used to create searches in bulk using file upload or by passing search details

\n","urlObject":{"path":["aml","v2","upload"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"f962c68d-eb51-4e1f-a0a7-9c71cf84db4d","name":"OK","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/upload"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {},\n \"error\": \"aute sint\",\n \"responseTimestamp\": 71640062,\n \"status\": \"anim sed consequat exercitation proident\",\n \"statusCode\": \"anim\"\n}"},{"id":"176a5ed3-bbc3-4773-b335-b7704d164326","name":"Created","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/upload"},"status":"Created","code":201,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"91a87dfa-f289-4c37-8210-5fb81cc05c16","name":"Unauthorized","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/upload"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"95d9b717-380c-4343-96f1-0ef1593e7e8d","name":"Forbidden","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/upload"},"status":"Forbidden","code":403,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""},{"id":"b9ee198d-6208-4609-b68a-ae6bcee67bf0","name":"Not Found","originalRequest":{"method":"POST","header":[{"description":"(Required) api-key","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/upload"},"status":"Not Found","code":404,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"text/plain"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"fb0c9479-9adb-4429-bfd7-4f7763b37e76"},{"name":"getUsers","id":"4983a4a9-6bbd-4c32-9cf5-dbd8203c6028","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"description":"

(Required) api-key

\n","key":"api-key","value":"esse exercitation ullamco sint id"}],"url":"https://api.idcentral.io/idc/aml/v2/users","description":"

getUsers API retrieves all the users in your account.

Request: No request details to be passed

Response:

S. No	Key	Data Type	Description
1	data	Object	User Details
1.1	code	Integer	The http status code of the API. Refer: Errors and Status Codes
1.2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
1.3	content	Object	User details
1.3.1	data	Object	User details
1.3.1.1	id	Integer	Unique user Id of a user
1.3.1.2	email	String	Email ID of a user
1.3.1.3	name	Staring	Name of a user
1.3.1.4	phone	String	Phone number of a user
1.3.1.5	updated_at	Staring	User details updated on date
1.3.1.6	created_at	Staring	User created date
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	string	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When user list is fetch successfully	200	1	success	success
All other mismatch error	200	9

","urlObject":{"path":["aml","v2","users"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"87bc8a37-e349-4cbe-92dc-43c6440bd475","name":"Users fetched successfully","originalRequest":{"method":"GET","header":[{"description":"(Required) api-key","key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/aml/v2/users"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"private"},{"key":"Expires","value":"Thu, 01 Jan 1970 00:00:00 GMT"},{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 27 Nov 2022 14:35:42 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"code\": 200,\n \"status\": \"success\",\n \"content\": {\n \"data\": [\n {\n \"id\": 138XX,\n \"email\": \"XXXXX.XXXX@XXXX.com\",\n \"name\": \"XXXXX XXXXX\",\n \"phone\": \"\",\n \"updated_at\": \"2022-04-25T04:41:10Z\",\n \"created_at\": \"2021-05-04T10:35:46Z\"\n },\n {\n \"id\": 157XX,\n \"email\": \"sales@XXXXXXX.io\",\n \"name\": \"XXXXX\",\n \"phone\": null,\n \"updated_at\": \"2021-08-06T12:37:24Z\",\n \"created_at\": \"2021-08-06T12:37:24Z\"\n },\n {\n \"id\": 157XXX,\n \"email\": \"XXX@XXXXX.io\",\n \"name\": \"XXXXX\",\n \"phone\": null,\n \"updated_at\": \"2021-08-06T12:37:30Z\",\n \"created_at\": \"2021-08-06T12:37:30Z\"\n },\n {\n \"id\": 15776,\n \"email\": \"XXXXXX.XXXXXX@XXXXX.com\",\n \"name\": \"XXXXX\",\n \"phone\": null,\n \"updated_at\": \"2021-08-09T09:00:52Z\",\n \"created_at\": \"2021-08-09T09:00:52Z\"\n },\n {\n \"id\": 15777,\n \"email\": \"XXXXXXX+1@gmail.com\",\n \"name\": \"XXX\",\n \"phone\": null,\n \"updated_at\": \"2021-08-09T09:00:57Z\",\n \"created_at\": \"2021-08-09T09:00:57Z\"\n },\n {\n \"id\": 21981,\n \"email\": \"XXXXX.XXXXX@XXXXX.com\",\n \"name\": \"XXXXXX XXXXXX\",\n \"phone\": null,\n \"updated_at\": \"2022-06-23T10:33:14Z\",\n \"created_at\": \"2022-06-23T10:33:14Z\"\n },\n {\n \"id\": 23150,\n \"email\": \"XXXXXXX@gmail.com\",\n \"name\": \"XXXXXX\",\n \"phone\": null,\n \"updated_at\": \"2022-08-19T09:15:22Z\",\n \"created_at\": \"2022-08-19T09:15:22Z\"\n },\n {\n \"id\": 23273,\n \"email\": \"XXXXXXXX@gmail.com\",\n \"name\": \"XXXXXXXXX S\",\n \"phone\": null,\n \"updated_at\": \"2022-08-30T11:41:06Z\",\n \"created_at\": \"2022-08-30T11:41:06Z\"\n },\n {\n \"id\": 23274,\n \"email\": \"XXXXXX.XXXXX@XXXXX.com\",\n \"name\": \"XXXXX\",\n \"phone\": null,\n \"updated_at\": \"2022-09-16T18:48:53Z\",\n \"created_at\": \"2022-08-30T11:42:44Z\"\n }\n ]\n }\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": null,\n \"timestamp\": 1669559741889,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"aml_v2_qsIqusELi3gAvXXXXXXXXXX\"\n}"}],"_postman_id":"4983a4a9-6bbd-4c32-9cf5-dbd8203c6028"}],"id":"da434767-7eb3-4089-ab7e-a3d1538613a2","description":"

What is AML?

Anti Money Laundering (AML), is the execution of transactions to eventually convert illegally obtained money into legal money. Although you as a company stick to the rules, this does not mean that your partners and business associates adhere to the same AML compliance laws as you. Particularly in international business, you run the risk that the companies or individuals with whom you do business are not in compliance with the anti money laundering regulations set by the government. Conducting a due diligence investigation on your partners, suppliers but also customers is therefore essential.

IDC AML API covers data from globally available sources to prepare real time reports on individuals and businesses which includes financial sanctions and regulations imposed by the global bodies, political links and any adverse media coverage.

IDcentral AML solution capabilities

It screen customers against 1,000+ global watchlists including PEP (politically exposed person) sanctions, and AML lists, and get real-time notifications on any incidents of fraud.
Follows customer transactions on your platform through an advance rule engine that also raises alerts in case of any violation.
Quickly identify potential threats and suspicious users and their links to other users and merchants on your platform, and get immediate alerts on risk scores.
Automatically scans customer accounts, data, and KYC forms and reports any suspicious activity so that the user data can be scrutinized further.
Provides a repository of tools that assure high solution performance and greater user productivity.

The current list of available API endpoints on the IDcentral API is shown below.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

ENDPOINT	DESCRIPTION
https://api.idcentral.io/idc/aml/v2/users	Get a list of users in your account
https://api.idcentral.io/idc/aml/v2/search	Get a list of your previous searches
https://api.idcentral.io/idc/aml/v2/search	Create a new search
https://api.idcentral.io/idc/aml/v2/search/{{searchId}}/entity/{{entityId}}	Get an overview of one of entity from your selected search
https://api.idcentral.io/idc/aml/v2/search/	Get full search results of one of your searches
https://api.idcentral.io/idc/aml/v2/search/:search_id/case	Search details will can be retrived using this API
https://api.idcentral.io/idc/aml/v2/search/:search_id	Update details of one of your searches (eg, assigned user, status)
https://api.idcentral.io/idc/aml/v2/search/:search_id/entiies	Update entities details (eg, is_whitelisted risk_level, match_status) of one of your searches
https://api.idcentral.io/idc/aml/v2/search/:search_id/comments	Create a comment (comment on search or comment on entity)
https://api.idcentral.io/idc/aml/v2/search/:search_id/comments	Retrieve comments for a specific search
https://api.idcentral.io/idc/aml/v2/upload	Searches can be created in bulk using this API

Definition

Entity: It is a singular record from the performed search. When search is performed on AML solution, many matching results will appear. Every independent result is called an entity. entityType could be a person, Company, Organization, Vessel, aircraft etc.
searchId: It is an Id of an search entry created. When a details are being searched AML solution create a search entry for that search.
fuzziness: It is a technique that helps identify two elements of text, strings, or entries that are approximately similar but are not exactly the same. Fuzziness quotient from 0.0 to 1.0 inclusive decides the match fuzziness level from exact match (0.0) to loose (1.0). The default is a fuzzy match of 1.0.
match_status: Show searches where the match_status is one of the specified options: ('no_match', 'false_positive', 'potential_match', 'true_positive', 'unknown', 'true_positive_approve', 'true_positive_reject'). Use commas to separate multiple options, eg &match_status=potential_match,true_positive
risk_level: Show searches where the risk level is one of the specified options: ('low', 'medium', 'high', 'unknown'). Use commas to separate multiple options, eg &risk_level=medium,high
is_whitelisted: This indicates whether or not an entity has been whitelisted according to the supplied client-ref, and appears if the whitelist feature has been switched on for your account. You can modify this via your settings page or contact your account manager at IDC for more information about this feature. Entities are regarded as whitelisted if they are matched as false positive via your client reference, and have not been updated since.
Filters: Filters are used within the search to refine the result set. There is an extensive range of filters available - use of the filters is entirely optional. The example shows how the filters should be included in the request to the endpoint.The full range of filter parameters available is outlined below.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

FIELD NAME	TYPE	DESCRIPTION
types	Array of strings	(*) One or more of: sanction warning fitness-probity pep pep-class-1 pep-class-2 pep-class-3 pep-class-4 If you use classic Adverse Media Taxonomy: adverse-media adverse-media-financial-crime adverse-media-violent-crime adverse-media-sexual-crime adverse-media-terrorism adverse-media-fraud adverse-media-narcotics adverse-media-general If you use FATF-aligned Adverse Media Taxonomy: adverse-media-v2-property adverse-media-v2-financial-aml-cft adverse-media-v2-fraud-linked adverse-media-v2-narcotics-aml-cft adverse-media-v2-violence-aml-cft adverse-media-v2-terrorism adverse-media-v2-cybercrime adverse-media-v2-general-aml-cft adverse-media-v2-regulatory adverse-media-v2-financial-difficulty adverse-media-v2-violence-non-aml-cft adverse-media-v2-other-financial adverse-media-v2-other-serious adverse-media-v2-other-minor
birth_year	Integer	Year of birth, if known
remove_deceased	\"1\" or \"0\"	A flag which when set, removes deceased people from search results
country_codes	Array of ISO 3166-1 alpha-2 strings	Results are filtered by the entity nationality or country of residence. Country code filtering applies to: Entity of type PEP only Entity of type PEP with Adverse Media Entity that has 1 country value or more (only one has to match) Country code filtering does not apply to (i.e. results will still appear regardless of the country filter): Entity on sanction lists will always appear regardless of other status (PEP, Adverse media) Entity that has adverse media mentions only Entity that does not have a country assigned
entity_type	String (one of): \"person\" \"company\" \"organisation\" \"vessel\" \"aircraft\"	Entity type filter is not a hard filter between different entity types. It only optimizes the matching logic to the relevant entity type. Matching: Depending on the entity type, pre-fixes and suffixes will be processed differently to avoid false negatives (\"Mr Robert Mugabe\" matching \"Robert Mugabe\" for person, \"Cimex Ltd\" matching \"Cimex\" for company). Equivalent names considered specifically for different entity types (\"Robert\" and \"Bob\" versus \"Investment\" and \"Inversion\"). Initial matching between individual (\"Carl W. Litsch\") versus company acronyms (\"KFC\"). Optional: If missing, a default set of rules and logic will be applied.

(*) Note that search_profile and types are mutually exclusive, and only one of these two options should be provided.

relevance: Whenever we match against a document, we try to include some data as to what matched. We return the first value that is true from the following possible values:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Value	Description
name_exact	When matched against the entity name exactly
aka_exact	When matched against an entity AKA (also known as) entry exactly
name_fuzzy	When matched closely to the name, but at least one word had an edit distance change
aka_fuzzy	When matched closely to an AKA name, but at least one word had an edit distance change
phonetic_name	When matched against the entity name phonetically
phonetic_aka	When matched against an entity AKA phonetically
equivalent_name	When matched against the entity name with a synonym, e.g. \"Robert Mugabe\" => \"Bob Mugabe\"
equivalent_aka	When matched against an entity AKA with a synonym, e.g. \"Robert Mugabe\" => \"Bob Mugabe\"
unknown	When matched for a more complex reason, such as based on an acronym
year_of_birth	When matched the birth year as given in filters, can be the exact year of +-1 year regarding the fuzziness and options
removed_personal_title	A personal title, for example 'Mrs', was stripped from the search term
removed_personal_suffix	A personal suffix, for example 'PhD', was stripped from the search term
removed_organisation_prefix	An organisation prefix, for example 'JSC', was stripped from the search term
removed_organisation_suffix	An organisation suffix, for example 'Ltd', was stripped from the search term
removed_clerical_mark	A clerical mark, for example 'DECEASED', was stripped from the search term

sanction_List: Financial sanctions may be leveled against entire countries or against individuals and entities. They may also be used against third-parties that are not directly engaged in crimes but that are acting on behalf of sanctions targets. Sanctions targets are set out in official government lists, which are updated regularly as the sanctions landscape changes. Since sanctions are usually backed by serious civil and criminal penalties, institutions should consider their sanctions risk exposure and, if necessary, integrate sanctions list screening with their internal AML compliance process. Sanctions lists should play an important role in a financial institution’s anti-money laundering (AML) policy and will significantly affect how, and with whom, that institution does business.
Pep_data: A politically exposed person (PEP) is an individual with a high profile political role, or someone who has been entrusted with a prominent public function. These individuals present a higher risk of involvement in money laundering and/or terrorist financing because of the position they hold. While it may be useful for financial institutions to build a list of designated PEPs to reference, doing so is often challenging since the criteria that qualify an individual as a PEP are broadly defined and vary from country to country. The FATF also periodically issues new AML/CFT recommendations on PEPs which further complicates the implementation of any ‘definitive’ PEP list.
adverse_Media: Adverse media or negative news is defined as any kind of unfavorable information found across a wide variety of news sources – both ‘traditional’ news outlets and those from unstructured sources. The risks associated with conducting business with persons or companies having an adverse media profile are many and varied. Adverse media checks may reveal involvement with money laundering, financial fraud, drug trafficking, human trafficking, financial threats, organized crime, terrorism, and more.

\n","_postman_id":"da434767-7eb3-4089-ab7e-a3d1538613a2"},{"name":"Forgery Detection","item":[{"name":"Forgery Detection","id":"a76fd693-3de2-4b65-9a68-bae88c71fe1e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PAN","type":"text"},{"key":"id_document_image","type":"file","src":"/C:/Users/saikrishna.grande/Downloads/162528845556501362256_pancard_1625216273.jpeg"}]},"url":"https://api.idcentral.io/idc/detect/forgery","description":"

What is Forgery Detection API?

This Forgery Detection API helps you to be confident that the PAN card supplied to you hasn’t been built using a fake PAN generator app, doesn’t have a passport photo pasted on it, and has all the expected color schemes that a standard PAN is expected to have.
IDcentral's AI-based forgery detection API is designed to quickly identify fraud and forgery. An OCR algorithm is used to train the forgery detection API to make our Anti-spoof better the Bank Grade. Simply upload a document, and the system will confirm whether it is legitimate and has been issued by the government.

Definition:

score: Score acts as the confidence measure in determining that the the image is a not forged. The score range is between 0 to 100. More the score, less the chance of document being forged.
result: The final decision if the document is real or a spoof is determined by the score and the threshold. If thescore is above the threshold set this can be interpreted as accepted and will be shown as 'Pass', while if the score is below the threshold it is rejected and will be shown as 'fail'.

Supported Document Types:

This Forgery Detection API supports only PAN card Documents. and the docType code of the Pan Card as \"IN-PAN\"

Request: The request parameters has to pass under form-data format

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Required	Description
1	document_type	Text	Required	The type of the document
2	id_document_image	file	Required	The document file which required to verify as tampered or not

Response:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

S. No	Key	Data Type	Description
1	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
2	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
3	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
4	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
5	score	Integer	Refer: score defination
6	error	String	A text content explains a reason if API request failed
7	result	String	Refer: result defination
8	timestamp	Integer	API response receive time in milliseconds
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	message	String	A text content explains if API request was successful or not.
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.
12	count	String	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Result	Message	Error
When Valid PAN doc is uploaded	1		Pass	Successful Request
When fraudulent document is uploaded	1		Fail	Successful Request
When un supported Doc is uploaded	-1	-1	failed	The Document type provided in request is not valid/not supported by IDC system. Please provide the valid document type	Invalid Request
When file size exceeds the limit	-1	-1	failed	File exceeds maximumm file size 5242880 bytes and DSC00203.JPG size is 21233664 bytes	Invalid Request
When system is not able to determine the forgery in the document	1	1	success	Could not determine
All other mismatch error	200	9

","urlObject":{"path":["detect","forgery"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"956bc349-6296-4ad8-ac14-fe877f697ab0","name":"Valid PAN Card ID","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PAN","type":"text"},{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Prashant Pan Card P1.jpg"]}]},"url":"https://api.idcentral.io/idc/detect/forgery"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Thu, 08 Dec 2022 06:49:01 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"status_code\": 1,\n \"response_code\": 1,\n \"message_code\": null,\n \"score\": 80,\n \"error\": null,\n \"result\": \"Pass\",\n \"timestamp\": 1670482136639,\n \"success\": true,\n \"message\": \"Successful Request\",\n \"txn_id\": \"forgery_detection_in_pan_9M4zyTpWnS7RbBGGNhZ8\",\n \"count\": 0\n}"},{"id":"a76db44e-800f-4f41-8ddf-d16c79b91474","name":"Fraudulent Document","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PAN","type":"text"},{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Documet Sample/Fraud PAN.jpg"]}]},"url":"https://api.idcentral.io/idc/detect/forgery"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Fri, 06 Jan 2023 06:36:51 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"status_code\": 1,\n \"response_code\": 1,\n \"message_code\": null,\n \"score\": 0,\n \"error\": \"error\",\n \"result\": \"Could Not Determine\",\n \"timestamp\": 1672987007388,\n \"success\": false,\n \"message\": \"Successful Request\",\n \"txn_id\": \"forgery_detection_in_pan_fPg3of9qmsTSbkASuKDV\",\n \"count\": 0\n}"},{"id":"e9b9971b-02cf-48f8-809f-362a0aa13baa","name":"Invalid Document Type","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PSPT","type":"text"},{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/Passport_page-0001.jpg"]}]},"url":"https://api.idcentral.io/idc/detect/forgery"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 08:42:15 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"The Document type provided in request is not valid/not supported by IDC system. Please provide the valid document type\",\n \"timestamp\": 1668933736127,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"forgery_detection_in_pan_xnFs80Y52rdDxwo7rf49\"\n}"},{"id":"781acdc8-21ae-4432-b00e-c32c000f3a94","name":"File Size Exceeds","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PAN","type":"text"},{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/DSC00203.JPG"]}]},"url":"https://api.idcentral.io/idc/detect/forgery"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 08:48:30 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": -1,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"File exceeds maximumm file size 5242880 bytes and DSC00203.JPG size is 21233664 bytes\",\n \"timestamp\": 1668934110267,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"txn_id\": \"forgery_detection_in_pan_WmlIw0jrIOmWUe3mtV1B\"\n}"},{"id":"8886cdfd-0aa6-44da-a35f-56d0a10f16db","name":"Unable to determine Forgery","originalRequest":{"method":"POST","header":[{"key":"api-key","value":"{{apikey}}","type":"text"}],"body":{"mode":"formdata","formdata":[{"key":"document_type","value":"IN-PAN","type":"text"},{"key":"id_document_image","type":"file","src":["/C:/Users/prashant.bharam/Downloads/Testing/Passport_page-0001.jpg"]}]},"url":"https://api.idcentral.io/idc/detect/forgery"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 08:49:36 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"status_code\": 1,\n \"response_code\": 1,\n \"message_code\": null,\n \"score\": 0,\n \"error\": null,\n \"result\": \"Could not determine\",\n \"timestamp\": 1668934167696,\n \"success\": false,\n \"message\": \"Successful Request\",\n \"txn_id\": \"forgery_detection_in_pan_cQhSjU5irXnJ6lA4SSIM\",\n \"count\": 0\n}"}],"_postman_id":"a76fd693-3de2-4b65-9a68-bae88c71fe1e"}],"id":"c75cec79-3d34-4829-bb41-a1833273753c","description":"

This Forgery Detection eliminates the fraudulent onboarding at source by ensuring that the document provided to you is not a tampered document.

\n","_postman_id":"c75cec79-3d34-4829-bb41-a1833273753c"},{"name":"Voter ID","item":[{"name":"VoterID Verification API","id":"63720a76-a997-4dda-9aae-761af4a5bfb9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/voter-id/{{Voter_id}}","description":"

Request: Voter ID number to be passed via endpoint URL

Response:

S. No	Key	Data Type	Description
1	data	Object	Data as per the Voter Id records
1.1	client_id	String	Unique identifier of this object/ query which can be used as reference Id
1.2	epic_no	String	Voter Id unique serial number. Refer: Epic Number definition
1.3	gender	String	Gender as per the Voter Id records Male - M, female - F
1.4	state	String	State as per the Voter Id records
1.5	name	String	Name as per the Voter Id records
1.6	relation_name	String	Father or Husband Name of the Voter ID holder as per the Voter Id records
1.7	relation_type	String	Relation Type with the relative as per the voter ID records
1.8	house_no	String	House number as per the voter ID records
1.9	dob	String	Date of birth as per the voter ID records
1.10	age	String	Age as per the voter ID records
1.11	area	String	Village or area as per the voter ID records
1.12	district	String	District as per the voter ID records
1.13	additional_check	Array List	Any additional info as per the voter ID records
1.14	multiple	Boolean	-
1.15	last_update	String	Last update on the voter card as per the voter ID records
1.16	assembly_constituency	String	Assembly constituency as per the voter ID records
1.17	assembly_constituency_number	String	Assembly constituency number as per the voter ID records
1.18	polling_station	String	Polling station as per the voter ID records
1.19	part_number	String	Part number as per the voter ID records
1.20	part_name	String	Part Name as per the voter ID records
1.21	slno_inpart	String	Sl number in part as per the voter ID records
1.22	ps_lat_long	String	Coordinates of the location as per the voter ID records
1.23	rln_name_v1	String	Relation name as per the voter ID records
1.24	rln_name_v2	String	Father / Spouse name in local language
1.25	rln_name_v3	String	RLN name details
1.26	section_no	String	Sectionnumber details
1.27	name_v1	String	Name as per the voter ID records in Local language
1.28	name_v2	String	Name details
1.29	name_v3	String	Name details
1.30	st_code	String	St code as per the voter ID records
1.31	parliamentary_constituency	String	Parliamentary constituency Name as per the voter ID records
1.3.2	id	String	Unique transaction ID generated by the voter ID records
2	status	String	A text content confirms if API request was successfully completed or not. If value `success` then request was successfully processed and received response. and if `failed` then request failed due to error.
3	status_code	Integer	The http status code of the API. Refer: Errors and Status Codes
4	response_code	Integer	IDC internally mapped sub-status / response codes. Refer: Errors and Status Codes
5	message_code	String	A text content confirms if API response status message received successfully or not. If value `success` then request was successfully processed and received message response. and if `failed` then message failed to receive due to error.
6	message	String	A text content explains if API request was successful or not.
7	timestamp	Integer	API response receive time in milliseconds
8	error	String	A text content explains a reason if API request failed
9	success	Boolean	This key field confirms if API request was successful or not. If value `true` the API request was success and if `false` then failed
10	count	Integer	This key field gives count of the records present if received in the response. This field is not applicable for all the APIs
11	txn_id	String	Each request is issued a unique reference ID which is sent back to IDC’s client with each response. This reference ID helps to verify the request. The client can use this ID to check the status of already performed verifications.

Response Details:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Scenario	Status Code	Response Code	Status	Message	Error
When voter details fetch successfully	200	1	success	Successful Request
When Invalid voter Id is provided	400	-1	failed	Please provide the valid voter Id number	Invalid Request
All other mismatch errors	200	9

","urlObject":{"path":["voter-id","{{Voter_id}}"],"host":["https://api.idcentral.io/idc"],"query":[],"variable":[]}},"response":[{"id":"ced66a44-316f-418e-9630-f660aed9d12a","name":"Voter ID details fetched Successfully","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/voter-id/{{Voter_id}}"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 12:10:34 GMT"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": {\n \"client_id\": \"voter_uudbsiCvGXXXXXXXXXX\",\n \"epic_no\": \"ZLXXXXXXXX\",\n \"gender\": \"M\",\n \"state\": \"Maharashtra\",\n \"name\": \"PXXXXXX DXXXXX BXXXXXX\",\n \"relation_name\": \"DXXXXX BXXXXX\",\n \"relation_type\": \"F\",\n \"house_no\": null,\n \"dob\": null,\n \"age\": \"29\",\n \"area\": \"XXXXX\",\n \"district\": \"Pune\",\n \"additional_check\": [],\n \"multiple\": false,\n \"last_update\": \"2022-11-09\",\n \"assembly_constituency\": \"Bhor\",\n \"assembly_constituency_number\": \"203\",\n \"polling_station\": \"Zila XXXXX Primary School XXXXX, Building Facing towards XXXXX Room No. 2.from West\",\n \"part_number\": \"132\",\n \"part_name\": \"XXXXX\",\n \"slno_inpart\": \"170\",\n \"ps_lat_long\": \"0.0,0.0\",\n \"rln_name_v1\": \"XXXX XXXX\",\n \"rln_name_v2\": \"\",\n \"rln_name_v3\": \"\",\n \"section_no\": \"1\",\n \"name_v1\": \"XXXX XXX XXX\",\n \"name_v2\": \"\",\n \"name_v3\": \"\",\n \"st_code\": \"S13\",\n \"parliamentary_constituency\": \"Baramati\",\n \"id\": \"S13203XXXXXXXXXXX\"\n },\n \"status\": \"success\",\n \"status_code\": 200,\n \"response_code\": 1,\n \"message_code\": \"success\",\n \"message\": \"Successful Request\",\n \"timestamp\": 1668946229525,\n \"error\": null,\n \"success\": true,\n \"count\": 0,\n \"txn_id\": \"indian_voter_id_6A4PEdXyTCXXXXXXXXXX\"\n}"},{"id":"bde4debd-ac75-4f05-a830-fd2717da0456","name":"Invalid Voter ID entered","originalRequest":{"method":"POST","header":[{"key":"accept","value":"application/json"},{"key":"api-key","value":"{{apikey}}"}],"url":"https://api.idcentral.io/idc/voter-id/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Vary","value":"Origin"},{"key":"Vary","value":"Access-Control-Request-Method"},{"key":"Vary","value":"Access-Control-Request-Headers"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"Cache-Control","value":"no-cache, no-store, max-age=0, must-revalidate"},{"key":"Pragma","value":"no-cache"},{"key":"Expires","value":"0"},{"key":"Strict-Transport-Security","value":"max-age=31536000 ; includeSubDomains"},{"key":"X-Frame-Options","value":"DENY"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Date","value":"Sun, 20 Nov 2022 12:11:52 GMT"},{"key":"Connection","value":"close"}],"cookie":[],"responseTime":null,"body":"{\n \"data\": null,\n \"status\": \"failed\",\n \"status_code\": 400,\n \"response_code\": -1,\n \"message_code\": null,\n \"message\": \"Please provide the valid voter Id number\",\n \"timestamp\": 1668946313332,\n \"error\": \"Invalid Request\",\n \"success\": false,\n \"count\": 0,\n \"txn_id\": \"indian_voter_id_k17P6SRk1xZHwl11cfbT\"\n}"}],"_postman_id":"63720a76-a997-4dda-9aae-761af4a5bfb9"}],"id":"e50a44e6-0260-4de4-af38-004cb429571d","description":"

Definition

Epic Number: EPIC (Electors Photo Identity Card) number is the voter ID number issued by the Election Commission of India (ECI). This number works as identity proof for Indian nationals who are above the age of 18. It also allows Indian nationals to cast votes in various elections conducted in the country. The EPIC number can be found on the voter ID card. It's right above the top of your photo on your voter identification card. The EPIC number is usually 10 digits long.

\n","_postman_id":"e50a44e6-0260-4de4-af38-004cb429571d"}],"id":"6d5708bb-ddab-4515-a348-8cb29027fc00","_postman_id":"6d5708bb-ddab-4515-a348-8cb29027fc00","description":""}],"event":[{"listen":"prerequest","script":{"id":"f71b847e-2a26-4a66-861d-0832d67c4d88","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"b695428e-1db9-4097-bd25-c6add98db3b9","type":"text/javascript","exec":[""]}}],"variable":[{"key":"pan_number","value":"{{pan_number}}"},{"key":"country_code","value":"{{country_code}}"},{"key":"document_type","value":"{{document_type}}"},{"key":"apikey","value":"{{apikey}}"},{"key":"dl-num","value":""},{"key":"upi_handle","value":""},{"key":"aadharNumber","value":""},{"key":"voter_Id","value":""},{"key":"baseUrl","value":"https://api.idcentral.io/idc"},{"key":"baseName","value":""},{"key":"verificationName","value":""},{"key":"mockApi","value":"","type":"string"},{"key":"variable_key","value":""},{"key":"pan_numberMock","value":"","type":"string"},{"key":"aadharNumberMock","value":"","type":"string"},{"key":"pan_numberMock2","value":"","type":"string"},{"key":"aadharNumberMock2","value":"","type":"string"},{"key":"PanNew","value":"","type":"string"},{"key":"verificationName1","value":"","type":"string"},{"key":"baseName1","value":"","type":"string"},{"key":"aadharMob","value":"","type":"string"},{"key":"voter_IdMock","value":"","type":"string"},{"key":"emptypan","value":"","type":"string"},{"key":"lockedUID","value":"","type":"string"},{"key":"suspendedUID","value":"","type":"string"},{"key":"UPIID2","value":"","type":"string"},{"key":"UPIID3","value":"","type":"string"},{"key":"UPIID4","value":"","type":"string"},{"key":"AMLSearchID","value":"","type":"string"},{"key":"AMLEntityID","value":"","type":"string"},{"key":"stageUrl","value":"","type":"string"},{"key":"Longitude_value","value":"","type":"string"},{"key":"Latitude_value","value":"","type":"string"},{"key":"baseurl","value":"","type":"string"}]}