HMRC UK Tax Authority · JSON Structure
Hmrc Structure
Structural overview of the HMRC UK Tax Authority API surface; extracted from openapi/.
Type:
Properties: 0
GovernmentMaking Tax DigitalRegulatoryTaxUK
Hmrc Structure is a JSON Structure definition published by HMRC UK Tax Authority.
Meta-schema:
JSON Structure
{
"provider": "HMRC UK Tax Authority",
"providerId": "hmrc",
"kind": "json-structure",
"description": "Structural overview of the HMRC UK Tax Authority API surface; extracted from openapi/.",
"schemaCount": 10,
"operationCount": 5,
"schemas": [
{
"name": "ObligationsResponse",
"type": "object",
"propertyCount": 1,
"required": []
},
{
"name": "Obligation",
"type": "object",
"propertyCount": 6,
"required": []
},
{
"name": "VatReturnRequest",
"type": "object",
"propertyCount": 11,
"required": [
"periodKey",
"vatDueSales",
"vatDueAcquisitions",
"totalVatDue",
"vatReclaimedCurrPeriod",
"netVatDue",
"totalValueSalesExVAT",
"totalValuePurchasesExVAT",
"totalValueGoodsSuppliedExVAT",
"totalAcquisitionsExVAT",
"finalised"
]
},
{
"name": "VatReturn",
"type": null,
"propertyCount": 0,
"required": []
},
{
"name": "VatReturnConfirmation",
"type": "object",
"propertyCount": 4,
"required": []
},
{
"name": "PaymentsResponse",
"type": "object",
"propertyCount": 1,
"required": []
},
{
"name": "VatPayment",
"type": "object",
"propertyCount": 2,
"required": []
},
{
"name": "LiabilitiesResponse",
"type": "object",
"propertyCount": 1,
"required": []
},
{
"name": "VatLiability",
"type": "object",
"propertyCount": 5,
"required": []
},
{
"name": "Error",
"type": "object",
"propertyCount": 3,
"required": []
}
],
"operations": [
{
"method": "GET",
"path": "/organisations/vat/{vrn}/obligations",
"operationId": "getVatObligations",
"summary": "Retrieve VAT obligations",
"tags": [
"Obligations"
]
},
{
"method": "POST",
"path": "/organisations/vat/{vrn}/returns",
"operationId": "submitVatReturn",
"summary": "Submit a VAT return",
"tags": [
"Returns"
]
},
{
"method": "GET",
"path": "/organisations/vat/{vrn}/returns/{periodKey}",
"operationId": "getVatReturn",
"summary": "View a submitted VAT return",
"tags": [
"Returns"
]
},
{
"method": "GET",
"path": "/organisations/vat/{vrn}/payments",
"operationId": "getVatPayments",
"summary": "Retrieve VAT payments",
"tags": [
"Payments"
]
},
{
"method": "GET",
"path": "/organisations/vat/{vrn}/liabilities",
"operationId": "getVatLiabilities",
"summary": "Retrieve VAT liabilities",
"tags": [
"Liabilities"
]
}
]
}
Work with this as data
Every JSON Structure here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for json structure
4 MCP tools reach this
find_json_structuresBrowse and filter every JSON Structure in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Structure
curl "https://apis.io/api/v1/json-structures/hmrc-structure"
All json structure
curl "https://apis.io/api/v1/json-structures?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.