# AITaxAdvise API v1.0

> Multi-jurisdiction AI tax information with specialist expert agents.
> 16 jurisdictions. 5 languages. Full OCSF audit trail.
> NOT tax advice. Tax INFORMATION for research purposes only.

## Authentication

Bearer token: `Authorization: Bearer atx_YOUR_API_KEY`
Get a key: https://aitaxadvise.com/dashboard/integrations (requires organisation account)

## Payment Model

Credit-based. Each consultation costs 1 credit.
- Credits available: 200 OK with report
- No credits: 402 with `requestTopup` endpoint
- Agent calls POST /api/a2a/billing/request-topup to email account owner
- Owner adds credits at /dashboard/billing
- Agent retries consultation

## Endpoints

### Discovery
GET /api/a2a
  Returns agent card: capabilities, endpoints, auth, billing

### Tax Consultation (1 credit)
POST /api/a2a/consult
  Body: { query: string, jurisdiction?: string, language?: string }
  Returns: { status, advice, experts, domains, jurisdictions, processingTime }
  Rate limit: 60/min

### Fact-Check (1 credit)
POST /api/a2a/verify
  Body: { claim: string, jurisdiction?: string }
  Returns: { status, claim, verification, experts, jurisdiction }

### Reference Data (free)
GET /api/a2a/rates
  Returns current UK tax rates and thresholds from live knowledge base

### Balance (free)
GET /api/a2a/balance
  Returns credit balance, plan, usage

### Billing
POST /api/a2a/billing/request-topup
  Body: { reason?: string }
  Emails account owner with "Add Credits" link

## Rate Limits

60 requests per minute per API key

## Jurisdictions

UK, US, UAE, Singapore, Ireland, Malta, France, Germany, Italy, Spain,
Portugal, Cyprus, Netherlands, Jersey, Guernsey, Isle of Man

## Languages

en, fr, de, it, es

## Disclaimer

Tax information only. Not regulated tax advice. Always consult a qualified tax professional.
AITaxAdvise is a division of Tyga.Cloud Ltd (UK #14643275).