The official Datalastic Postman Collection for the Datalastic Maritime API. Import it to start querying live AIS vessel positions, vessel history, port data, sea routes, and add-on intelligence datasets in under two minutes.
38 requests across 8 folders.
-
Download both files:
-
In Postman: Import, then drag and drop both files at once
-
Select Datalastic Maritime API from the environment dropdown (top right)
-
Click the environment name, set your
api_key, then save -
Run 💰 Usage & Credits > Check Credit Balance to confirm everything works
In Postman: Import > Link and paste:
https://raw.githubusercontent.com/datalastic/datalastic-postman/main/Datalastic_Maritime_API.postman_collection.json
Then repeat for the environment file:
https://raw.githubusercontent.com/datalastic/datalastic-postman/main/Datalastic_Environment.postman_environment.json
Get your API key at datalastic.com/pricing
| Request | Credits |
|---|---|
| Check Credit Balance | Free |
Start here. Confirms your key is working and shows how many credits you have left this month.
| Request | Credits |
|---|---|
| Vessel Position - Basic | 1 per vessel |
| Vessel Position - Pro | 1 per vessel |
| ➕ Vessel Position - SAT-E | 1 per vessel |
| Vessel Position - Bulk | 1 per vessel found |
| Vessels in Area - by Port | 1 per vessel, max 500 |
| Vessels in Area - by Coordinates | 1 per vessel, max 500 |
| Vessels in Area - Filter by Type | 1 per vessel, max 500 |
Real-time AIS positions. Basic returns position, speed, heading, and destination. Pro adds ETA, ATD, and current draught. SAT-E (add-on) adds an AI-calculated position for vessels currently outside terrestrial AIS range. Bulk handles up to 100 MMSIs or IMOs in one call.
| Request | Credits |
|---|---|
| Vessel History - Last N Days | 1 per vessel-day |
| Vessel History - Date Range | 1 per vessel-day |
Past AIS positions for a single vessel. Use days for a rolling window or from/to for a fixed date range. A 7-day query costs 7 credits.
| Request | Credits |
|---|---|
| Vessel Info | 1 per vessel |
| Vessel Finder | 1 per vessel returned |
| ➕ Dry Dock Dates | add-on |
| ➕ Vessel Ownership | add-on |
| ➕ Ship Casualties | add-on |
| ➕ Ship Inspections (PSC) | add-on |
| ➕ Ship Sales, Purchase & Demolitions | add-on |
| ➕ Classification Society | add-on |
| ➕ Vessel Engine | add-on |
Vessel Info returns static specs: dimensions, tonnage, TEU capacity, call sign, home port, and year built. Vessel Finder searches the registry by name, flag, or type, with optional fuzzy matching. The add-on endpoints (marked ➕) require an Add-Ons plan.
| Request | Credits |
|---|---|
| Port Finder - by UNLOCODE | 1 per port returned |
| Port Finder - by Name | 1 per port returned |
| Port Terminals | 1 per query |
| ➕ Sea Route | 1 per query |
Look up ports by UN/LOCODE or name. Port Terminals returns all terminals within a port. Sea Route (add-on) calculates the optimal navigable route between two points - use a UN/LOCODE or lat/lon at either end.
| Request | Credits |
|---|---|
| ➕ Maritime Companies | add-on |
Company profiles with type, country, status (Active/Inactive), contact details, and parent company. Search by company IMO or name.
Async bulk exports. Submit a job, poll until done, download the CSV.
| Request | Credits |
|---|---|
| Submit - Historical Location Traffic | Per vessel-day found |
| Submit - Vessel List | 5,000 |
| Submit - Port List | 500 |
| Submit - API Usage Log | Free |
| Poll Report Status | Free |
| List All Reports | Free |
Submitting any report saves the report_id into {{last_report_id}} automatically. Poll Report Status picks it up from there with no copy-pasting. When the job finishes, the download URL is saved to {{last_report_url}}.
Bulk CSV exports for all add-on datasets. Same async workflow as above. Use updated_from (yyyy-mm-dd) to pull only records changed since a given date.
| Request | report_type |
|---|---|
| Add-On Report - Dry Dock Dates | dry_dock_dates |
| Add-On Report - Vessel Ownership | ownership |
| Add-On Report - Ship Casualties | casualty |
| Add-On Report - Ship Inspections (PSC) | inspections |
| Add-On Report - Sales, Purchase & Demolitions | sales_purchase_demolitions |
| Add-On Report - Classification Society | class_society |
| Add-On Report - Vessel Engine | engine |
| Add-On Report - Maritime Companies | companies |
Credit monitoring. Every request reads the X-Requestlimit-Remaining response header and logs it to the Postman Console:
Credits remaining: 67570 / 80000
The values are also stored in {{credits_remaining}} and {{credits_limit}} for use in scripts.
Open the console with View > Show Postman Console (Ctrl+Alt+C on Windows, Cmd+Alt+C on Mac).
Report ID capture. After submitting any report job, the report_id from the response is saved to {{last_report_id}}. Poll Report Status uses this variable automatically.
| Endpoint | Cost |
|---|---|
/vessel, /vessel_pro, /vessel_pro_est |
1 per vessel found |
/vessel_bulk |
1 per vessel found |
/vessel_inradius |
1 per vessel found, max 500 per call |
/vessel_history |
1 per vessel-day |
/vessel_info, /vessel_find |
1 per vessel found/returned |
/port_find |
1 per port returned |
/port, /ext/route |
1 per query |
/stat, report polling |
Free |
Report: vessel_list |
5,000 flat |
Report: port_list |
500 flat |
Report: request_usage |
Free |
| Add-on endpoints | See pricing page |
- Postman v10 or later
- A Datalastic API key (get one at datalastic.com/pricing)
- datalastic/datalastic-openapi - OpenAPI 3.0 spec for Insomnia, SDK generation, and Mintlify
- Datalastic API Reference