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.
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.
OpenAPI Specification
openapi: 3.2.0
info:
title: Autonomous AP 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'
operationId: getInvoiceProcessedInvoiceByUuid
x-operation-id-source: derived
components:
schemas:
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'
amount:
properties:
amount:
example: 1.5
type: number
currency:
example: USD
type: string
type: object
withholding-tax:
type: object
properties:
type:
type: string
code:
type: string
base_amount:
type: object
required:
- amount
- currency
properties:
amount:
type: number
currency:
type: string
wht_amount:
type: object
required:
- amount
- currency
properties:
amount:
type: number
currency:
type: string
addressCore:
required:
- address_line1
- country
- zip
properties:
address_line1:
default: ''
title: The address_line1 schema
type: string
example: 12345 MARKET STREET
address_line2:
default: ''
title: The address_line2 schema
type: string
example: SUITE 1234
address_line3:
default: ''
title: The address_line3 schema
type: string
example: ''
area_code:
default: ''
title: The area_code schema
type: string
example: '415'
city:
default: ''
title: The city schema
type: string
example: SAN FRANCISCO
company:
default: ''
title: The company schema
type: string
example: Preferred Supplier Inc.
contact:
default: ''
title: The contact schema
type: string
example: Jane Doe
country:
default: ''
title: The country schema
type: string
example: US
country_iso3:
default: ''
title: The country_iso3 schema
type: string
example: USA
email:
default: ''
title: The email schema
type: string
example: janedoe@supplier.com
phone:
default: ''
title: The phone schema
type: string
example: '4042965282'
province:
default: ''
title: The province schema
type: string
example: ''
state:
default: ''
title: The state schema
type: string
example: CA
zip:
default: ''
title: The zip schema
type: string
example: '94016'
po_policy_match_type:
type: string
enum:
- PO_NONE_MATCH_TYPE
- PO_POLICY_TWO_WAY_MATCH
- PO_POLICY_THREE_WAY_MATCH
payment-term:
properties:
name:
description: Payment term name as mentioned in the ERP system
type: string
example: NET 30
id:
description: Payment term id that uniquely identifies a payment term in the ERP system
type: string
example: '8900012'
active:
description: If payment term is active in the ERP system
default: true
type: boolean
code:
default: ''
example: NET
description: Refers to the AppZen Code. Should be one from the mentioned here.
enum:
- NONE_PAYMENT_TERM_CODE
- NET
- EOM
- FOM
- PIA
- CWO
- DOR
type: string
date:
allOf:
- $ref: '#/components/schemas/date-time'
discounts:
$ref: '#/components/schemas/discounts'
num_days:
default: ''
example: 30
description: Number of days for payment to be made.
type: integer
num_grace_days:
example: 0
description: Number of grace days available for the payment
type: integer
custom_json:
type: object
entities_list:
description: list of external identifier for entities that this payment term is associated with
type: array
items:
type: string
required:
- id
- name
discounts:
items:
properties:
discount_days:
default: 0
example: 0
description: The discount days
type: integer
discount_percent:
default: 0
example: 0
description: The discount percent
type: integer
discount_amount:
default: 0
example: 0
description: The discount amount
type: integer
type: object
required:
- discount_amount
- discount_days
- discount_percent
type: array
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'
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'
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
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
processed-invoice-other-segment:
type: object
properties:
segment_code:
type: string
segment_name:
type: string
segment_type:
type: string
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:
# --- 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