IEC Advanced

Endpoint Overview

POST /api/v1/corporate/iec-advanced

Description

The IEC Advanced API provides comprehensive information about an Importer-Exporter Code (IEC) by validating and retrieving detailed data from official government sources. This endpoint returns extensive details about the IEC holder, including firm information, registration status, director details, and RCMC (Registration-Cum-Membership Certificate) information.

Key Benefits

Verify the authenticity and current status of an IEC number

Access comprehensive business details including firm structure, contact information, and registration dates

Retrieve director information and RCMC details for enhanced due diligence

Confirm regulatory compliance status with DEL (Denied Entity List) verification

Use Cases

Banking & Finance

Logistics & Supply Chain

Regulatory Compliance

KYC verification for trade finance applications

Risk assessment for import/export financing

Validation of business credentials before approving international transactions

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
iec_number	String	Yes	The Importer-Exporter Code number to be verified
firm_name	String	No	Name of the firm for additional validation

Example Request

{
    "iec_number": "123566598"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains all the IEC details
data.client_id	String	Unique identifier for the API request
data.iec_number	String	The IEC number that was verified
data.firm_name	String	Name of the firm holding the IEC
data.pan_number	String	PAN number of the IEC holder
data.dob	String	Date of birth of the IEC holder (YYYY-MM-DD)
data.iec_issuance_date	String	Date when the IEC was issued (YYYY-MM-DD)
data.iec_status	String	Current status of the IEC (Valid/Invalid)
data.del_status	String	Denied Entity List status (Y/N)
data.iec_cancelled_date	String	Date when IEC was cancelled, if applicable (YYYY-MM-DD)
data.iec_suspended_date	String	Date when IEC was suspended, if applicable (YYYY-MM-DD)
data.file_number	String	File number associated with the IEC
data.file_date	String	File date (YYYY-MM-DD)
data.dgft_ra_office	String	DGFT Regional Authority office location
data.nature_of_concern	String	Type of business entity (Proprietorship, Partnership, etc.)
data.category_of_exporters	String	Category of the exporter
data.address	String	Registered address of the firm
data.firm_mobile_no	String	Contact number of the firm
data.firm_email_id	String	Email address of the firm
data.branch_details	Array	List of branch details (if any)
data.rcmc_details	Array	List of RCMC details
data.director_details	Array	List of director/proprietor details
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

RCMC Details Object

Parameter	Type	Description
rcmc_number	String	Registration-Cum Membership Certificate Number
issue_date	String	RCMC issue date (YYYY-MM-DD)
issue_authority	String	Authority that issued the RCMC
products_registered	String	Products registered under the RCMC
expiry_date	String	RCMC expiry date (YYYY-MM-DD)
status_source	String	Status of the RCMC (Active/Inactive)
exporter_type	String	Type of exporter classification
validity_period	String	Validity period in days
validated_by_epc_cb	String	Whether validated by EPC (Y/N)

Director Details Object

Parameter	Type	Description
father_name	String	Father's name of the IEC holder
name	String	Name of the IEC holder/director
pan_number	String	PAN number of the director
address	String	Address of the director

Example Successful Response

{
    "data": {
        "client_id": "iec_advanced_qivgEShUoxBSUcTCJRqd",
        "iec_number": "123456789",
        "firm_name": "Angel",
        "pan_number": "ABCD1234E",
        "dob": "1986-03-02",
        "iec_issuance_date": "2017-05-23",
        "iec_status": "Valid",
        "del_status": "N",
        "iec_cancelled_date": null,
        "iec_suspended_date": null,
        "file_number": "123456789XXXXXX",
        "file_date": "2023-08-02",
        "dgft_ra_office": "RA RAJKOT",
        "nature_of_concern": "Proprietorship",
        "category_of_exporters": " Exporter",
        "address": " Gruh,Rajkot, Gujarat, 360002 ,Rajkot , RAJKOT ,GUJARAT,",
        "firm_mobile_no": "1234567890",
        "firm_email_id": "angel@gmail.com",
        "branch_details": [],
        "rcmc_details": [
            {
                "rcmc_number": "AHD/350/2018-2019",
                "issue_date": "2023-06-07",
                "issue_authority": " Organisations",
                "products_registered": " agriculture, building materials",
                "expiry_date": "2024-03-31",
                "status_source": "Active",
                "exporter_type": "Merchant Cum Manufacturer Exporter",
                "validity_period": "298",
                "validated_by_epc_cb": "Y"
            }
        ],
        "director_details": [
            {
                "father_name": " KAMARIYA",
                "name": " KAMARIYA",
                "pan_number": "ABCD1234E",
                "address": "TO. KHAMBHALA,TA. PADDHARI Contact No: 1234567890,RAJKOT"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid IEC Number

Authentication Error

Service Unavailable

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid IEC number provided",
    "message_code": "invalid_iec"
}

The IEC number provided is invalid or in an incorrect format.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications

Rotate JWT tokens periodically and implement token expiration

Implement IP whitelisting for production environments if supported

User Experience Guidelines

Implement caching for frequently accessed IEC data to improve response times

Display a clear loading state while waiting for API responses

Provide clear error messages to end-users when verification fails

Format dates in a user-friendly manner (e.g., convert YYYY-MM-DD to a localized format)

Implement proper validation of IEC numbers before making API calls

Code Samples

cURL

Python

Node.js

Related APIs

IEC Basic Verification API - Provides basic verification of IEC numbers with minimal details

GST Verification API - Verifies GST registration details for businesses

PAN Verification API - Verifies PAN card details for individuals and businesses

Company Verification API - Retrieves comprehensive information about registered companies

Compliance and Legal Considerations

The IEC data provided by this API is sourced from official government records and should be used in compliance with applicable laws

Data obtained through this API should be handled in accordance with data protection regulations

IEC information should not be stored for longer than necessary for business purposes

Users should be aware that unauthorized use of IEC data may violate privacy laws and regulations

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/iec-advanced' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "iec_number": "123566598" }'

{ "data": { "client_id": "iec_advanced_qivgEShUoxBSUcTCJRqd", "iec_number": "123456789", "firm_name": "Angel", "pan_number": "ABCD1234E", "dob": "1986-03-02", "iec_issuance_date": "2017-05-23", "iec_status": "Valid", "del_status": "N", "iec_cancelled_date": null, "iec_suspended_date": null, "file_number": "123456789XXXXXX", "file_date": "2023-08-02", "dgft_ra_office": "RA RAJKOT", "nature_of_concern": "Proprietorship", "category_of_exporters": " Exporter", "address": " Gruh,Rajkot, Gujarat, 360002 ,Rajkot , RAJKOT ,GUJARAT,", "firm_mobile_no": "1234567890", "firm_email_id": "angel@gmail.com", "branch_details": [], "rcmc_details": [ { "rcmc_number": "AHD/350/2018-2019", "issue_date": "2023-06-07", "issue_authority": " Organisations", "products_registered": " agriculture, building materials", "expiry_date": "2024-03-31", "status_source": "Active", "exporter_type": "Merchant Cum Manufacturer Exporter", "validity_period": "298", "validated_by_epc_cb": "Y" } ], "director_details": [ { "father_name": " KAMARIYA", "name": " KAMARIYA", "pan_number": "ABCD1234E", "address": "TO. KHAMBHALA,TA. PADDHARI Contact No: 1234567890,RAJKOT" } ] }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

IEC Advanced

IEC Advanced#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

RCMC Details Object#

Director Details Object#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

IEC Advanced

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

RCMC Details Object

Director Details Object

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples