{"openapi":"3.1.0","info":{"title":"Indirect Tax Calculations API","version":"1.0.0","description":"EU OSS threshold place-of-supply, Canada GST/HST/PST, Australia/NZ GST registration, UK VAT flat rate and invoice requirements, UK MTD for Income Tax deadlines, and US use-tax accrual from caller rates — pure computation on vendored official tables. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/indirect-tax/eu-oss-threshold-check":{"post":{"operationId":"eu_oss_10_000_threshold_place_of_supply_check","summary":"EU OSS €10,000 threshold place-of-supply check","description":"Decide whether an EU-established supplier's B2C cross-border TBE services and distance sales stay taxed at home or switch to the customer's Member State under the EU-wide €10,000 threshold.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"supplierCountry":{"type":"string","minLength":2,"maxLength":2},"establishedInOtherMemberStates":{"type":"boolean"},"previousYearTotalEurCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"sales":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"customerCountry":{"type":"string","minLength":2,"maxLength":2},"kind":{"type":"string","enum":["tbe_service","distance_sale_goods"]},"netEurCents":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["date","customerCountry","kind","netEurCents"],"additionalProperties":false}},"optedForDestination":{"default":false,"type":"boolean"}},"required":["supplierCountry","establishedInOtherMemberStates","previousYearTotalEurCents","sales"],"additionalProperties":false},"example":{"supplierCountry":"DE","establishedInOtherMemberStates":false,"previousYearTotalEurCents":800000,"sales":[{"date":"2026-03-01","customerCountry":"FR","kind":"tbe_service","netEurCents":950000},{"date":"2026-05-10","customerCountry":"IT","kind":"tbe_service","netEurCents":60000}],"optedForDestination":false}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"threshold":{"type":"number"},"previousYearExceeded":{"type":"boolean"},"exceededOn":{"type":"object","properties":{"date":{"type":"string"},"saleIndex":{"type":"number"},"runningTotal":{"type":"number"}},"additionalProperties":true},"perSale":{"type":"array","items":{"type":"object","properties":{"index":{"type":"number"},"placeOfSupply":{"type":"string"}},"additionalProperties":true}},"ossRelevant":{"type":"boolean"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"threshold":1000000,"previousYearExceeded":false,"exceededOn":{"date":"2026-05-10","saleIndex":1,"runningTotal":1010000},"perSale":[{"index":0,"placeOfSupply":"DE"},{"index":1,"placeOfSupply":"IT"}],"ossRelevant":true,"sources":[{"source":"European Commission One Stop Shop — €10,000 EU-wide threshold for TBE and intra-Community distance sales","url":"https://vat-one-stop-shop.ec.europa.eu/one-stop-shop_en","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Threshold applies to B2C TBE services and intra-Community distance sales of goods for EU-established suppliers. Domesti…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/canada-gst-hst-pst":{"post":{"operationId":"canada_gst_hst_and_pst_rate_and_tax_amount","summary":"Canada GST/HST and PST rate and tax amount","description":"Look up GST/HST (and PST where the CRA table lists one) for a province and date, and compute tax on an amount in cents.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"province":{"type":"string","enum":["AB","BC","MB","NB","NL","NT","NS","NU","ON","QC","PE","SK","YT"]},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"amountCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"supply":{"default":"taxable","type":"string","enum":["taxable","zero_rated"]}},"required":["province","date","amountCents"],"additionalProperties":false},"example":{"province":"NS","date":"2026-11-14","amountCents":100000,"supply":"taxable"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"regime":{"type":"string"},"gstOrHstRate":{"type":"number"},"pstRate":{"type":"null"},"gstOrHstCents":{"type":"number"},"pstCents":{"type":"number"},"totalCents":{"type":"number"},"effectiveFrom":{"type":"string"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"regime":"HST","gstOrHstRate":0.14,"pstRate":null,"gstOrHstCents":14000,"pstCents":0,"totalCents":114000,"effectiveFrom":"2025-04-01","sources":[{"source":"CRA GST/HST calculator (and rates)","url":"https://www.canada.ca/en/revenue-agency/services/tax/businesses/topics/gst-hst-businesses/charge-collect-which-rate/cal…","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Place of supply is the caller's input; this endpoint does not decide it.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/australia-nz-gst":{"post":{"operationId":"australia_and_new_zealand_gst_registration_threshold","summary":"Australia and New Zealand GST registration threshold","description":"Test AU/NZ GST registration thresholds from monthly turnover and optionally extract GST from an inclusive or exclusive price.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"country":{"type":"string","enum":["AU","NZ"]},"nonProfit":{"default":false,"type":"boolean"},"monthlyTurnoverCents":{"minItems":12,"maxItems":12,"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"projectedNextMonthsCents":{"type":"array","items":{"type":"integer","minimum":0,"maximum":9007199254740991}},"taxiOrRideSourcing":{"default":false,"type":"boolean"},"priceCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"priceIncludesGst":{"default":true,"type":"boolean"}},"required":["country","monthlyTurnoverCents","projectedNextMonthsCents"],"additionalProperties":false},"example":{"country":"AU","nonProfit":false,"monthlyTurnoverCents":[0,0,0,0,0,0,0,0,0,0,0,3117000],"projectedNextMonthsCents":[280000,280000,280000,280000,280000,280000,280000,280000,280000,280000,280000],"taxiOrRideSourcing":false,"priceCents":11000,"priceIncludesGst":true}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"rate":{"type":"number"},"threshold":{"type":"number"},"currentTurnover":{"type":"number"},"projectedTurnover":{"type":"number"},"mustRegister":{"type":"boolean"},"reason":{"type":"string"},"gstCents":{"type":"number"},"netCents":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"rate":0.1,"threshold":7500000,"currentTurnover":3117000,"projectedTurnover":6197000,"mustRegister":false,"reason":"below_threshold","gstCents":1000,"netCents":10000,"sources":[{"source":"ATO Registering for GST / How GST works","url":"https://www.ato.gov.au/businesses-and-organisations/gst-excise-and-indirect-taxes/gst/registering-for-gst","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","AU current GST turnover = current month + previous 11 months; projected = current month + next 11 months. Register with…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/uk-vat-flat-rate":{"post":{"operationId":"uk_vat_flat_rate_scheme_percentage_and_vat_due","summary":"UK VAT Flat Rate Scheme percentage and VAT due","description":"Return the HMRC Flat Rate Scheme percentage for a business type and date (including limited-cost and first-year discount) and compute VAT due on VAT-inclusive turnover.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"list":{"type":"boolean","const":true}},"required":["list"],"additionalProperties":false},{"type":"object","properties":{"list":{"type":"boolean","const":false},"businessType":{"type":"string","minLength":1,"maxLength":200},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"vatInclusiveTurnoverPence":{"type":"integer","minimum":0,"maximum":9007199254740991},"goodsCostPence":{"type":"integer","minimum":0,"maximum":9007199254740991},"periodTurnoverForLcbPence":{"type":"integer","minimum":0,"maximum":9007199254740991},"periodMonths":{"type":"integer","minimum":1,"maximum":12},"firstYearOfRegistration":{"default":false,"type":"boolean"}},"required":["businessType","date","vatInclusiveTurnoverPence","goodsCostPence","periodTurnoverForLcbPence","periodMonths"],"additionalProperties":false}]},"example":{"businessType":"Computer and IT consultancy or data processing","date":"2026-11-14","vatInclusiveTurnoverPence":120000,"goodsCostPence":500,"periodTurnoverForLcbPence":120000,"periodMonths":3,"firstYearOfRegistration":false}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"rate":{"type":"number"},"baseRate":{"type":"number"},"limitedCostBusiness":{"type":"boolean"},"firstYearDiscountApplied":{"type":"boolean"},"vatDuePence":{"type":"number"},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"rate":0.165,"baseRate":0.145,"limitedCostBusiness":true,"firstYearDiscountApplied":false,"vatDuePence":19800,"sources":[{"source":"GOV.UK VAT Flat Rate Scheme: how much you pay (OGL v3.0)","url":"https://www.gov.uk/vat-flat-rate-scheme/how-much-you-pay","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Limited-cost business uses 16.5% when goods cost is less than 2% of VAT-inclusive turnover or less than £1,000 a year p…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/vat-invoice-requirements":{"post":{"operationId":"uk_vat_invoice_content_requirements_check","summary":"UK VAT invoice content requirements check","description":"Check a supplied invoice against HMRC Notice 700/21 full and simplified VAT invoice content rules and recompute arithmetic.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"invoice":{"type":"object","properties":{"number":{"type":"string","minLength":1,"maxLength":64},"timeOfSupply":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"issueDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"supplier":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"address":{"type":"string","minLength":1,"maxLength":1000},"vatNumber":{"type":"string","minLength":1,"maxLength":32}},"additionalProperties":false},"customer":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"address":{"type":"string","minLength":1,"maxLength":1000},"vatNumber":{"type":"string","minLength":1,"maxLength":32}},"additionalProperties":false},"lines":{"default":[],"maxItems":500,"type":"array","items":{"type":"object","properties":{"description":{"type":"string","minLength":1,"maxLength":500},"quantity":{"type":"number"},"unitPricePence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"vatRate":{"type":"number","minimum":0,"maximum":1},"netPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"additionalProperties":false}},"cashDiscountRate":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"totalNetPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalVatPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"totalGrossPence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string","minLength":1,"maxLength":8}},"additionalProperties":false},"supplierIsRetailer":{"default":false,"type":"boolean"},"type":{"default":"auto","type":"string","enum":["full","simplified","auto"]}},"required":["invoice"],"additionalProperties":false},"example":{"invoice":{"number":"174","timeOfSupply":"2007-10-30","issueDate":"2007-11-01","supplier":{"name":"Supplier Ltd","address":"1 High St","vatNumber":"987654321"},"customer":{"name":"Customer Ltd","address":"2 Low St"},"lines":[{"description":"Radios, SW15","quantity":6,"unitPricePence":2520,"vatRate":0.2,"netPence":15120},{"description":"DVD players","quantity":4,"unitPricePence":2360,"vatRate":0.2,"netPence":9440}],"cashDiscountRate":null,"totalNetPence":24560,"totalVatPence":4912,"totalGrossPence":29472,"currency":"GBP"},"supplierIsRetailer":false,"type":"full"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"missing":{"type":"array","items":{}},"warnings":{"type":"array","items":{}},"arithmetic":{"type":"object","properties":{"linesNet":{"type":"number"},"vat":{"type":"number"},"ok":{"type":"boolean"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"type":"full","missing":[],"warnings":[],"arithmetic":{"linesNet":24560,"vat":4912,"ok":true},"sources":[{"source":"HMRC VAT Notice 700/21 sections 4.1, 4.4, 4.5 (OGL v3.0)","url":"https://www.gov.uk/guidance/record-keeping-for-vat-notice-70021","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Full invoice rules follow Notice 700/21 §4.1; simplified rules follow §4.4/4.5 when gross ≤ £250.","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/uk-mtd-itsa-obligations":{"post":{"operationId":"uk_mtd_for_income_tax_mandate_and_quarterly_deadlines","summary":"UK MTD for Income Tax mandate and quarterly deadlines","description":"Tell a sole trader or landlord when Making Tax Digital for Income Tax applies from qualifying income, and list quarterly update deadlines.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"entity":{"type":"string","enum":["sole_trader","landlord","partnership"]},"qualifyingIncomePence":{"type":"object","propertyNames":{"type":"string","pattern":"^\\d{4}-\\d{2}$"},"additionalProperties":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"updatePeriods":{"default":"standard","type":"string","enum":["standard","calendar"]},"taxYear":{"type":"string","pattern":"^\\d{4}-\\d{2}$"}},"required":["entity","qualifyingIncomePence","taxYear"],"additionalProperties":false},"example":{"entity":"sole_trader","qualifyingIncomePence":{"2024-25":4500000,"2025-26":3200000,"2026-27":null},"updatePeriods":"standard","taxYear":"2027-28"}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"mandatedFrom":{"type":"string"},"triggerYear":{"type":"string"},"deadlines":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string"},"deadline":{"type":"string"}},"additionalProperties":true}},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"mandatedFrom":"2027-04-06","triggerYear":"2025-26","deadlines":[{"period":"2027-04-06/2027-07-05","deadline":"2027-08-07"},{"period":"2027-04-06/2027-10-05","deadline":"2027-11-07"},"…"],"sources":[{"source":"GOV.UK Making Tax Digital for Income Tax eligibility and quarterly updates (OGL v3.0)","url":"https://www.gov.uk/guidance/check-if-youre-eligible-for-making-tax-digital-for-income-tax","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","Mandation uses strictly-over thresholds: £50,000 (2024–25), £30,000 (2025–26), £20,000 (2026–27).","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/indirect-tax/us-use-tax-accrual":{"post":{"operationId":"us_use_tax_accrual_from_caller_rates","summary":"US use-tax accrual from caller rates","description":"Compute use tax owed on purchases where the vendor charged less than the caller-supplied combined rate, with per-jurisdiction totals.","tags":["indirect-tax"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"purchases":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"shipToJurisdiction":{"type":"string","minLength":1,"maxLength":64},"taxableAmountCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"salesTaxChargedCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"exempt":{"default":false,"type":"boolean"}},"required":["id","shipToJurisdiction","taxableAmountCents","salesTaxChargedCents"],"additionalProperties":false}},"rates":{"type":"object","propertyNames":{"type":"string","minLength":1,"maxLength":64},"additionalProperties":{"type":"number","minimum":0,"maximum":0.2}}},"required":["purchases","rates"],"additionalProperties":false},"example":{"purchases":[{"id":"PO-1","shipToJurisdiction":"WA-King","taxableAmountCents":100000,"salesTaxChargedCents":0,"exempt":false}],"rates":{"WA-King":0.1035}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"rate":{"type":"number"},"taxDueCents":{"type":"number"},"chargedCents":{"type":"number"},"useTaxAccrualCents":{"type":"number"}},"additionalProperties":true}},"totalAccrualCents":{"type":"number"},"byJurisdiction":{"type":"object","properties":{"WA-King":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"lines":[{"id":"PO-1","rate":0.1035,"taxDueCents":10350,"chargedCents":0,"useTaxAccrualCents":10350}],"totalAccrualCents":10350,"byJurisdiction":{"WA-King":10350},"sources":[{"source":"Caller-supplied combined rates and purchase amounts processed locally","url":"https://www.brainiac.software/api/v1/indirect-tax","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determination…","No state rate table is bundled; rates are caller-supplied. Over-charged lines report overchargedCents and are not nette…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}