Available3 endpoints$0.01 per successful call
Maritime & Port Security API
Vessel search, IMO lookup, and C-TPAT partner verification.
Base URL · https://api.compliancegrid.ai/v1/maritime
Search vessels · no signuplive data
Try or .
What it checks
The Maritime & Port Security API provides vessel search by name, IMO number, or MMSI, with details including flag state, vessel type, gross tonnage, owner, and registration port. Also includes C-TPAT (Customs-Trade Partnership Against Terrorism) partner search to verify certified importers, carriers, and brokers. The vessel and C-TPAT data are a small development sample, labelled provenance "seed" in every response: no live vessel feed and no USCG PSIX, MarineTraffic or CBP SVI connection exists, so a vessel or partner that is not in the sample is simply not found.
- Vessel search by name, IMO number, MMSI, flag state, or vessel type (sample data only)
- Vessel details: gross tonnage, year built, owner, port of registry
- IMO number lookup; the seven-digit check digit is validated (verified)
- C-TPAT partner search by name, SVI number, or tier (sample data only)
- C-TPAT certification status, tier level, and expiration date
- Entity type classification: Sea Carrier, Importer, Customs Broker, etc.
Request and response
// Search for a vessel by name
const resp = await fetch(
"https://api.compliancegrid.ai/v1/maritime/vessels?name=ever+given",
{ headers: { "Authorization": "Bearer " + process.env.CG_TOKEN } }
);
const data = await resp.json();
console.log(data.results[0].vesselName); // "EVER GIVEN"
console.log(data.results[0].imoNumber); // "9811000"
console.log(data.results[0].grossTonnage); // 220940
// Check C-TPAT certification
const ctpat = await fetch(
"https://api.compliancegrid.ai/v1/maritime/ctpat?companyName=maersk",
{ headers: { "Authorization": "Bearer " + process.env.CG_TOKEN } }
);
const cert = await ctpat.json();
console.log(cert.results[0].tier); // "Tier 3"
console.log(cert.results[0].status); // "Certified"Example response
{
"success": true,
"query": "ever given",
"results": [
{
"vesselName": "EVER GIVEN",
"imoNumber": "9811000",
"mmsi": "353136000",
"callSign": "3EQJ5",
"flag": "Panama",
"vesselType": "Container Ship",
"grossTonnage": 220940,
"yearBuilt": "2018",
"ownerName": "SHOEI KISEN KAISHA",
"portOfRegistry": "Panama City",
"status": "Active"
}
],
"totalResults": 1
}Good to know
- Results are information for your review, not legal advice or a compliance determination. Your reviewer makes the final call.
- Every response carries its source and the list version, so the result can go in your audit file.
- The sandbox returns mock data and production returns live data. Build in the sandbox and switch your key to go live.
Pricing
$0.01per successful call
Only successful calls are billed. Volume discounts start at 10,001 calls a month, and the sandbox is free.See pricing and estimate your bill →