› compliance_grid.aiCOMPLIANCEGRIDGOV · COMPLIANCE · INTELLIGENCE
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.

Endpoints

MethodPathWhat it does
GET/v1/maritime/vesselsSearch vessels by name, IMO, MMSI, flag state, or type.Docs
GET/v1/maritime/vessels/imo/{imo}Look up a vessel by IMO number.Docs
GET/v1/maritime/ctpatSearch C-TPAT certified partners.Docs

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 →