The N84 FR8 API
The same dated records as the pages, as JSON. Every response states its sources, licence, basis and methods.
Checked 02:00 UTC, 16 Oct 2026.Get a free key
Keys are issued to a signed-in email address. If we know that address, a link is on its way. Then come back here, or open your account, to issue the key.
Endpoints
Base URL https://fr8.n84.dev. Send the key as a bearer token.
curl -H "Authorization: Bearer n84_fr8_..." https://fr8.n84.dev/v1/status
| Endpoint | Returns | Basis |
|---|---|---|
| GET /v1/status | Status tiles: fuel, road, rail, Freight Anatomy, air freighters. | mixed, per tile |
| GET /v1/fuel | Every fuel series with its latest value. | published |
| GET /v1/fuel/{series} | One fuel series: desnz-diesel, eia-diesel or eia-jet. | published |
| GET /v1/corridors | Road corridors with the latest week available. | observed, estimated |
| GET /v1/corridors/{ref} | Weekly HGV flow, norm and deviation, and planned rail paths. The ref carries a country prefix, for example gb-m6-j16-j19. | observed, estimated, published |
| GET /v1/anatomy/carriers | Carriers with their current surcharge count. | published |
| GET /v1/anatomy/carriers/{id} | Current surcharges, changes, band table and estimate. | published, estimated |
| GET /v1/anatomy/changes?since=YYYY-MM-DD | Surcharge changes across carriers. | published |
| GET /v1/anatomy/bands/{carrier} | Published band table and the band-step-v1 estimate. | published, estimated |
| GET /v1/freighters?from=&to= | Freighter legs from N84 AV8, in an ODbL object. Belly cargo on passenger flights is not included. | observed |
| GET /v1/sources | Sources, licences and check dates. | not applicable |
| GET /v1/usage | Calls used this month on your key. | not applicable |
Only public sources appear in responses. A source not yet public returns empty data with a reason in meta.withheld.
Response shape
Every response uses one envelope.
{
"data": { "series": { "id": "desnz-diesel", "unit": "pence per litre" },
"points": [ { "period_start": "2026-10-06", "value": 0 } ] },
"meta": {
"observed_at": "2026-10-14",
"licence": "OGL-UK-3.0",
"attribution": "Contains public sector information licensed under the Open Government Licence v3.0.",
"sources": [ { "id": "desnz-road-fuel", "name": "...", "url": "...", "licence": "OGL-UK-3.0", "checked_at": "..." } ],
"notice": "N84 FR8 is an independent data service. Not a freight forwarder, broker or carrier. Carrier, operator and official sources always prevail.",
"withheld": [],
"basis": { "value": "published" },
"methods": []
},
"error": null
}The value shown is a placeholder, not a figure. Basis is one of Observed Published Estimated and is named per field in meta.basis.
- flow-norm-v1: Corridor HGV norm from per-interval rates: for each week, HGV counted divided by the 15-minute intervals filled at qualifying site-days (at least 68 of 96 intervals), scaled to every corridor site for a full week. The norm is the mean of that figure for the same ISO week in the previous 3 years, using weeks with at least 70% of intervals filled and at least 3 sites qualifying (5 or more qualifying days). The deviation compares the week's figure with the norm and is given only when the week itself has at least 70% of intervals filled and at least 3 qualifying sites. A silent site lowers coverage, not the figure. Deviation is an estimate.
- band-step-v1: Next fuel surcharge step: the latest published fuel index applied to the carrier's published band table. The result is an estimate until the carrier publishes.
Limits
Each response carries X-Calls-Limit, X-Calls-Remaining and X-Calls-Reset headers. Over the limit, the API answers 429.
| Access | Price | Calls | History |
|---|---|---|---|
| No key (open layer) | Free | 30 a day per address | Latest value only |
| Free account | Free | 1,000 a month | 90 days |
| Pro | £149 a month | 1,000 a month | 730 days |
| Team | £449 a month | 10,000 a month | 730 days |
| Analyst | £695 a month | 100,000 a month | Full stored history |
| API 25,000 | £49 a month | 25,000 a month | Full stored history |
| API 250,000 | £199 a month | 250,000 a month | Full stored history |
| API 1,000,000 | £499 a month | 1,000,000 a month | Full stored history |
Derived endpoints (/v1/anatomy/bands/* and /v1/status) count as 5 calls each. No VAT is charged. See plans and access before you subscribe.