Developer

API Access Conditions

Version 1.0 · May 2026 · Internal / Partner Access

The Jeddah Ports API is currently in restricted access. It is available to approved partners, developers, and research institutions. Contact us to request access.

Available Endpoints

The following REST API endpoints are available to authorized clients:

GET

/v1/vessels

List vessels at Jeddah port with optional filters: status, limit, page, etaDays, etaFrom, etaTo

GET

/v1/vessels/:imo

Get full details for a specific vessel by IMO number

GET

/v1/schedule

Port call schedule by date range: port, from, to, type (arrivals/departures/both)

GET

/v1/carriers

List shipping lines calling Jeddah with fleet and service data

GET

/v1/services

Shipping services (liner rotations) calling Jeddah port

GET

/v1/news

Maritime intelligence news: limit, page, days, category

GET

/v1/ports/SAJED

Port of Jeddah summary statistics and vessel counts by status

Rate Limits

Public

Direct API access is not publicly available. Use the dashboard.

Partner

500/hr

Approved partners and logistics platforms. Apply via contact form.

Research

100/hr

Academic and research institutions. Requires institutional email.

Authentication

Approved API clients receive a bearer token for authentication. Include it in all requests:

Authorization: Bearer YOUR_API_TOKEN

Tokens are tied to your registered domain and IP range. Do not share your token or commit it to public repositories.

Data Format

All endpoints return JSON with standard HTTP status codes. Date/time fields are in ISO 8601 format (UTC). Times can be displayed in any timezone client-side — the API always returns UTC.

Data Accuracy: API data is aggregated from AIS networks and third-party sources. It may be delayed by up to 15 minutes. Do not use for navigation, collision avoidance, or safety-critical operations.

Permitted Uses

Building logistics and supply chain dashboards
Port call planning and schedule monitoring
Academic research on maritime trade and port operations
Internal business intelligence tools
Integration with cargo and freight management systems

Prohibited Uses

Reselling or redistributing raw API data to third parties
Creating a competing maritime intelligence product without written agreement
Navigation or safety-critical maritime operations
Exceeding rate limits through multiple accounts or proxies
Any use that violates applicable Saudi or international law

SLA & Uptime

We target 99% monthly uptime for the API. Scheduled maintenance windows are announced at least 24 hours in advance. No SLA is guaranteed for free or research tier access.

Data Freshness

Data is refreshed on the following schedules:

Vessel positions & status: Every 15 minutes
Port call schedule: Every 15 minutes (RSGT scrape)
Maritime news: Every 30 minutes
Carrier & service data: Updated manually as needed

Request API Access

Tell us about your use case and we'll review your request within 5 business days. Partner integrations are free for qualifying logistics and research partners.

Apply for Access →