Royal Mail

name: Royal Mail
description: Royal Mail provides a suite of REST APIs for businesses to integrate shipping, tracking, label generation, barcode allocation, and Click & Drop order management directly into their fulfilment systems. APIs cover domestic and international shipment creation, label printing, manifest submission, pre-allocated tracking numbers, offline barcode ranges, local collect options, and delivery office lookup.
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/royal-mail/refs/heads/main/apis.yml
version: "0.19"
created: "2026-06-13"
modified: "2026-06-13"
specificationVersion: "0.19"

tags:
  - Shipping
  - Postal Services
  - Labels
  - Tracking
  - Logistics
  - Barcodes
  - Click and Drop
  - UK

apis:

  - name: Royal Mail API Shipping V2 (REST)
    description: A fully RESTful service enabling account customers to create domestic and international shipments, produce shipping labels, print customs documents, manifest shipments, pre-allocate tracking numbers, and request offline barcode ranges. Requires an Online Business Account (OBA).
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://developer.royalmail.net/taxonomy/term/91
    baseURL: https://api.royalmail.net/shipping/v2
    tags:
      - Shipping
      - Labels
      - Manifests
      - Barcodes
      - International
    properties:
      - type: Documentation
        url: https://developer.royalmail.net/taxonomy/term/91
      - type: Authentication
        url: https://developer.royalmail.net/start
    contact:
      - FN: Royal Mail API Support
        url: https://developer.royalmail.net/help
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-api-shipping-v2-rest

  - name: Royal Mail Click & Drop API
    description: REST API for Click & Drop and ChannelShipper customers to import orders, retrieve order details, generate PDF shipping labels, manifest eligible orders, and create return shipments. Supports up to 2,000 orders per request and up to 5 API calls per second.
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://help.parcel.royalmail.com/hc/en-gb/articles/360011462338-Integrating-with-the-Click-Drop-API
    baseURL: https://api.parcel.royalmail.com/api/v1
    tags:
      - Click and Drop
      - Orders
      - Labels
      - Manifests
      - Returns
    properties:
      - type: Documentation
        url: https://api.parcel.royalmail.com/doc/v1/click-and-drop-api-v1.yaml
      - type: OpenAPI
        url: https://api.parcel.royalmail.com/doc/v1/click-and-drop-api-v1.yaml
    contact:
      - FN: Royal Mail Click & Drop Support
        url: https://help.parcel.royalmail.com/hc/en-gb
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-click-drop-api

  - name: Royal Mail Tracking V2 (REST)
    description: Allows account customers to receive track-and-trace information for mail items, including current status, delivery history, and proof of delivery for single or multiple items. Intended for server-side application use.
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://developer.royalmail.net/product/175625/api/76888
    baseURL: https://api.royalmail.net
    tags:
      - Tracking
      - Delivery
      - Proof of Delivery
    properties:
      - type: Documentation
        url: https://developer.royalmail.net/product/175625/api/76888
      - type: Authentication
        url: https://developer.royalmail.net/start
    contact:
      - FN: Royal Mail API Support
        url: https://developer.royalmail.net/help
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-tracking-v2-rest

  - name: Royal Mail Barcode Allocation V1 (REST)
    description: A RESTful web service that enables API consumers to request a pre-allocated range of Royal Mail barcodes for offline use in shipping processes. No usage costs to customers; development costs are covered by the customer.
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://developer.royalmail.net/taxonomy/term/61
    baseURL: https://api.royalmail.net
    tags:
      - Barcodes
      - Offline
      - Shipping
    properties:
      - type: Documentation
        url: https://developer.royalmail.net/taxonomy/term/61
      - type: Authentication
        url: https://developer.royalmail.net/start
    contact:
      - FN: Royal Mail API Support
        url: https://developer.royalmail.net/help
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-barcode-allocation-v1-rest

  - name: Royal Mail Local Collect V3 (REST)
    description: Enables customers to benefit from Click and Collect delivery options by retrieving current lists of participating Post Offices and Royal Mail Customer Service Points where tracked and special delivery parcels can be collected. No usage costs to customers.
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://developer.royalmail.net/product
    baseURL: https://api.royalmail.net
    tags:
      - Local Collect
      - Click and Collect
      - Post Office
      - Locations
    properties:
      - type: Documentation
        url: https://developer.royalmail.net/product
      - type: Authentication
        url: https://developer.royalmail.net/start
    contact:
      - FN: Royal Mail API Support
        url: https://developer.royalmail.net/help
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-local-collect-v3-rest

  - name: Royal Mail Delivery Office Finder V1 (REST)
    description: Enables Royal Mail customers to obtain details of the delivery office dedicated to a provided postcode, including location name, address, available facilities, and opening hours.
    image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
    humanURL: https://developer.royalmail.net/product
    baseURL: https://api.royalmail.net
    tags:
      - Delivery Office
      - Locations
      - Postcode
    properties:
      - type: Documentation
        url: https://developer.royalmail.net/product
      - type: Authentication
        url: https://developer.royalmail.net/start
    contact:
      - FN: Royal Mail API Support
        url: https://developer.royalmail.net/help
        email: ""
    overlays: []
    aid: royal-mail:royal-mail-delivery-office-finder-v1-rest

common:

  - type: Portal
    url: https://developer.royalmail.net/

  - type: Documentation
    url: https://developer.royalmail.net/api

  - type: GettingStarted
    url: https://developer.royalmail.net/start

  - type: Support
    url: https://developer.royalmail.net/help

  - type: Plans
    url: https://developer.royalmail.net/product

  - type: RateLimits
    url: https://developer.royalmail.net/help

  - type: TermsOfService
    url: https://developer.royalmail.net/

  - type: Authentication
    url: https://developer.royalmail.net/start

  - type: Contact
    url: https://developer.royalmail.net/help

maintainers:
  - FN: Kin Lane
    email: [email protected]