--- type: "firecrawl-provider" description: "US Coast Guard Maritime Information Exchange PSIX SOAP service: vessel identity (VesselId, name, call sign, IMO or official number, HIN, flag, service type, build year), particulars, dimensions, tonnage and documents, and US port state control cases (inspections, boardings, investigations, operational controls) with their controls, deficiencies and inspection types, as a public-data collector (status, segmented list pinned by a VesselId-list hash, get, search). US Government work, public domain." use_when: "US Coast Guard Maritime Information Exchange PSIX SOAP service: vessel identity (VesselId, name, call sign, IMO or official number, HIN, flag, service type, build year), particulars, dimensions, tonnage and documents, and US port state control cases (inspections, boardings, investigations, operational controls) with their controls, deficiencies and inspection types, as a public-data collector (status, segmented list pinned by a VesselId-list hash, get, search). US Government work, public domain." categories: "Travel" capabilities: 4 credits_per_call: 5 --- # USCG CGMIX Port State Information Exchange (PSIX) on Firecrawl Alexandria US Coast Guard Maritime Information Exchange PSIX SOAP service: vessel identity (VesselId, name, call sign, IMO or official number, HIN, flag, service type, build year), particulars, dimensions, tonnage and documents, and US port state control cases (inspections, boardings, investigations, operational controls) with their controls, deficiencies and inspection types, as a public-data collector (status, segmented list pinned by a VesselId-list hash, get, search). US Government work, public domain. - Categories: Travel - Category index: [Travel category](https://firecrawl.dev/alexandria/agents/categories/travel) - Provider key: `cgmix-uscg-mil` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/cgmix-uscg-mil) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/openapi.json) ## Capabilities - [Records get](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/records_get): One record by id. psix: (or the bare VesselId): getVesselSummary, getVesselParticulars, getVesselDimensions, getVesselTonnage and getVesselDocuments in parallel; with include_cases (or cases_from/cases_to, YYYY-MM-DD, default 1900-01-01 to tomorrow) also the getVesselCases headers in that window. psix-case: with vessel_id: the case header (from the vessel's case list) plus its operational controls, deficiencies and inspection types. Control types pass through as published. publication_id is a SHA-256 of the record's upstream rows. - [Records list](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/records_list): Every vessel of one segment (getVesselSummary with Flag and Service, plus BuildYear when given), sorted by VesselId and paged by offset (page_size default 1000, max 5000). Each page re-fetches the segment and compares the SHA-256 of its sorted VesselId list with the one pinned in the cursor; a mismatch fails with invalid_input issue code publication_changed. A segment over the 32 MiB response cap fails with segment_too_large: split it by build_year. Records are summary rows; records_get returns particulars, dimensions, tonnage, documents and cases. - [Search](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/search): Vessels by name (case-insensitive substring), call sign, identification (IMO number or US official number, sent as VIN) or HIN, optionally narrowed by flag, service and build_year; at least one of name, call_sign, identification or hin is required. Exact name matches first, then by name; returns the first limit (default 50, max 500) and the total. - [Source status](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/source_status): Cheap version check. PSIX publishes no version, date or hash, so this hashes one getVesselSummary segment: by default the fixed canary segment UNITED STATES / Freight Ship / 2007; any flag, service and build_year segment on request. Returns the SHA-256 of the sorted VesselId list (the value a records_list cursor pins, as publication_id), a SHA-256 of the canonical summary rows (content_hash) and the record count. An empty canary segment is upstream_unavailable. ## 1. Choose this provider when US Coast Guard Maritime Information Exchange PSIX SOAP service: vessel identity (VesselId, name, call sign, IMO or official number, HIN, flag, service type, build year), particulars, dimensions, tonnage and documents, and US port state control cases (inspections, boardings, investigations, operational controls) with their controls, deficiencies and inspection types, as a public-data collector (status, segmented list pinned by a VesselId-list hash, get, search). US Government work, public domain. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "cgmix-uscg-mil", "capability": "maritime-safety/records_get", "options": { "id": "psix:1097015" } } ``` ## 3. Add provider options Use only the options needed for the task: - `cases_from` (string): Earliest case StartDtTm, YYYY-MM-DD (default 1900-01-01). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `cases_to` (string): Latest case StartDtTm, YYYY-MM-DD (default tomorrow, UTC). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `id` (string, required): psix:, a bare VesselId, or psix-case:. Example: `` - `include_cases` (boolean): Vessel ids: add case headers (default false). Example: `false` - `vessel_id` (number): Required with a psix-case id: PSIX lists case headers per vessel. Example: `10` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "cgmix-uscg-mil", capability: "maritime-safety/records_get", options: { id: "psix:1097015", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "cgmix-uscg-mil", "capability": "maritime-safety/records_get", "options": { "id": "psix:1097015" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "cgmix-uscg-mil", "capability": "maritime-safety/records_get", "options": { "id": "psix:1097015" } } }' ``` ### CLI ```sh firecrawl scrape 'cgmix-uscg-mil/maritime-safety/records_get' \ --options '{"id":"psix:1097015"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "cgmix-uscg-mil", "capability": "maritime-safety/records_get", "options": { "id": "psix:1097015" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "cgmix-uscg-mil", "capability": "maritime-safety/records_get", "options": { "id": "psix:1097015" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "observed_at_ms": 1792901411933, "publication_id": "7853c969d17979b547e4d2fc0ec1ff8c8bce8c5a8d394adcd4c8341d3441cb7e", "record": { "call_sign": "WMKN", "cargo_authorization_description": "See DOC for Ships Carrying Dangerous Goods", "cases": null, "cases_window": null, "construction_completed_year": 2007, "detail": "full", "dimensions": [ { "breadth_ft": 131.2, "depth_ft": 66.6, "dimension_type": "Convention", "length_ft": 941.2 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Length Between Perpendiculars", "length_ft": 940.6 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Design Draft", "length_ft": 39.4 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Length", "length_ft": 941.2 } ], "documents": [ { "document_type": "CERTIFICATE OF DOCUMENTATION", "expiry_date": "2027-09-30", "expiry_date_text": "September 30,2027", "issue_date": "2026-08-07T03:02:08.517-04:00", "issue_date_text": "August 7,2026", "number": "N/A", "organization": "USCG", "status": "Valid" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2028-09-04", "expiry_date_text": "September 4,2028", "issue_date": "2023-08-23T00:00:00-04:00", "issue_date_text": "August 23,2023", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "Certificate of Inspection", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7656061", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7811869", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7864845", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "8086152", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "8288344", "organization": "USCG", "status": "Issued/Effective" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2022-05-03", "expiry_date_text": "May 3,2022", "issue_date": "2021-05-03T00:00:00-04:00", "issue_date_text": "May 3,2021", "number": "N/A", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2025-08-11", "expiry_date_text": "August 11,2025", "issue_date": "2020-06-26T00:00:00-04:00", "issue_date_text": "June 26,2020", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "6887129", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "7656061", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "7626753", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2023-09-04", "expiry_date_text": "September 4,2023", "issue_date": "2018-08-07T00:00:00-04:00", "issue_date_text": "August 7,2018", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2018-09-30", "expiry_date_text": "September 30,2018", "issue_date": "2017-09-30T00:00:00-04:00", "issue_date_text": "September 30,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "Classification Document", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Load Line Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2020-08-11", "expiry_date_text": "August 11,2020", "issue_date": "2017-01-12T00:00:00-05:00", "issue_date_text": "January 12,2017", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Certificate of Inspection", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T14:40:38-04:00", "issue_date_text": "March 18,2015", "number": "5074916", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T14:40:38-04:00", "issue_date_text": "March 18,2015", "number": "5074916", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "5761817", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "5794888", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6078248", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6234933", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6339483", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6678663", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Tonnage Certificate, International", "expiry_date": null, "expiry_date_text": null, "issue_date": "2015-01-14T00:00:00-05:00", "issue_date_text": "January 14,2015", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2014-01-21T00:00:00-05:00", "issue_date_text": "January 21,2014", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-06-07T00:00:00-04:00", "issue_date_text": "June 7,2013", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-06-07T00:00:00-04:00", "issue_date_text": "June 7,2013", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Load Line Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-05-09T00:00:00-04:00", "issue_date_text": "May 9,2013", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Classification Document", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-19T00:00:00-05:00", "issue_date_text": "December 19,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": null, "expiry_date_text": null, "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-10-08T00:00:00-04:00", "issue_date_text": "October 8,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Minimum Safe Manning Document", "expiry_date": null, "expiry_date_text": null, "issue_date": "2012-10-03T00:00:00-04:00", "issue_date_text": "October 3,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2010-11-15T00:00:00-05:00", "issue_date_text": "November 15,2010", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2013-11-25", "expiry_date_text": "November 25,2013", "issue_date": "2009-12-15T00:00:00-05:00", "issue_date_text": "December 15,2009", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-11-04T00:00:00-05:00", "issue_date_text": "November 4,2009", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-03-31T00:00:00-04:00", "issue_date_text": "March 31,2009", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Classification Document", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-03-26T00:00:00-04:00", "issue_date_text": "March 26,2009", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Load Line Certificate", "expiry_date": null, "expiry_date_text": null, "issue_date": "2009-01-23T00:00:00-05:00", "issue_date_text": "January 23,2009", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Minimum Safe Manning Document", "expiry_date": null, "expiry_date_text": null, "issue_date": "2007-11-08T00:00:00-05:00", "issue_date_text": "November 8,2007", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Tonnage Certificate, International", "expiry_date": null, "expiry_date_text": null, "issue_date": "2007-10-25T00:00:00-04:00", "issue_date_text": "October 25,2007", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" } ], "flag": "UNITED STATES", "hin": null, "identification": "1257726", "identification_type": "Official Number (U.S.)", "manufacturer_hull_number": "166", "publication_id": "7853c969d17979b547e4d2fc0ec1ff8c8bce8c5a8d394adcd4c8341d3441cb7e", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_subtype": "General Cargo/Container", "service_type": "Freight Ship", "source_record_id": "psix:1097015", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselParticularsXMLString", "status": "Active", "tonnage": [ { "measure_of_weight": 44243, "tonnage_type": "Convention (Subpart B)", "unit_of_measure": "Short Ton" }, { "measure_of_weight": 111460, "tonnage_type": "Displacement", "unit_of_measure": "Ton" }, { "measure_of_weight": 74642, "tonnage_type": "Convention (Subpart B)", "unit_of_measure": "Long Ton" } ], "vessel_id": 1097015, "vessel_name": "MAERSK KENSINGTON" }, "retrieved_at": "2026-10-25T03:57:24Z" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Records get - Capability: `maritime-safety/records_get` - Description: One record by id. psix: (or the bare VesselId): getVesselSummary, getVesselParticulars, getVesselDimensions, getVesselTonnage and getVesselDocuments in parallel; with include_cases (or cases_from/cases_to, YYYY-MM-DD, default 1900-01-01 to tomorrow) also the getVesselCases headers in that window. psix-case: with vessel_id: the case header (from the vessel's case list) plus its operational controls, deficiencies and inspection types. Control types pass through as published. publication_id is a SHA-256 of the record's upstream rows. - Instructions: Vessel particulars and certificates, a vessel's US port state control history, or the controls and deficiencies of one case. - Cost: 5 credits per call - Capability file: [Records get](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/records_get) Accepted options: - `cases_from` (string): Earliest case StartDtTm, YYYY-MM-DD (default 1900-01-01). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `cases_to` (string): Latest case StartDtTm, YYYY-MM-DD (default tomorrow, UTC). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `id` (string, required): psix:, a bare VesselId, or psix-case:. Example: `` - `include_cases` (boolean): Vessel ids: add case headers (default false). Example: `false` - `vessel_id` (number): Required with a psix-case id: PSIX lists case headers per vessel. Example: `10` Response schema example: ```json { "observed_at_ms": 1792901411933, "publication_id": "7853c969d17979b547e4d2fc0ec1ff8c8bce8c5a8d394adcd4c8341d3441cb7e", "record": { "call_sign": "WMKN", "cargo_authorization_description": "See DOC for Ships Carrying Dangerous Goods", "cases": null, "cases_window": null, "construction_completed_year": 2007, "detail": "full", "dimensions": [ { "breadth_ft": 131.2, "depth_ft": 66.6, "dimension_type": "Convention", "length_ft": 941.2 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Length Between Perpendiculars", "length_ft": 940.6 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Design Draft", "length_ft": 39.4 }, { "breadth_ft": null, "depth_ft": null, "dimension_type": "Length", "length_ft": 941.2 } ], "documents": [ { "document_type": "CERTIFICATE OF DOCUMENTATION", "expiry_date": "2027-09-30", "expiry_date_text": "September 30,2027", "issue_date": "2026-08-07T03:02:08.517-04:00", "issue_date_text": "August 7,2026", "number": "N/A", "organization": "USCG", "status": "Valid" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2028-09-04", "expiry_date_text": "September 4,2028", "issue_date": "2023-08-23T00:00:00-04:00", "issue_date_text": "August 23,2023", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "Certificate of Inspection", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7656061", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7811869", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "7864845", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "8086152", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2027-12-27", "expiry_date_text": "December 27,2027", "issue_date": "2023-03-24T00:00:00-04:00", "issue_date_text": "March 24,2023", "number": "8288344", "organization": "USCG", "status": "Issued/Effective" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2022-05-03", "expiry_date_text": "May 3,2022", "issue_date": "2021-05-03T00:00:00-04:00", "issue_date_text": "May 3,2021", "number": "N/A", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2025-08-11", "expiry_date_text": "August 11,2025", "issue_date": "2020-06-26T00:00:00-04:00", "issue_date_text": "June 26,2020", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "6887129", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "7656061", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2025-01-15", "expiry_date_text": "January 15,2025", "issue_date": "2020-01-15T00:00:00-05:00", "issue_date_text": "January 15,2020", "number": "7626753", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2023-09-04", "expiry_date_text": "September 4,2023", "issue_date": "2018-08-07T00:00:00-04:00", "issue_date_text": "August 7,2018", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2018-09-30", "expiry_date_text": "September 30,2018", "issue_date": "2017-09-30T00:00:00-04:00", "issue_date_text": "September 30,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "Classification Document", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Load Line Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "ABS", "status": "EXPIRED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2022-12-19", "expiry_date_text": "December 19,2022", "issue_date": "2017-09-19T00:00:00-04:00", "issue_date_text": "September 19,2017", "number": "N/A", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2020-08-11", "expiry_date_text": "August 11,2020", "issue_date": "2017-01-12T00:00:00-05:00", "issue_date_text": "January 12,2017", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Certificate of Inspection", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T14:40:38-04:00", "issue_date_text": "March 18,2015", "number": "5074916", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T14:40:38-04:00", "issue_date_text": "March 18,2015", "number": "5074916", "organization": "N/A", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "5761817", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "5794888", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6078248", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6234933", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6339483", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Certificate of Inspection - Amended", "expiry_date": "2020-03-18", "expiry_date_text": "March 18,2020", "issue_date": "2015-03-18T00:00:00-04:00", "issue_date_text": "March 18,2015", "number": "6678663", "organization": "USCG", "status": "EXPIRED" }, { "document_type": "Tonnage Certificate, International", "expiry_date": null, "expiry_date_text": null, "issue_date": "2015-01-14T00:00:00-05:00", "issue_date_text": "January 14,2015", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2014-01-21T00:00:00-05:00", "issue_date_text": "January 21,2014", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-06-07T00:00:00-04:00", "issue_date_text": "June 7,2013", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-06-07T00:00:00-04:00", "issue_date_text": "June 7,2013", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Load Line Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2013-05-09T00:00:00-04:00", "issue_date_text": "May 9,2013", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Classification Document", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-19T00:00:00-05:00", "issue_date_text": "December 19,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": null, "expiry_date_text": null, "issue_date": "2012-12-04T00:00:00-05:00", "issue_date_text": "December 4,2012", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2017-12-19", "expiry_date_text": "December 19,2017", "issue_date": "2012-10-08T00:00:00-04:00", "issue_date_text": "October 8,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Minimum Safe Manning Document", "expiry_date": null, "expiry_date_text": null, "issue_date": "2012-10-03T00:00:00-04:00", "issue_date_text": "October 3,2012", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "International Air Pollution Prevention Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2010-11-15T00:00:00-05:00", "issue_date_text": "November 15,2010", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Document Of Compliance", "expiry_date": "2013-11-25", "expiry_date_text": "November 25,2013", "issue_date": "2009-12-15T00:00:00-05:00", "issue_date_text": "December 15,2009", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Equipment Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-11-04T00:00:00-05:00", "issue_date_text": "November 4,2009", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "ISM - Safety Management Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-03-31T00:00:00-04:00", "issue_date_text": "March 31,2009", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Classification Document", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2009-03-26T00:00:00-04:00", "issue_date_text": "March 26,2009", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "International Load Line Certificate", "expiry_date": null, "expiry_date_text": null, "issue_date": "2009-01-23T00:00:00-05:00", "issue_date_text": "January 23,2009", "number": "N/A", "organization": "ABS", "status": "VALID" }, { "document_type": "International Oil Pollution Prevention Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Construction Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "SOLAS Cargo Ship Safety Radio Certificate", "expiry_date": "2012-12-19", "expiry_date_text": "December 19,2012", "issue_date": "2008-12-14T00:00:00-05:00", "issue_date_text": "December 14,2008", "number": "N/A", "organization": "ABS", "status": "DEACTIVATED" }, { "document_type": "Minimum Safe Manning Document", "expiry_date": null, "expiry_date_text": null, "issue_date": "2007-11-08T00:00:00-05:00", "issue_date_text": "November 8,2007", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" }, { "document_type": "Tonnage Certificate, International", "expiry_date": null, "expiry_date_text": null, "issue_date": "2007-10-25T00:00:00-04:00", "issue_date_text": "October 25,2007", "number": "N/A", "organization": "N/A", "status": "DEACTIVATED" } ], "flag": "UNITED STATES", "hin": null, "identification": "1257726", "identification_type": "Official Number (U.S.)", "manufacturer_hull_number": "166", "publication_id": "7853c969d17979b547e4d2fc0ec1ff8c8bce8c5a8d394adcd4c8341d3441cb7e", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_subtype": "General Cargo/Container", "service_type": "Freight Ship", "source_record_id": "psix:1097015", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselParticularsXMLString", "status": "Active", "tonnage": [ { "measure_of_weight": 44243, "tonnage_type": "Convention (Subpart B)", "unit_of_measure": "Short Ton" }, { "measure_of_weight": 111460, "tonnage_type": "Displacement", "unit_of_measure": "Ton" }, { "measure_of_weight": 74642, "tonnage_type": "Convention (Subpart B)", "unit_of_measure": "Long Ton" } ], "vessel_id": 1097015, "vessel_name": "MAERSK KENSINGTON" }, "retrieved_at": "2026-10-25T03:57:24Z" } ``` ### Records list - Capability: `maritime-safety/records_list` - Description: Every vessel of one segment (getVesselSummary with Flag and Service, plus BuildYear when given), sorted by VesselId and paged by offset (page_size default 1000, max 5000). Each page re-fetches the segment and compares the SHA-256 of its sorted VesselId list with the one pinned in the cursor; a mismatch fails with invalid_input issue code publication_changed. A segment over the 32 MiB response cap fails with segment_too_large: split it by build_year. Records are summary rows; records_get returns particulars, dimensions, tonnage, documents and cases. - Instructions: Collecting the PSIX vessel register segment by segment. Iterate flags and service types (Recreational skipped by default, see README); for UNITED STATES add build_year. - Cost: 5 credits per call - Capability file: [Records list](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/records_list) Accepted options: - `build_year` (number): Construction completed year; needed to split large US segments under the 32 MiB response cap. Example: `1800` - `cursor` (string): next_cursor of the previous page; carries the segment, so flag and service may be omitted with it. Example: `` - `flag` (string): Flag state as PSIX spells CountryLookupName (case-insensitive), e.g. UNITED STATES, PANAMA, MARSHALL ISLANDS. Example: `` - `page_size` (number): Records per page (default 1000). Example: `10` - `service` (string): Service type, exact PSIX spelling (case-insensitive), e.g. Freight Ship, Tank Ship, Towing Vessel, Passenger (Inspected), Commercial Fishing Vessel. Example: `` Response schema example: ```json { "next_cursor": null, "observed_at_ms": 1792901411928, "offset": 0, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "published_at": null, "records": [ { "call_sign": "WGAH", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "1207300", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:932890", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 932890, "vessel_name": "ALLIANCE NORFOLK" }, { "call_sign": "KMTM", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "1368875", "manufacturer_hull_number": "SB355-6", "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:932983", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 932983, "vessel_name": "MONTAUK" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": "DNAZB053L607", "identification": "1228320", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1079278", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1079278, "vessel_name": "DREAM WEAVER" }, { "call_sign": "WMKN", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "1257726", "manufacturer_hull_number": "166", "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1097015", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1097015, "vessel_name": "MAERSK KENSINGTON" }, { "call_sign": "WMHA", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "1245605", "manufacturer_hull_number": "165", "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1101124", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1101124, "vessel_name": "MAERSK HARTFORD" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "WN1645NU", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1189321", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1189321, "vessel_name": "WN1645NU" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": "JBC65074C707", "identification": "LA2684FS", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1221934", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1221934, "vessel_name": "LA2684FS" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": "RGMDM719F708", "identification": "FL8307NN", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1248986", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1248986, "vessel_name": "FL8307NN" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "NC6331DF", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1302805", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1302805, "vessel_name": "NC6631DF" }, { "call_sign": "N/A", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "DL7629AE", "manufacturer_hull_number": null, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1349448", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1349448, "vessel_name": "DL7629AE" } ], "retrieved_at": "2026-10-25T03:57:24Z", "returned": 10, "segment": { "build_year": 2007, "flag": "UNITED STATES", "service": "Freight Ship" }, "segment_record_count": 10, "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString" } ``` ### Search - Capability: `maritime-safety/search` - Description: Vessels by name (case-insensitive substring), call sign, identification (IMO number or US official number, sent as VIN) or HIN, optionally narrowed by flag, service and build_year; at least one of name, call_sign, identification or hin is required. Exact name matches first, then by name; returns the first limit (default 50, max 500) and the total. - Instructions: Finding a vessel's psix: id from its name, call sign or IMO number. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/search) Accepted options: - `build_year` (number): Construction completed year; needed to split large US segments under the 32 MiB response cap. Example: `1800` - `call_sign` (string): call_sign Example: `` - `flag` (string): Flag state as PSIX spells CountryLookupName (case-insensitive), e.g. UNITED STATES, PANAMA, MARSHALL ISLANDS. Example: `` - `hin` (string): Hull identification number. Example: `` - `identification` (string): IMO number (foreign ships) or US official number. Example: `` - `limit` (number): Results to return (default 50). Example: `10` - `name` (string): Vessel name or part of it. Example: `` - `service` (string): Service type, exact PSIX spelling (case-insensitive), e.g. Freight Ship, Tank Ship, Towing Vessel, Passenger (Inspected), Commercial Fishing Vessel. Example: `` Response schema example: ```json { "observed_at_ms": 1792901411951, "publication_id": "044ed14e1e9903923c216c700f6f82c33096b08792a027b4e43fd67df5e85d61", "query": { "build_year": null, "call_sign": null, "flag": null, "hin": null, "identification": null, "name": "MAERSK KENSINGTON", "service": null }, "results": [ { "call_sign": "WMKN", "construction_completed_year": 2007, "detail": "summary", "flag": "UNITED STATES", "hin": null, "identification": "1257726", "manufacturer_hull_number": "166", "publication_id": "044ed14e1e9903923c216c700f6f82c33096b08792a027b4e43fd67df5e85d61", "record_type": "vessel", "retrieved_at": "2026-10-25T03:57:24Z", "service_type": "Freight Ship", "source_record_id": "psix:1097015", "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "status": "Active", "vessel_id": 1097015, "vessel_name": "MAERSK KENSINGTON" } ], "retrieved_at": "2026-10-25T03:57:24Z", "returned": 1, "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "total": 1, "truncated": false } ``` ### Source status - Capability: `maritime-safety/source_status` - Description: Cheap version check. PSIX publishes no version, date or hash, so this hashes one getVesselSummary segment: by default the fixed canary segment UNITED STATES / Freight Ship / 2007; any flag, service and build_year segment on request. Returns the SHA-256 of the sorted VesselId list (the value a records_list cursor pins, as publication_id), a SHA-256 of the canonical summary rows (content_hash) and the record count. An empty canary segment is upstream_unavailable. - Instructions: Before a records_list run of a segment, or on a schedule, to see whether a segment's membership or content moved. - Cost: 5 credits per call - Capability file: [Source status](https://firecrawl.dev/alexandria/agents/providers/cgmix-uscg-mil/maritime-safety/source_status) Accepted options: - `build_year` (number): Construction completed year; needed to split large US segments under the 32 MiB response cap. Example: `1800` - `flag` (string): Flag state as PSIX spells CountryLookupName (case-insensitive), e.g. UNITED STATES, PANAMA, MARSHALL ISLANDS. Example: `` - `service` (string): Service type, exact PSIX spelling (case-insensitive), e.g. Freight Ship, Tank Ship, Towing Vessel, Passenger (Inspected), Commercial Fishing Vessel. Example: `` Response schema example: ```json { "canary_segment": true, "content_hash": "18d0dd3ca31cd62a0bb8369a62987f530d22cae2c88443c00e16fc1ccbf9e335", "content_hash_algorithm": "sha256 of the sorted canonical summary rows (fields sorted, name=value, tab separated)", "endpoint_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx", "file_urls": [], "observed_at_ms": 1792901411927, "publication_id": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "publication_signal": "none", "published_at": null, "publisher_hash": null, "record_count": 10, "retrieved_at": "2026-10-25T03:57:24Z", "segment": { "build_year": 2007, "flag": "UNITED STATES", "service": "Freight Ship" }, "segment_hash_algorithm": "sha256 of the sorted VesselId list, one id per line (what a records_list cursor pins)", "segment_sha256": "88cd9713813c3cfa8c4f40306b90d8970f10e6f0d69c494480faa26563e202d6", "size_bytes": 6075, "source_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?op=getVesselSummaryXMLString", "wsdl_url": "https://cgmix.uscg.mil/xml/PSIXData.asmx?WSDL" } ```