AppZen Vat API
The Vat API from AppZen — 4 operation(s) for vat.
Work with this as data
Every API 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 apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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 API
curl "https://apis.io/api/v1/apis/appzen-vat-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
OpenAPI Specification
openapi: 3.2.0
info:
title: Autonomous AP APIs Chart of Accounts Vat API
description: Public APIs for integrating with Autonomous AP
version: 2.0.3
servers:
- url: https://<env>.appzen.com/dictionary-data-services
security:
- API Key Header: []
Customer Id Header: []
Customer Key Header: []
tags:
- name: Vat
paths:
/vat:
post:
tags:
- Vat
summary: Creates/updates a Vat master item
description: Creates a new Vat master item in AppZen. Returns a uuid for this vat item. When vat item -- with the same vat_code/vat_rate combination -- already exists, then the operation is an update (in this case, the `status` in the response will be `UPDATED`).
parameters:
- $ref: '#/components/parameters/vat-json-schema'
responses:
200:
description: Updated
content:
application/json:
schema:
$ref: '#/components/schemas/uuid-updated'
201:
description: Created
content:
application/json:
schema:
$ref: '#/components/schemas/uuid'
400:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/http-400-error-response'
401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/http-401-error-response'
403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/http-403-error-response'
404:
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/http-404-error-response'
500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/http-500-error-response'
/vat/{uuid}:
get:
tags:
- Vat
summary: Returns Vat master item details
description: Returns the details of a Vat master item by uuid
parameters:
- $ref: '#/components/parameters/uuid'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/vat-master-get'
400:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/http-400-error-response'
401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/http-401-error-response'
403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/http-403-error-response'
404:
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/http-404-error-response'
500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/http-500-error-response'
/vat/vat-id/{vat-id}:
get:
tags:
- Vat
summary: Returns Vat master item details by vat-id
description: Returns Vat master item details matching vat-id specified as path parameter
parameters:
- $ref: '#/components/parameters/vat-id'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/vat-master-get'
400:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/http-400-error-response'
401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/http-401-error-response'
403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/http-403-error-response'
404:
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/http-404-error-response'
500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/http-500-error-response'
/vat/vat-code/{vat-code}/vat-rate/{vat-rate}:
get:
deprecated: true
tags:
- Vat
summary: Returns Vat master item details by vat-code and vat-rate
description: Returns Vat master item details matching vat-code and vat-rate specified as path parameters
parameters:
- $ref: '#/components/parameters/vat-code'
- $ref: '#/components/parameters/vat-rate'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/vat-master-get'
400:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/http-400-error-response'
401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/http-401-error-response'
403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/http-403-error-response'
404:
description: Not Found
content:
application/json:
schema:
$ref: '#/components/schemas/http-404-error-response'
500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/http-500-error-response'
components:
schemas:
http-403-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 403
error:
type: string
example: Forbidden
message:
type: string
example: 'Error code : 17e3338d - You do not have permission to access this resource'
uuid:
type: object
properties:
uuid:
type: string
example: 5fc03087-d265-11e7-b8c6-83e29cd24f4c
status:
type: string
example: CREATED
date-time:
type: string
format: date-time
example: '2024-03-01T11:01:00Z'
description: date should be in UTC format
http-500-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 500
error:
type: string
example: Internal Server Error
message:
type: string
example: 'Error code : 17e3338d - Unable to process your request at this moment, please try again later'
http-401-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 401
error:
type: string
example: Unauthorized
message:
type: string
example: 'Error code : 17e3338d - Unable to authenticate credentials'
http-400-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 400
error:
type: string
example: Bad Request
message:
type: string
example: 'Error code : 17e3338d - Invalid request, please fix and resend'
uuid-updated:
type: object
properties:
uuid:
type: string
example: 5fc03087-d265-11e7-b8c6-83e29cd24f4c
status:
type: string
example: UPDATED
vat-master-get:
properties:
vat_code:
description: Vat item code as mentioned in ERP system
type: string
example: VAT12
vat_rate:
example: 12
description: Vat item rate in ERP system. Vat code/rate combination corresponds to a unique vat master item
type: number
vat_id:
description: Vat item Id from ERP system
type: string
example: vat_1xsd2sd
appzen_vat_code:
description: Appzen mapped Vat item code
type: string
example: VAT
appzen_vat_rate:
description: Appzen mapped Vat item rate
type: number
example: 12
appzen_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/appzen-vat-breakdown-item'
- description: The appzen break down of vat amount
country:
type: string
example: Germany
country_code_iso3:
type: string
description: ISO3 standard country code
example: DEU
is_active:
description: Is Vat item active in ERP system.
default: true
type: boolean
last_updated_at:
allOf:
- $ref: '#/components/schemas/date-time'
jurisdiction_code:
type: string
description: Standard tax jurisdiction code
example: IN
vat-master:
properties:
vat_code:
description: Vat item code as mentioned in ERP system
type: string
example: VAT12
vat_rate:
example: 12
description: Vat item rate in ERP system. Vat code/rate combination corresponds to a unique vat master item
type: number
vat_id:
description: Vat item Id from ERP system
type: string
example: 1xsd2sd
appzen_vat_code:
type: string
description: ERP Vat code maps to one of these predefined list of codes mantained by Appzen.
example: VAT
appzen_vat_rate:
description: Appzen mapped Vat item code
type: number
example: 12
appzen_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/appzen-vat-breakdown-item'
- description: The appzen break down of vat amount
country:
type: string
example: Germany
country_code_iso3:
type: string
description: ISO3 standard country code
example: DEU
is_active:
description: Is Vat item active in ERP system.
default: true
type: boolean
jurisdiction_code:
type: string
description: Standard tax jurisdiction code
example: IN
description: Combination of vat_code and vat_rate (optional) should be unique
required:
- vat_code
appzen-vat-breakdown-item:
type: object
properties:
code:
description: A customer vat code maps to one of these predefined list of vat codes mantained by Appzen.
type: string
example: VAT
rate:
type: number
description: rate as percentage
example: 12
exclusiveMinimum: 0
http-404-error-response:
type: object
properties:
timestamp:
type: string
example: 2019-01-17T16:12:45.977+0000
status:
type: string
example: 404
error:
type: string
example: Not Found
message:
type: string
example: 'Error code : 17e3338d - The resource you specified cannot be not found'
parameters:
vat-rate:
in: path
description: customer vat rate. If vat record was loaded without a vat rate, set it to 0 in this request
required: true
name: vat-rate
schema:
type: number
vat-id:
in: path
description: customer vat id
required: true
name: vat-id
schema:
type: string
vat-json-schema:
in: body
required: true
name: vat-json-schema
schema:
$ref: '#/components/schemas/vat-master'
vat-code:
in: path
description: customer vat code
required: true
name: vat-code
schema:
type: string
uuid:
in: path
description: Globally unique identifier for an uploaded document
required: true
name: uuid
schema:
type: string
securitySchemes:
API_Key_Header:
type: apiKey
in: header
name: x-api-key
Customer_Id_Header:
type: apiKey
in: header
name: customer-id
Customer_Key_Header:
type: apiKey
in: header
name: customer-key