AppZen Processed Invoices API
The Processed Invoices API from AppZen — 1 operation(s) for processed invoices.
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-processed-invoices-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 Processed Invoices 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: Processed Invoices
paths:
/invoice/processed-invoice/{uuid}:
get:
tags:
- Processed Invoices
summary: Returns the processed invoice
description: Returns the processed results and invoice by uuid. It includes the risk at invoice header level, such as LOW, MEDIUM, HIGH, the overall invoice status, such as Approved, Rejected and invoice detail. The download links to the images are valid for only 5 minutes.
parameters:
- $ref: '#/components/parameters/uuid'
responses:
200:
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/processed-invoice-json-schema'
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:
invoice-goods-receipt:
type: object
properties:
receipt_id:
type: string
example: 123AB
description: The Receipt ID from source system
amount:
allOf:
- $ref: '#/components/schemas/amount'
- description: Amount allocated to invoice from this receipt
quantity:
type: integer
format: int32
example: 10
description: Quantity allocated to invoice from this receipt
invoice-header-custom-json:
type: object
description: 'Maximum of 20 fields allowed, 500 chars per field.
The following is the list of predefined reserved field names. They are the only field names that can have prefix "appzen: ". They are also not subject to the maximum count limit.
appzen: vendor_einvoice
appzen: exchange_rate
appzen: nota_fiscal_elec_num
appzen: nota_fiscal_type
appzen: nota_fiscal_material
appzen: nota_fiscal_service
appzen: withholding
appzen: invoice_category
appzen: business_place
appzen: section_code
appzen: gst_partner
appzen: place_of_supply
appzen: invoice_reference_no
appzen: payment_references
appzen: qr_reference_code
appzen: qr_bank
appzen: qr_unstructured_info
appzen: qr_structured_info
appzen: enasarco
appzen: partner_bank
appzen: assignment
appzen: sweden_ocr
appzen: norway_kid
appzen: denmark_fik
appzen: project
appzen: expenditure_org
appzen: expenditure_type
appzen: task
appzen: work_breakdown_structure
appzen: latam_vendor_vat_id
appzen: poland_ksef_id
appzen: israel_allocation_number
appzen: buyer_endpoint_id
appzen: buyer_reference
appzen: pl_ksef_number
appzen: pl_ksef_schema_version
appzen: pl_corrected_invoice_issue_date
appzen: pl_corrected_invoice_ksef_number
appzen: pl_corrected_invoice_number
appzen: pl_reason_for_correction
appzen: pl_type_of_correction
appzen: fr_supplier_siren
appzen: fr_supplier_siret
appzen: fr_customer_siren
appzen: fr_customer_siret
appzen: fr_invoice_format
appzen: fr_invoice_lifecycle_status
appzen: it_sdi_codice_destinatario
appzen: it_sdi_formato_trasmissione
appzen: it_sdi_id_trasmittente_code
appzen: it_sdi_id_trasmittente_country
appzen: it_sdi_pec_destinatario
appzen: it_sdi_progressivo_invio
appzen: es_dir3_oficina_contable
appzen: es_dir3_organo_gestor
appzen: es_dir3_unidad_tramitadora
appzen: es_facturae_version
appzen: de_einvoice_format
appzen: de_leitweg_id
appzen: nl_oin
appzen: nl_preferred_format
appzen: no_ehf_profile_id
appzen: no_org_number
appzen: pt_atcud
appzen: pt_qr_code_present
appzen: dk_cvr
appzen: dk_ean_gln
appzen: fi_einvoice_address
appzen: fi_business_id_y_tunnus
appzen: ie_exchange_rate
appzen: lu_exchange_rate
appzen: se_endpoint_id
appzen: hu_nav_rtir_reporting_required
appzen: bg_converted_vat_amount
appzen: be_company_number_kbo_cbe
appzen: bd_bin_or_tin
appzen: ca_gst_hst_registration
appzen: hk_business_registration_number
appzen: lk_vat_registration
appzen: mu_vat_number
appzen: ua_vat_number
appzen: us_supplier_ein
appzen: ae_tax_amount_aed
'
example:
approval-code: KE-382
category: internal-projects
'appzen: withholding': '23.5'
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'
date-time:
type: string
format: date-time
example: '2024-03-01T11:01:00Z'
description: date should be in UTC format
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'
processed-invoice-other-object-fields:
type: object
description: Set of key value pairs, where each value is an object with two keys - name and id
example:
code-region:
name: us-east
id: region1s
code-dept:
name: wing-1
id: '325'
po_policy_match_type:
type: string
enum:
- PO_NONE_MATCH_TYPE
- PO_POLICY_TWO_WAY_MATCH
- PO_POLICY_THREE_WAY_MATCH
processed-invoice-json-schema:
example:
audit_results:
actions:
field_validations: []
header_validations:
- action_type: blocking
confidence: 1
final_risk: NONE_RISK
post_config_risk: NONE_RISK
post_feedback_risk: NONE_RISK
result_data:
duplicate_invoice_ids: []
risk_level: NONE_RISK
risk_reason: None
state: Approved
validation_display_name: Duplicate Invoices Check
validation_id: duplicate_image_within_invoices
validation_name: duplicate_image_within_invoices
- action_type: blocking
confidence: 1
final_risk: NONE_RISK
post_config_risk: NONE_RISK
post_feedback_risk: NONE_RISK
result_data: []
risk_level: NONE_RISK
risk_reason: None
state: Approved
validation_display_name: Duplicate Invoice Across Expense
validation_id: duplicate_across_expenses
validation_name: duplicate_across_expenses
- action_type: blocking
confidence: 1
final_risk: NONE_RISK
post_config_risk: NONE_RISK
post_feedback_risk: NONE_RISK
result_data: []
risk_level: NONE_RISK
risk_reason: None risk found.
state: Approved
validation_display_name: Supplier Check
validation_id: supplier_check
validation_name: supplier_check
line_validations: []
appzen_invoice_id: '...'
appzen_invoice_state: Processed
customer_id: ..
uuid: '...'
processed_invoice:
appzen_invoice_id: 015979ba-67a3-4607-a63c-42017af986d7
appzen_invoice_state: Processed
customer_id: ..
currency: USD
created_at: '2021-07-11T17:02:03Z'
entity_name: ERT Division
entity_id: ERTDA-231
image_locations:
- image_url: https://...
name: invoice_from_supplier123243
mime_type: pdf
link_expires_after: '2024-02-15T02:55:40.404Z'
invoice_id: '...'
invoice_date: '2021-07-01T00:00:00Z'
payment_type_override: WIRE
accounting_date_override: '2022-02-01T00:00:00Z'
requester: pos
requester_id: SX123
requester_email_address: pos@appzen.ai
product_category: software
invoice_lines:
- appzen_line_number: 1
line_description: '....'
line_number: 1
line_item_code: vc-dfs
model_number: '...'
purchase_order_number: '...'
purchase_order_line_number: 2
gl_code: 8720.NA.Company.CD414
quantity: 122
currency: USD
memo: trip expenses
price_per_unit: 2.25
amortization_schedule: monthly
tax_amount:
amount: 1.25
currency: USD
total_amount:
amount: 205
currency: USD
labels:
- AB
- PROTO
other_fields:
custom1: Line
'appzen: line_level_note_text': Include total check
other_object_fields:
inv_code:
name: invX32
id: '324'
tax_code:
name: vat32
id: tax-list-1
po_match_type: PO_POLICY_THREE_WAY_MATCH
pre_paid: false
service_start_date: '2020-07-11T17:02:03Z'
service_end_date: '2023-07-11T17:02:03Z'
tax_applicability_id: 2A3BL
line_vat_amount:
amount: 1.5
currency: USD
po_backed_line: false
has_line_allocations: true
line_allocations:
- amount: 200
tax: 0.125
gl_code: 8720.NA.Company.CD414
- amount: 5.0
tax: 1.375
gl_code: 8720.NA.Company.CD413
line_vat_breakdown:
- vat_id: vat_324
code: GST
rate: 20.5
vat_amount:
amount: 12.5
currency: USD
jurisdiction_code: IN
appzen_line_vat_breakdown:
- code: GST
rate: 20.5
unit_of_measure: Each
unit_price:
amount: 1
currency: USD
segments:
- appzen_segment_type: SPEND_CATEGORY_SEGMENT
segment_type: Spend Category
segment_name: Supplies - Research & Lab work
segment_code: SUP384
- appzen_segment_type: COST_CENTER_SEGMENT
segment_type: Cost Center
segment_name: Basic Sc Testing
segment_code: CD414
- appzen_segment_type: COMPANY_SEGMENT
segment_type: Company
segment_name: 001 Georgetown University
segment_code: Georgetown
other_segments:
- segment_type: Assignee
segment_name: 80720 Ostroumov, Alexey
segment_code: '8720'
- segment_type: Budget Code
segment_name: NA
segment_code: NA
invoice_number: INC-32434
invoice_status: Approved
last_updated_at: '2021-07-12T16:47:56Z'
payment_term_id: pt-1045
tax_applicability_id: 2A3B
default_tax_option: Calculate
memo: apply towards expenses
payment_term:
code: NET
discounts:
- discount_days: 4
discount_percent: 15
discount_amount:
amount: 10
currency: USD
num_days: 30
source: NET 30
po_policy:
po_backed: true
po_match_type: PO_POLICY_THREE_WAY_MATCH
receipt_type: GOODS_RECEIPT
purchase_order_numbers:
- 12321XP
shipping_handling_amount:
amount: 2.5
currency: USD
sub_total_amount:
amount: 120.65
currency: USD
submitter: Admin@mycompany.com
invoice_supplier_address:
address:
address_line1: 246 FENTON DR
city: '...'
country: US
state: KS
zip: '20882'
address_type: REMIT_TO
site_id: '2687310'
supplier_id: XSR6310
supplier_name: UDS LANDSCAPE
supplier_number: '6310'
tax_amount:
amount: 0
currency: USD
original_total_amount:
amount: 43.65
currency: USD
other_fields:
approval-code: KE-382
category: internal-projects
'appzen: withholding': '23.5'
other_object_fields:
code-region:
name: us-east
id: region1s
payment_due_date: '2022-07-31T00:00:00Z'
total_amount:
amount: 122
currency: USD
vat_amount:
amount: 1.5
currency: USD
vat_breakdown:
- code: GST
rate: 20.5
vat_amount:
amount: 1.5
currency: USD
jurisdiction_code: IN
appzen_vat_breakdown:
- code: GST
rate: 20.5
vat_registration_numbers:
- AX234SD
- 123DXSE_XDC
total_amount_excluding_vat:
amount: 113.25
currency: USD
non_invoice_attachments:
- name: supplier note.txt
mime_type: text/plain
image_url: https://...
link_expires_after: '2024-06-15T02:55:40.404Z'
payment_type: ACH
iban: GB29NWBK60161331926819
bank_account_number: '1234567890'
part_bank_key: BANK001
bank_name: ABC Bank
routing_number: '021000021'
bank_currency: USD
type: object
properties:
audit_results:
type: object
properties:
actions:
type: object
properties:
field_validations:
type: array
items:
$ref: '#/components/schemas/validation'
header_validations:
type: array
items:
$ref: '#/components/schemas/validation'
line_validations:
type: array
items:
$ref: '#/components/schemas/validation'
missing_mandatory_fields_header:
type: array
items:
type: string
missing_mandatory_fields_line:
type: array
items:
type: string
appzen_invoice_id:
type: string
appzen_invoice_state:
type: string
customer_id:
type: string
uuid:
type: string
processed_invoice:
type: object
properties:
appzen_invoice_id:
type: string
appzen_invoice_state:
type: string
currency:
type: string
customer_id:
type: string
created_at:
allOf:
- $ref: '#/components/schemas/date-time'
last_updated_at:
allOf:
- $ref: '#/components/schemas/date-time'
entity_id:
type: string
entity_name:
type: string
image_locations:
type: array
items:
type: object
properties:
image_url:
type: string
name:
type: string
mime_type:
type: string
link_expires_after:
allOf:
- $ref: '#/components/schemas/date-time'
invoice_date:
allOf:
- $ref: '#/components/schemas/date-time'
invoice_id:
type: string
invoice_type:
type: string
enum:
- INVOICE
- CREDIT_NOTE
- DEBIT_NOTE
- PROFORMA
- TAX_ONLY
- DOWN_PAYMENT
- MPREQ
memo:
type: string
invoice_lines:
type: array
items:
type: object
properties:
appzen_line_number:
type: integer
line_number:
type: integer
line_description:
type: string
line_item_code:
type: string
model_number:
type: string
unit_of_measure:
type: string
gl_code:
type: string
quantity:
type: number
currency:
type: string
purchase_order_line_number:
type: integer
purchase_order_number:
type: string
po_match_type:
allOf:
- $ref: '#/components/schemas/po_policy_match_type'
pre_paid:
type: boolean
memo:
type: string
amortization_schedule:
type: string
price_per_unit:
type: number
service_start_date:
allOf:
- $ref: '#/components/schemas/date-time'
service_end_date:
allOf:
- $ref: '#/components/schemas/date-time'
unit_price:
allOf:
- $ref: '#/components/schemas/amount'
tax_amount:
allOf:
- $ref: '#/components/schemas/amount'
total_amount:
allOf:
- $ref: '#/components/schemas/amount'
default_tax_option:
type: string
tax_applicability_id:
type: string
line_vat_amount:
allOf:
- $ref: '#/components/schemas/amount'
line_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/vat-breakdown-item'
- description: The break down of vat amount for the invoice line
appzen_line_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/appzen-vat-breakdown-item'
- description: Appzen break down of vat amount for the invoice line
po_backed_line:
type: boolean
has_line_allocations:
type: boolean
line_allocations:
type: array
items:
type: object
properties:
external_allocation_id:
type: string
amount:
type: number
example: 25.6
tax:
example: 2.56
type: number
percentage:
type: number
example: 35
gl_code:
type: string
spend_category:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
cost_center:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
region:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
location:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
legal_entity:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
company:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
account:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
department:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
vendor:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
user:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
customer:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
project:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
inter_company:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
other_segment:
type: array
items:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
allocation_quantity:
type: number
purchase_order_number:
type: string
purchase_order_line_number:
type: integer
appzen_line_allocation_number:
type: integer
goods_receipts:
type: array
items:
allOf:
- $ref: '#/components/schemas/invoice-goods-receipt'
line_type:
allOf:
- $ref: '#/components/schemas/invoice_line_type'
labels:
type: array
items:
type: string
other_fields:
type: object
other_object_fields:
allOf:
- $ref: '#/components/schemas/processed-invoice-other-object-fields'
segments:
type: array
items:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
other_segments:
type: array
items:
allOf:
- $ref: '#/components/schemas/processed-invoice-other-segment'
goods_receipts:
type: array
items:
allOf:
- $ref: '#/components/schemas/invoice-goods-receipt'
hsn_sac_code:
type: string
invoice_number:
type: string
invoice_status:
type: string
invoice_description:
type: string
payment_date:
allOf:
- $ref: '#/components/schemas/date-time'
original_invoice_id:
type: string
original_invoice_number:
type: string
original_invoice_date:
allOf:
- $ref: '#/components/schemas/date-time'
payment_due_date:
allOf:
- $ref: '#/components/schemas/date-time'
default_tax_option:
type: string
tax_applicability_id:
type: string
payment_term_id:
type: string
description: This value should be unique in the customer’s ERP system to distinguish payment terms
payment_term:
allOf:
- $ref: '#/components/schemas/payment-term'
payment_type_override:
type: string
example: CASH
accounting_date_override:
allOf:
- $ref: '#/components/schemas/date-time'
requester:
type: string
example: pos
requester_id:
type: string
example: SX123
requester_email_address:
type: string
example: pos@appzen.ai
product_category:
type: string
example: software
po_policy:
allOf:
- $ref: '#/components/schemas/po_policy'
external_unique_id:
type: string
submitter:
type: string
submission_date:
allOf:
- $ref: '#/components/schemas/date-time'
supplier_id:
type: string
supplier_name:
type: string
supplier_number:
type: string
site_id:
type: string
labels:
type: array
items:
type: string
spend_category:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
cost_center:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
region:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
location:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
legal_entity:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
company:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
account:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
department:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
vendor:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
user:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
customer:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
project:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
inter_company:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
other_segment:
type: array
items:
allOf:
- $ref: '#/components/schemas/processed-invoice-account-segment'
other_fields:
allOf:
- $ref: '#/components/schemas/invoice-header-custom-json'
other_object_fields:
allOf:
- $ref: '#/components/schemas/processed-invoice-other-object-fields'
purchase_order_numbers:
type: array
items:
type: string
shipping_handling_amount:
allOf:
- $ref: '#/components/schemas/amount'
invoice_shipping_address:
allOf:
- $ref: '#/components/schemas/address'
invoice_billing_address:
allOf:
- $ref: '#/components/schemas/address'
invoice_supplier_address:
allOf:
- $ref: '#/components/schemas/address'
invoice_remit_to_address:
allOf:
- $ref: '#/components/schemas/address'
original_total_amount:
allOf:
- $ref: '#/components/schemas/amount'
sub_total_amount:
allOf:
- $ref: '#/components/schemas/amount'
total_amount:
allOf:
- $ref: '#/components/schemas/amount'
tax_amount:
allOf:
- $ref: '#/components/schemas/amount'
total_vat_amount:
allOf:
- $ref: '#/components/schemas/amount'
miscellaneous_charges:
allOf:
- $ref: '#/components/schemas/amount'
vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/vat-breakdown-item'
- description: The break down of vat amount for the invoice
appzen_vat_breakdown:
type: array
items:
allOf:
- $ref: '#/components/schemas/appzen-vat-breakdown-item'
- description: Appzen break down of vat amount for the invoice
vat_registration_numbers:
type: array
items:
type: string
total_amount_excluding_vat:
allOf:
- $ref: '#/components/schemas/amount'
is_free_trial:
type: boolean
assignee_name:
type: string
assignee_id:
type: string
non_invoice_attachments:
type: array
items:
type: object
properties:
name:
type: string
mime_type:
type: string
# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/appzen/refs/heads/main/openapi/appzen-processed-invoices-api-openapi.yml