# AI Parcels

> A free REST API for comparing real-time UK parcel shipping quotes from multiple carriers. No API key required for quotes. Built for AI agents, LLMs, and developers.

## What This Site Is

AI Parcels provides a single API endpoint that returns normalised shipping quotes from all major UK couriers — including Evri, DPD, Royal Mail, and international carriers like UPS and FedEx. Developers and AI agents use it to build parcel price comparison tools, automate shipping workflows, and book shipments programmatically.

## Key Capabilities

- **Get Shipping Quotes**: Compare real-time prices from 6+ UK carriers with a single GET request.
- **Find Dropshops**: Locate nearby drop-off lockers and stores by UK postcode.
- **Check Service Requirements**: Retrieve required fields (e.g. phone, customs info) for a specific courier.
- **Validate & Checkout**: Validate order details before booking; create a shipping order and receive a payment URL.

## API Base URL

https://api.ai.parcels.dotnethelp.co.uk

## Key Endpoints

- `GET /.api/quote/shipments/{origin}/{destination}` — Fetch quotes (weight in kg, dimensions in cm, postcode)
- `GET /.api/shops/geo/{country}/{postcode}` — Find nearby dropshops
- `GET /.api/services/{serviceSlug}/{origin}/{destination}/requirements` — Get service requirements
- `POST /.api/validate` — Validate checkout payload
- `POST /.api/checkout` — Create shipment order, returns paymentUrl

## Units

- Weight: kilograms (kg), float (e.g. `2.5`)
- Dimensions: centimetres (cm), integer
- Value/Price: Pence (GBP × 100), integer (e.g. £5.50 = `550`)
- Country: ISO 2-alpha code (e.g. `GB`, `US`)

## Authentication

No API key required for quote, dropshop, and requirements endpoints. Checkout and validate endpoints may require account details in the request body.

## AI Skill File

A machine-readable SKILL.md is available for AI agent frameworks (OpenClaw, Claude, ChatGPT custom actions):
https://ai.parcels.dotnethelp.co.uk/SKILL.md

## OpenAPI Specification

Full schema available at:
https://api.ai.parcels.dotnethelp.co.uk/doc.json

## Interactive Documentation

https://ai.parcels.dotnethelp.co.uk/api-reference

## Rates Calculator (Human-readable)

https://ai.parcels.dotnethelp.co.uk/rates

## AI Integration Guides

https://ai.parcels.dotnethelp.co.uk/ai-integrations

## Optional

- Help / FAQ: https://ai.parcels.dotnethelp.co.uk/help