Full API Reference

Complete API documentation for full programmatic control over your deliveries.

v1
Enterprise
REST

Base URL

All requests go to the production API.

text
https://api.send247.uk/v1

Authentication

All API requests require a secret API key passed in the Authorization header. Use your live key (sk_live_...) for production. Never expose API keys in client-side code.

text
Authorization: Bearer sk_live_your_api_key

Security

API keys are sensitive credentials. Store them in environment variables or a secrets manager. Use sk_test_... for sandbox testing.

Order/Delivery APIs

Common Headers

text
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json

Error Handling

401 Unauthorized

Invalid or revoked API key.

json
{
  "status": "error",
  "message": "Unauthorized"
}

4xx / 5xx Errors

json
{
  "status": "error",
  "message": "Error description"
}

Response Codes

CodeDescription
200Success
201Created
400Bad Request — Invalid parameters
401Unauthorized — Invalid or revoked API key
429Rate limited — Too many requests
500Server error — Contact support

Rate Limits & Conventions

  • Rate limit: 100 requests/second per API key (enterprise tiers available)
  • Dates: YYYY-MM-DD format
  • Timestamps: ISO 8601 format
  • Pagination: per_page=10, page=1 (default)
  • API versioning: v1 is stable; breaking changes will be versioned