Enterprise API
Direct ICEGATE Integration
REST API

Integrate your cargo system directly with ICEGATE. No middle layer. No manual steps.

The FreeIGM Enterprise API lets your cargo management system, freight ERP, or TMS file CGM and retrieve Air Consol status from ICEGATE programmatically — with full ICEGATE acknowledgement returned directly in the API response.

Zero manual portal intervention

Your system files and tracks — no human ICEGATE login required

24/7 API availability

File overnight arrivals, weekends, and pre-arrival with no downtime

Acknowledgement in the API response

ICEGATE filing reference returned directly to your system

Webhook push for status events

Real-time notifications for acceptance, rejection, BOE readiness

What is the Enterprise API?

ICEGATE CGM filing embedded directly in your existing system.

Most air cargo operations run in cargo management systems, freight ERPs, or TMS platforms that are entirely separate from ICEGATE. Filing CGM means someone has to leave the system, log into ICEGATE (or a separate filing portal), re-enter data that already exists in their system, and manually check status later. Every step is manual, every step is a chance for error, and every step slows the filing down.

The FreeIGM Enterprise API eliminates that entirely. Your cargo management system makes a single API call with the manifest data it already holds — and FreeIGM handles the full ICEGATE filing cycle: digital signing, transmission, acknowledgement capture, and status tracking. The ICEGATE filing reference number and acceptance status come back in the API response, ready to store in your system. No portal. No login. No re-entry. No waiting.

API endpoints

Core API endpoints for ICEGATE CGM integration.

MethodEndpointDescription
POST

/api/v1/cgm/file

Submit fresh CGM filing to ICEGATE

POST

/api/v1/cgm/part-file

Submit part filing for incomplete HAWB set

POST

/api/v1/cgm/amend

File amendment for previously submitted CGM

GET

/api/v1/cgm/{id}/status

Get current Air Consol + Air IGM + BOE status

POST

/api/v1/webhooks

Register webhook URL for status push notifications

Full API documentation, request/response schemas, and a Postman collection are provided to all enterprise integrations on onboarding. Contact support@freeigm.com to request access.

API specifications
REST · JSON · Versioned · Authenticated

A standard, production-grade REST API — not file upload, not SFTP.

The FreeIGM Enterprise API uses standard REST architecture — HTTPS endpoints, JSON request and response bodies, Bearer token authentication, and versioned paths (/api/v1/...). On enterprise onboarding, your team receives complete API documentation including an OpenAPI-compatible specification, a Postman collection, and direct access to a full sandbox environment with simulated ICEGATE responses. The API is controlled-access — not anonymous self-serve — to protect the ICEGATE filing pipeline, which is the standard model for customs-integrated APIs globally.

API type

REST / HTTPS — JSON request and response bodies

Authentication

Bearer token (API key) scoped per enterprise account; rotatable via dashboard

Versioning

v1 current stable — versioned endpoints (e.g. /api/v1/cgm/file)

Documentation

Full API reference + OpenAPI spec + Postman collection provided on enterprise onboarding

Sandbox environment

Full sandbox with same request format as production and simulated ICEGATE responses

Webhooks

Push notifications for filing acceptance, rejection, amendment, and BOE readiness

Uptime

24/7 — enterprise SLA with dedicated support and defined response times

Integration time

1–5 days with direct engineering support from the FreeIGM team

How API integration works

From your system to ICEGATE filing — fully automated.

Step 1

Your system sends filing data

Your cargo management system sends a JSON API request to FreeIGM with MAWB, HAWB, consignee, pieces, weight, and flight data.

Step 2

FreeIGM files on ICEGATE

FreeIGM signs, submits, and manages the full ICEGATE filing cycle — including digital signing and transmission — automatically.

Step 3

Acknowledgement returned to your system

The ICEGATE filing reference number and acceptance status are returned in the API response for storage and display in your system.

Step 4

Live status pushed to your system

Air Consol, Air IGM, and BOE status updates are pushed via webhook or available on demand via status endpoints — no portal login needed.

Enterprise API features

Everything your system needs for automated ICEGATE filing.

Direct ICEGATE filing from your existing system

Submit CGM and Air Consol filings to ICEGATE directly from your cargo management platform via REST API. No manual FreeIGM portal login, no copy-paste, no separate workflow — your system triggers the filing and receives the ICEGATE acknowledgement in the same API call.

Full filing lifecycle: fresh, part, and amendment

The API supports fresh CGM filing, part filing when all HAWBs are not yet ready, and post-submission amendment filing — the complete ICEGATE CGM lifecycle accessible programmatically from your TMS or freight ERP.

Real-time status without ICEGATE portal login

Poll Air Consol status, Air IGM status, and Bill of Entry readiness via dedicated status endpoints. Your cargo system can display live ICEGATE status to operations teams without anyone logging into the ICEGATE portal manually.

Webhook push for instant status updates

Register webhook URLs to receive instant push notifications when filing status changes on ICEGATE — acceptance, rejection, amendment, or BOE readiness. Your system reacts in real time without polling overhead.

Sandbox environment for safe integration testing

The FreeIGM sandbox accepts the same API requests as production and returns realistic ICEGATE response simulations. Build and validate your full integration before going live — no risk to production data or ICEGATE filings.

Enterprise SLA, dedicated onboarding, and API support

Enterprise integrations include an uptime SLA, dedicated technical onboarding, API documentation, sample Postman collection, and direct engineering support from the FreeIGM team throughout integration and go-live.

Who integrates with the Enterprise API

Built for every system that handles Indian air cargo filing.

Cargo management system (CMS) vendors

Embed ICEGATE CGM filing natively in your CMS product. Your customers file Air Consol directly from the system they already use — FreeIGM handles the ICEGATE integration, acknowledgement, and status for you.

Freight ERP and TMS platforms

Add direct ICEGATE filing as a built-in module in your freight ERP or TMS. No separate portal, no user context-switching — the filing happens inside your platform workflow.

Airlines and ground handling agents (GHAs)

High-volume daily CGM filing across multiple flights. Integrate once, automate all filings from your ground handling system, and receive ICEGATE acknowledgements back into your operations dashboard.

Large consolidators and freight forwarders

Eliminate manual CGM data entry from your operations. Your freight system pushes house bill data to the FreeIGM API as it arrives — CGM is filed on ICEGATE automatically without any human step.

Enterprise API frequently asked questions

Common questions about ICEGATE API integration.

The FreeIGM Enterprise API is a REST API that allows cargo management systems, freight ERP platforms, TMS software, and airline ground handling systems to submit CGM/Air Consol filings directly to ICEGATE — without any human intervention. Your system sends the manifest data, the API files it on ICEGATE, and returns the acknowledgement and live status back to your system automatically.

Any cargo management system, freight ERP, TMS, WMS, airline ground handling system, or custom-built logistics platform can integrate with the FreeIGM Enterprise API. The API is REST-based with JSON payloads and standard HTTP authentication, making it compatible with virtually any modern software stack.

The FreeIGM Enterprise API supports fresh CGM filing, part filing, and amendment filing for Air Consol/CGM on ICEGATE. It also provides real-time status polling endpoints for Air Consol status, Air IGM status, and Bill of Entry readiness — all without any manual ICEGATE login or portal interaction.

After your system submits a filing through the API, FreeIGM handles the full ICEGATE submission cycle — digital signing, transmission, and acknowledgement capture — and returns the ICEGATE filing reference number and acceptance status to your system in the API response. Your cargo management system can store and display this directly without any manual lookups.

Yes. The FreeIGM API is available around the clock, ensuring your cargo management system can file CGM and retrieve status at any time — including overnight, during weekend arrivals, and for time-critical pre-arrival filings. ICEGATE availability windows and maintenance periods are handled transparently with appropriate error codes.

The FreeIGM Enterprise API uses token-based authentication with API keys scoped to your enterprise account. API keys can be rotated, scoped to specific operations (file-only, status-only, or full access), and monitored via the enterprise dashboard. Contact the team at support@freeigm.com for sandbox access and onboarding.

Yes. The FreeIGM Enterprise API supports webhook callbacks so your cargo management system receives real-time push notifications when filing status changes — including ICEGATE acceptance, rejection, amendment requests, and Bill of Entry readiness — without needing to poll the status endpoint.

Enterprise API integrations include an SLA covering uptime, response time, and support response. Contact the FreeIGM team at support@freeigm.com to discuss SLA terms, dedicated onboarding, and integration support for your cargo management platform.

Yes. FreeIGM provides a sandbox environment for enterprise API integrations. The sandbox accepts the same request formats as production and returns simulated ICEGATE responses, so your development team can build, test, and validate the full integration before connecting to the live ICEGATE filing pipeline.

Most cargo management system integrations complete in 1–5 days depending on the complexity of the existing system and the number of filing workflows. The FreeIGM team provides API documentation, a sandbox environment, a sample Postman collection, and direct technical support throughout the integration.

The FreeIGM Enterprise API is a standard REST API — not file upload, not CSV/Excel ingestion, not SFTP-based transfer. Your system sends a structured JSON POST request over HTTPS to a versioned endpoint (e.g. POST /api/v1/cgm/file), receives a JSON response with the ICEGATE filing reference and status, and can register a webhook URL to receive push notifications when filing status changes. This is the same API architecture used by logistics and customs platforms globally — HTTP verbs, JSON payloads, Bearer token authentication, and versioned endpoints.

The FreeIGM Enterprise API is a controlled-access integration — not a self-serve developer sandbox open to anonymous sign-ups. API access is granted after enterprise onboarding to protect the ICEGATE filing pipeline from abuse and to ensure each integration is correctly configured for production filing. On onboarding, enterprises receive complete API documentation covering all endpoints, request/response schemas, error codes, and authentication setup, plus a Postman collection for immediate testing. This is the standard model for customs filing APIs globally — controlled access does not mean undocumented or immature; it means the integration is production-grade from day one.

Yes. Enterprise integrations receive full API documentation including an OpenAPI-compatible specification covering all endpoints, request body schemas, response formats, and error code definitions, along with a ready-to-use Postman collection. The sandbox environment allows your development team to test every filing and status flow against real API behavior before connecting to the live ICEGATE pipeline.

A CGM filing request is a JSON POST to /api/v1/cgm/file with your MAWB number, flight details, total pieces and weight, and an array of house bill objects (each with HAWB number, consignee, shipper, pieces, weight, commodity). The API response returns the ICEGATE filing reference number, the acceptance status code, and a timestamp — structured JSON your system can parse and store directly. Status polling via GET /api/v1/cgm/{id}/status returns Air Consol status, Air IGM status, and BOE readiness in a single response. Full schema documentation with field definitions, data types, and example values is provided on enterprise onboarding.

Enterprise API

Ready to integrate? Let's get started.

Contact the FreeIGM team to request sandbox access, API documentation, and enterprise onboarding. Most integrations complete in 1–5 days with direct engineering support.