> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/development/api-reference-app/billing-or-vat-classes.md).

# Billing | VAT Classes

## Get the VAT classes of your organization.

> The system class 'standard' comes first.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Billing | VAT Classes"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"VatClassList":{"required":["items","self","total"],"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/VatClass"},"description":"The VAT classes, the system class 'standard' first."},"total":{"type":"integer","format":"int32"},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"HATEOAS representation of the VAT class collection of your organization."},"VatClass":{"required":["id","self"],"type":"object","properties":{"id":{"type":"integer","description":"ID of the VAT class.","format":"int32"},"name":{"type":"string","description":"Name of the VAT class.","nullable":true},"systemKey":{"type":"string","description":"Key of a system VAT class (standard, reduced, exempt); null for classes created by the tenant.","nullable":true},"categoryCode":{"$ref":"#/components/schemas/VatCategory"},"exemptionReasonCode":{"type":"string","description":"Exemption reason code (e.g. VATEX code) for exempt classes.","nullable":true},"exemptionReason":{"type":"string","description":"Exemption reason text for exempt classes.","nullable":true},"rates":{"type":"array","items":{"$ref":"#/components/schemas/TaxRate"},"description":"Rates of the class valid today, one per country.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"HATEOAS representation of a VAT class of your organization. Product offers reference a VAT class;\nthe rate is resolved per country at billing."},"VatCategory":{"enum":["Standard","ZeroRated","Exempt","ReverseCharge","IntraCommunity","Export","NotSubject"],"type":"string","description":"VAT category of a VAT class (UNTDID 5305). Each value names a code:\nStandard       → S\nZeroRated      → Z\nExempt         → E\nReverseCharge  → AE\nIntraCommunity → K\nExport         → G\nNotSubject     → O"},"TaxRate":{"type":"object","properties":{"countryIso2":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","nullable":true},"rate":{"type":"number","description":"Rate in percent.","format":"double"}},"additionalProperties":false,"description":"VAT rate of a VAT class in a country."},"ResourceLink":{"type":"object","properties":{"href":{"type":"string","nullable":true},"method":{"type":"string","nullable":true}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/billing/vat-classes":{"get":{"tags":["Billing | VAT Classes"],"summary":"Get the VAT classes of your organization.","description":"The system class 'standard' comes first.","responses":{"200":{"description":"The VAT classes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatClassList"}}}},"403":{"description":"Forbidden: Resource access denied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## GET /v1/billing/vat-classes/{vatClassId}

> Get a single VAT class of your organization.

```json
{"openapi":"3.0.4","info":{"title":"Equipme Customer API","version":"v1"},"tags":[{"name":"Billing | VAT Classes"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","description":"Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.","name":"X-API-KEY","in":"header"}},"schemas":{"VatClass":{"required":["id","self"],"type":"object","properties":{"id":{"type":"integer","description":"ID of the VAT class.","format":"int32"},"name":{"type":"string","description":"Name of the VAT class.","nullable":true},"systemKey":{"type":"string","description":"Key of a system VAT class (standard, reduced, exempt); null for classes created by the tenant.","nullable":true},"categoryCode":{"$ref":"#/components/schemas/VatCategory"},"exemptionReasonCode":{"type":"string","description":"Exemption reason code (e.g. VATEX code) for exempt classes.","nullable":true},"exemptionReason":{"type":"string","description":"Exemption reason text for exempt classes.","nullable":true},"rates":{"type":"array","items":{"$ref":"#/components/schemas/TaxRate"},"description":"Rates of the class valid today, one per country.","nullable":true},"self":{"$ref":"#/components/schemas/ResourceLink"}},"additionalProperties":false,"description":"HATEOAS representation of a VAT class of your organization. Product offers reference a VAT class;\nthe rate is resolved per country at billing."},"VatCategory":{"enum":["Standard","ZeroRated","Exempt","ReverseCharge","IntraCommunity","Export","NotSubject"],"type":"string","description":"VAT category of a VAT class (UNTDID 5305). Each value names a code:\nStandard       → S\nZeroRated      → Z\nExempt         → E\nReverseCharge  → AE\nIntraCommunity → K\nExport         → G\nNotSubject     → O"},"TaxRate":{"type":"object","properties":{"countryIso2":{"type":"string","description":"ISO 3166-1 alpha-2 country code.","nullable":true},"rate":{"type":"number","description":"Rate in percent.","format":"double"}},"additionalProperties":false,"description":"VAT rate of a VAT class in a country."},"ResourceLink":{"type":"object","properties":{"href":{"type":"string","nullable":true},"method":{"type":"string","nullable":true}},"additionalProperties":false},"ErrorResponse":{"type":"object","properties":{"errorCode":{"type":"string","nullable":true},"errorDescription":{"type":"string","nullable":true},"data":{"nullable":true}},"additionalProperties":false}}},"paths":{"/v1/billing/vat-classes/{vatClassId}":{"get":{"tags":["Billing | VAT Classes"],"summary":"Get a single VAT class of your organization.","parameters":[{"name":"vatClassId","in":"path","description":"ID of the VAT class.","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"The VAT class with the rates valid today.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VatClass"}}}},"403":{"description":"Forbidden: The VAT class does not exist, belongs to another organization or access is denied.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://hub.equipme.io/development/api-reference-app/billing-or-vat-classes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
