ICEGATE IEC Detail Search

API Introduction

The IEC Details Validation API enables real-time verification of an Importer Exporter Code (IEC) against the ICEGATE registry. It allows users to confirm whether a business is authorized to conduct import–export activities in India and to understand the current regulatory status of the IEC.

The API provides:

Validation of IEC authenticity

Current IEC lifecycle status

Registered entity details and branch locations (where available)

This API is commonly used in KYB, trade compliance, onboarding, and risk-assessment workflows to reduce regulatory exposure and ensure adherence to import–export regulations.

Use Cases

Importer / Exporter Validation: Verify IEC status prior to onboarding or transaction approval.

Trade Compliance Checks: Identify suspended, cancelled, or blacklisted IECs before enabling trade activity.

Risk Screening: Use IEC status as a regulatory signal alongside PAN, GST, and other business identifiers.

Operational Due Diligence: Validate exporter/importer credentials during partner or vendor onboarding.

API Specification

Endpoint

POST /v3/iec/search

Protocol

HTTPS

JSON request and response

Authentication

Bearer token authentication is required.

Authorization: <token>

Headers

Content-Type: application/json Accept: application/json

API Curl

curl --location 'https://api.signzy.app/api/v3/iec/search' \
--header 'Content-Type: application/json' \
--header 'Authorization: ****' \
--data '{
    "iecCode": "AAGCB9531J"
}'

Request Body

Request JSON

{ "iecCode": "AAGCB9531J" }

Request Parameters

Parameter	Description	Mandatory
iecCode	Importer Exporter Code to be validated against ICEGATE	Yes

Implementation Notes

Only one IEC can be validated per request.

Invalid or malformed IECs will result in validation errors.

API Response

Response JSON (Success)

{ "company": { "iec_code": "AAAAA9531J", "name": "BLUECRAFT LIMITED", "pan": "AAAAA9531JFT001", "iec_status": "9", "address": "Radaur Road Yamunanagar" }, "branches": [ { "branch_number": "1", "address": "R. EAST GODAVARI" } ] }

Response Parameters

Parameter (with parent)	Description	Data Type
company	Core IEC holder details	object
company.iec_code	Importer Exporter Code	string
company.name	Registered legal name	string
company.pan	PAN linked to IEC	string
company.iec_status	IEC status code (refer table below)	string
company.address	Registered address of IEC holder	string
branches	List of registered branch addresses	array
branches[].branch_number	Branch identifier	string
branches[].address	Branch address	string

Response Behavior

Branch information may be partially available depending on source data.

Absence of branch data does not imply IEC invalidity.

All IEC statuses should be interpreted using the status reference table below.

IEC Status Code Reference

Code	Status Description
0	Normal (Active)
1	Blacklisted
2	Suspended
3	Cancelled
4	Cleared from Blacklist
7	Revoke Suspension
8	Revoke Cancellation
9	Amendment

Error Codes

Error Response JSON

{ "error": { "name": "error", "message": "No record found", "status": 404, "reason": "NOT_FOUND", "type": "Not Found", "statusCode": 404 } }

Error Codes Table

HTTP Status	Error Code	Description	Recommended Action
400	INVALID_REQUEST	Missing or malformed request	Correct request
401	UNAUTHORIZED	Missing or invalid token	Verify credentials
404	IEC_NOT_FOUND	IEC not available in source	Not needed
409	UPSTREAM_UNAVAILABLE	Upstream Down	Retry
400	INVALID_IEC	IEC format validation failed	Correct IEC
429	RATE_LIMITED	Rate limit exceeded	Retry with backoff
504	TIMEOUT	Source timeout	Retry

Summary

The IEC Details Validation API provides a reliable, programmatic mechanism to validate IEC authenticity and status using the ICEGATE registry. It supports regulatory compliance, onboarding controls, and risk assessment by delivering structured IEC information through a simple and consistent API interface.