API Reference

Build with TaxStats API

Integrate MTD ITSA capabilities into your applications. Process documents, calculate taxes, and submit to HMRC programmatically.

RESTful Design

Clean, predictable API following REST conventions

OAuth 2.0

Secure authentication with bearer tokens

JSON Responses

All responses in consistent JSON format

Rate Limiting

1000 requests per minute per API key

Getting Started

1. Get Your API Key

Generate an API key from your dashboard settings. Keep this secure and never expose it in client-side code.

2. Authenticate

Include your API key in the Authorization header of all requests.

Authentication Example
curl -X GET "https://api.taxstatsai.com/v1/documents" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Base URL

Production

https://api.taxstatsai.com/v1

API Endpoints

GET/api/v1/documents
POST/api/v1/documents
GET/api/v1/transactions
GET/api/v1/tax/summary
POST/api/v1/submissions
GET/api/v1/submissions/:id

Response Format

Success Response

{
  "success": true,
  "data": {
    "id": "doc_123456",
    "type": "receipt",
    "category": "office_supplies",
    "amount": 49.99,
    "date": "2024-12-15"
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

Error Response

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "The API key provided is invalid",
    "details": null
  },
  "meta": {
    "request_id": "req_xyz789"
  }
}

Rate Limits

Standard Plan

1,000 req/min

Professional Plan

5,000 req/min

Enterprise Plan

Custom limits

Rate limit headers are included in all API responses: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Ready to Integrate?

Get your API key and start building with TaxStats Source today.