DeliverAI API

Developer reference for the DeliverAI Public Dataset (free, CC-BY 4.0) and Pro Data feed (paid). All endpoints return JSON or CSV. CORS-open on free endpoints.

Free dataset →Per-courier rate cards →Pro Data API →Authentication →Rate limits →

Free Public Dataset

CC-BY 4.0. No authentication required. CORS-open. Refreshed 4× daily at 03:00, 09:00, 12:00, and 15:00 UTC.

GET/api/data/dataset.csv

Last 90 days of rate snapshots, CSV with provenance comment lines (# prefix).

Parameters

days — 1-365, default 90
courier — Filter to a single courier slug

curl 'https://deliverai.co.za/api/data/dataset.csv?days=30&courier=aramex'

GET/api/data/dataset.json

Same data wrapped with metadata. Recommended for programmatic consumption.

Parameters

days — 1-365, default 90
courier — Filter to a single courier slug

curl 'https://deliverai.co.za/api/data/dataset.json?days=7' | jq '.rows[0]'

GET/api/data/couriers.json

Directory of all couriers with status (live / coming-soon).

curl 'https://deliverai.co.za/api/data/couriers.json' | jq '.couriers[].slug'

GET/api/data/pricing-snapshot.json

Most recent snapshot per courier/corridor.

curl 'https://deliverai.co.za/api/data/pricing-snapshot.json'

Per-Courier Rate Cards

One JSON-LD Schema.org Dataset endpoint per courier. AI-crawler friendly. Free.

GET/api/couriers/{slug}/rate-card-latest.json

Latest rate card for a single courier. Includes Schema.org markup.

Parameters

slug — Courier slug — see list below

curl 'https://deliverai.co.za/api/couriers/aramex/rate-card-latest.json'

Available courier slugs (18):

aramexbob-gobolt-senddhl-expressdpd-laserdsvfastwayfedex-south-africaglobeflightinternet-expresspargopaxipostnetpudoramskynetthe-courier-guyuber-connect

DSV API integration is in progress; the slug returns row_count: 0 until live.

Pro Data API Paid · contact sales

Per-Subscriber bearer token. Hourly refresh. Includes corridor volumes, courier API health time series, click-through outcomes, coverage gaps, weight & urgency distribution.

GET/api/pro/corridorsAuth

Booking volumes by origin → destination corridor.

Parameters

start — ISO date, default 28 days ago
end — ISO date, default today
granularity — day | week, default week

curl -H 'Authorization: Bearer YOUR_KEY' 'https://deliverai.co.za/api/pro/corridors?granularity=day'

GET/api/pro/courier-healthAuth

API uptime, success rate, p95 response time per courier per day.

Parameters

courier — Optional courier slug filter
days — 1-90, default 30

curl -H 'Authorization: Bearer YOUR_KEY' 'https://deliverai.co.za/api/pro/courier-health?days=7'

GET/api/pro/click-outcomesAuth

Which courier customers actually pick after seeing comparison results.

Parameters

days — 1-90, default 30

curl -H 'Authorization: Bearer YOUR_KEY' 'https://deliverai.co.za/api/pro/click-outcomes'

GET/api/pro/coverage-gapsAuth

Heatmap of where couriers fail to quote (404, no-coverage).

Parameters

courier — Required courier slug

curl -H 'Authorization: Bearer YOUR_KEY' 'https://deliverai.co.za/api/pro/coverage-gaps?courier=aramex'

Need access?

Pro Data is R 2,499 / month VAT inclusive, EFT invoicing. Email hello@deliverai.co.za with your company name and use case. See /pro-data.

Authentication

Free endpoints require no authentication. Pro Data endpoints require a per-Subscriber bearer token in the Authorization header.

Authorization: Bearer dpd_live_xxxxxxxxxxxxxxxx

Token rotation: email us; new token issued within 1 business day. Tokens are tied to the legal entity on the invoice.

Rate Limits

Tier	Endpoint family	Limit
Free / anon	`/api/data/*`	60 req / IP / min
Free / anon	`/api/couriers/*`	60 req / IP / min
Pro	`/api/pro/*`	600 req / token / hour
Enterprise	`/api/pro/*`	Custom (set on quote)

When throttled you receive HTTP 429 with a Retry-After header.

Field Schema

Full field reference for the public dataset: /data

Status

Real-time status: coming Q3 2026. In the meantime email us if something looks broken.

Support

hello@deliverai.co.za · WhatsApp +27 65 286 1886 · Mon–Fri 08:00–17:00 SAST

Free dataset licence: /licence · Pro subscription terms: /terms/pro