Home/ Marketplace/ Royal Mail/ Prices API
Royal Mail
API

Shipping Data API

Royal Mail Prices API

Every Royal Mail price as clean JSON. UK Click & Drop services and International Tracked zones — every format, every weight band, VAT broken out — behind one API key. Stop copying prices out of PDFs; pull them into your checkout, invoicing or dashboards instead.

Free Trial
£6.99
per month after 1 month free trial
Start Free Trial
📡 Product: JSON REST API 📦 UK Click & Drop + International Tracked 🔑 Your own API key 📱 Full support included ❌ Cancel anytime

What You Get

One Bearer-key API serving the full Royal Mail tariff as structured JSON. Pull the whole price matrix once a day and compute prices locally, or request a live quote per shipment — the same API that powers our WooCommerce Royal Mail rates plugin at real checkouts.

  • All 19 UK Click & Drop services — 1st & 2nd Class, Signed For, Tracked 24/48, Special Delivery Guaranteed by 1pm, and Parcelforce express10/24/48/AM (including "with Signature" variants)
  • Every format from Letter to Large Parcel, with the full weight-band table per service
  • VAT broken out on every UK price
  • Royal Mail International Tracked for all six zones (Europe 1–3, World 1–3)
  • Country → zone map covering 85+ destinations, including suspended-destination flags
  • Single-shipment quote endpoints — send a service, weight and format, get the price back
  • Versioned matrix responses so your cache knows exactly when prices change
  • Simple Bearer-token auth — works from any language or platform in one line

How It Works

1
Subscribe & Get Your KeyStart your free month and we'll set up your personal API key and email it to you with the documentation — usually within a few hours.
2
Pull Prices as JSONOne GET returns the complete price matrix — cache it and compute prices locally with zero latency, or call the quote endpoint per shipment.
3
Stay Current AutomaticallyWhen Royal Mail changes the tariff, the API reflects it and the matrix version hash changes — your integration knows exactly when to re-sync. No re-keying prices every April.

See It in Action

Price a 750g small parcel on Tracked 24 — one request, one JSON answer:

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://www.receptivemedia.co.uk/shipping/rates/api.php?action=uk_quote&service=TOLP24&weight_g=750"

Response

{
  "success": true,
  "service": "Tracked 24",
  "service_code": "TOLP24",
  "format": "SmallParcel",
  "weight_g": 750,
  "band_from_g": 501,
  "band_to_g": 750,
  "price": 4.65,
  "vat": 0.77,
  "currency": "GBP"
}

Four Endpoints, No Surprises

GETuk_matrix

The complete UK Click & Drop tariff — every service, format and weight band with VAT, plus a version hash for cache invalidation.

POSTuk_quote

Price one UK shipment. Send a service code or name, weight in grams and an optional format — get the matching band and price back.

GETmatrix

The full International Tracked matrix — six zones × formats × weight bands, plus the country→zone map for 85+ destinations.

POSTquote

Price one international shipment from a destination country and weight — zone lookup, suspension checks and band matching handled for you.

What Would You Build?

🛒

Checkout Pricing

Show customers accurate Royal Mail delivery prices at checkout, computed locally from the cached matrix with zero added latency.

🧾

Postage Recharging

Invoice clients the exact published postage for what you send — no more looking prices up by hand or working from stale rate cards.

📊

Ops & Dashboards

Feed ERPs, order systems and internal tools. Compare services when choosing dispatch, audit postage spend, model price changes.

Frequently Asked Questions

How much does this cost?

Your first month is free. After that, the service costs £6.99 per month — one flat price for the full UK and International datasets, however you use them.

How do I get my API key?

Subscribe and we'll set up your personal API key and email it to you with the documentation — usually within a few hours, and always within one working day. Your free month doesn't start ticking until your key is in your hands.

Exactly what data is included?

Two datasets, both included in the one price:

  • UK Click & Drop — all 19 services: Royal Mail 1st & 2nd Class, Signed For, Tracked 24 & 48 (with Signature variants), Special Delivery Guaranteed by 1pm, and Parcelforce express10, express24, express48, expressAM and express48large (with Signature variants). Every format from Letter to Large Parcel, every weight band up to 30kg, with VAT broken out on each price.
  • Royal Mail International Tracked — all six zones (Europe Zones 1–3, World Zones 1–3) across Large Letter, Small Parcel and Medium Parcel formats, plus a country→zone map covering 85+ destinations with suspended-destination flags.
How up to date are the prices?

The API serves the same dataset that powers our public Royal Mail prices page and our live WooCommerce rates plugin. It tracks Royal Mail's published tariff — Royal Mail typically reprices each April, and any change flows straight through to the API. Every matrix response carries a version hash and a freshness timestamp, so your integration can tell at a glance whether anything changed.

Are there rate limits?

Fair use, no hard metering. The matrix endpoints are designed to be fetched once a day and cached — that's one request per day for most integrations, with prices computed locally on your side. The quote endpoints are there for live lookups and self-tests. If your use case needs sustained high-volume quoting, tell us and we'll make sure you're on the right setup.

Is this an official Royal Mail product?

No. This is an independent developer tool from Receptive Ltd. The prices served are Royal Mail's published guide prices for Click & Drop and International Tracked services. Royal Mail is a trademark of Royal Mail Group Ltd; we are not affiliated with or endorsed by Royal Mail. Always confirm the final price in your own Royal Mail account when purchasing postage.

Can I use it to show delivery prices in my checkout?

Yes — that's the primary use case. The recommended pattern is the one our own WooCommerce plugin uses: sync the matrix daily, store it locally, and compute the price at checkout from your cache. Your checkout never depends on our endpoint being up, and customers see accurate prices instantly.

I don't want to write code — can you integrate it for me?

Yes. We build and run Royal Mail integrations for Wix, WooCommerce, Squarespace, Square, Magento and more — see the Royal Mail marketplace, or get in touch with a custom request.

Can I cancel my subscription?

You can cancel your subscription at any time by giving 30 days' notice. Your API key stops working when the subscription ends.

Who are we?

We are a small development company with offices in Cardiff and Cheltenham, UK. Our registered company name is Receptive Ltd, led by Ben Johnson, who has over 20 years of experience in web development and eCommerce.

Related Products

Free Trial
£6.99
per month after 1 month free trial
Start Free Trial
📡 Product: JSON REST API 📦 UK Click & Drop + International Tracked 🔑 Your own API key 📱 Full support included ❌ Cancel anytime

Questions before you start?

Get in touch and we'll get back to you within 24 hours.

Contact Us
WordPress Figma Framer Wix Contentful