Parcel2Go Shipping API
The Parcel2Go shipping API is ideal for implementing delivery solutions for any kind of website - online retailers, mail order businesses and marketplaces. Authentication is OAuth2, conforming to OpenID Connect.
- Quoting - compare live prices across our courier network
- Orders - create, verify and track shipments
- Payments - PrePay, PayPal, card, or deeplink the customer into our checkout
- Labels - A4, 4x6 and picking lists, as PDF or PNG
- Tracking - normalised tracking stages, with webhooks for updates
- Drop shops - geolocation search for drop-off points
- International - customs data, tariff codes and advanced address rules
Get started
- Create API credentials in My Account → API, or in the sandbox portal if you are testing.
- Exchange them for an access token.
- Send that token as a bearer header on every API call.
POST /auth/connect/token HTTP/1.1
Host: sandbox.parcel2go.com
Content-Type: application/x-www-form-urlencoded
grant_type=client_credentials
&scope=public-api
&client_id=<client_id>
&client_secret=<client_secret>
The quickstart walks through the whole path from credentials to your first quote.
Guides
| Guide | What it covers |
|---|---|
| Quickstart | Get a token, request your first quote |
| Authentication | Client credentials, implicit flow, scopes, token expiry |
| Orders | The end-to-end order flow, creating orders, adding extras |
| Making a Payment | PrePay, PayPal, credit or debit card, and deeplink |
| Customs | International shipments, VAT status, tariff codes, EORI |
| Extras | Parcel protection, delivery text messages, signatures |
| Links Object | The URLs returned with an order - labels, tracking, payment |
| Country Subdivisions | Subdivision codes for islands and special areas |
| Webhooks | Event payloads, verifying signatures, securing your endpoint |
| Environments | Sandbox and live URLs, and how the two differ |
| Terms and Conditions | The API licence terms |
Endpoint reference
The interactive Swagger documentation is the complete reference - every endpoint, with request and response models and example payloads.
Environments
| Environment | Base URL |
|---|---|
| Sandbox | https://sandbox.parcel2go.com |
| Live | https://www.parcel2go.com |
API paths sit under /api and authentication under /auth on both. See Environments for the full list of URLs, and for the ways sandbox behaviour can differ from live.
Note
Credentials are not shared between environments. Generate a separate client id and secret in the sandbox portal, and send sandbox token requests to the sandbox host.
Help
Email apihelp@parcel2go.com.