AgentaOS · Schema
InvoiceDetail
PaymentsBillingSoftware-as-a-ServiceFreelancersArtificial Intelligence
Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| invoice_number | string | Human-readable, e.g. INV-2026-0142. |
| transaction_id | stringnull | Linked settled transaction, once paid. |
| session_id | stringnull | Linked checkout. |
| amount | number | Currency units. |
| currency | string | |
| payment_token | string | What the buyer paid (or will pay) with. |
| status | string | issued (created, not yet paid), paid (payment settled), or voided. |
| fiat_amount | numbernull | EUR/USD equivalent, for stablecoin payments. |
| fiat_currency | stringnull | |
| exchange_rate | numbernull | Rate applied at settlement. |
| exchange_rate_source | stringnull | |
| tax_rate | numbernull | Applied rate, e.g. 19 for 19%. |
| tax_amount | numbernull | Currency units. |
| tax_name | stringnull | e.g. DE VAT. |
| tax_inclusive | booleannull | Whether amount already includes tax. |
| merchant_name | stringnull | Seller name on the document. |
| buyer_email | stringnull | |
| buyer_name | stringnull | |
| buyer_company | stringnull | |
| buyer_country | stringnull | ISO 3166-1 alpha-2. |
| buyer_vat | stringnull | |
| tx_hash | stringnull | On-chain hash, for crypto payments. |
| issued_at | string | |
| voided_at | stringnull | |
| created_at | string | |
| earnings | object | Present only for a card/bank Merchant-of-Record sale with a linked, settled transaction. null otherwise. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/agentaos-ai/json-schema/agentaos-ai-invoice-detail-schema.json",
"title": "InvoiceDetail",
"x-generated": "2026-11-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/agentaos-ai-invoices-api-openapi.yml#/components/schemas/InvoiceDetail",
"allOf": [
{
"$ref": "#/$defs/Invoice"
},
{
"type": "object",
"properties": {
"earnings": {
"anyOf": [
{
"$ref": "#/$defs/Earnings"
},
{
"type": "null"
}
],
"description": "Present only for a card/bank Merchant-of-Record sale with a linked, settled transaction. null otherwise."
}
},
"required": [
"earnings"
]
}
],
"$defs": {
"Earnings": {
"type": "object",
"description": "Merchant-only fee/VAT/net breakdown, integer minor units in `currency`. grossMinor is your ex-VAT sale base (agentaosFeeMinor + netMinor); the buyer paid grossMinor + vatMinor.",
"properties": {
"currency": {
"type": "string"
},
"grossMinor": {
"type": "integer"
},
"agentaosFeeMinor": {
"type": "integer"
},
"vatMinor": {
"type": "integer"
},
"netMinor": {
"type": "integer"
}
},
"required": [
"currency",
"grossMinor",
"agentaosFeeMinor",
"vatMinor",
"netMinor"
]
},
"Invoice": {
"type": "object",
"additionalProperties": true,
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"invoice_number": {
"type": "string",
"description": "Human-readable, e.g. INV-2026-0142."
},
"transaction_id": {
"type": [
"string",
"null"
],
"format": "uuid",
"description": "Linked settled transaction, once paid."
},
"session_id": {
"type": [
"string",
"null"
],
"description": "Linked checkout."
},
"amount": {
"type": "number",
"description": "Currency units."
},
"currency": {
"type": "string"
},
"payment_token": {
"type": "string",
"description": "What the buyer paid (or will pay) with."
},
"status": {
"type": "string",
"enum": [
"issued",
"paid",
"voided"
],
"description": "issued (created, not yet paid), paid (payment settled), or voided."
},
"fiat_amount": {
"type": [
"number",
"null"
],
"description": "EUR/USD equivalent, for stablecoin payments."
},
"fiat_currency": {
"type": [
"string",
"null"
],
"enum": [
"EUR",
"USD",
null
]
},
"exchange_rate": {
"type": [
"number",
"null"
],
"description": "Rate applied at settlement."
},
"exchange_rate_source": {
"type": [
"string",
"null"
]
},
"tax_rate": {
"type": [
"number",
"null"
],
"description": "Applied rate, e.g. 19 for 19%."
},
"tax_amount": {
"type": [
"number",
"null"
],
"description": "Currency units."
},
"tax_name": {
"type": [
"string",
"null"
],
"description": "e.g. DE VAT."
},
"tax_inclusive": {
"type": [
"boolean",
"null"
],
"description": "Whether amount already includes tax."
},
"merchant_name": {
"type": [
"string",
"null"
],
"description": "Seller name on the document."
},
"buyer_email": {
"type": [
"string",
"null"
]
},
"buyer_name": {
"type": [
"string",
"null"
]
},
"buyer_company": {
"type": [
"string",
"null"
]
},
"buyer_country": {
"type": [
"string",
"null"
],
"description": "ISO 3166-1 alpha-2."
},
"buyer_vat": {
"type": [
"string",
"null"
]
},
"tx_hash": {
"type": [
"string",
"null"
],
"description": "On-chain hash, for crypto payments."
},
"issued_at": {
"type": "string",
"format": "date-time"
},
"voided_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
}
},
"required": [
"id",
"invoice_number",
"transaction_id",
"session_id",
"amount",
"currency",
"payment_token",
"status",
"fiat_amount",
"fiat_currency",
"exchange_rate",
"exchange_rate_source",
"tax_rate",
"tax_amount",
"tax_name",
"tax_inclusive",
"merchant_name",
"buyer_email",
"buyer_name",
"buyer_company",
"buyer_country",
"buyer_vat",
"tx_hash",
"issued_at",
"voided_at",
"created_at"
]
}
}
}Work with this as data
Every JSON Schema 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 schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema 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 Schema
curl "https://apis.io/api/v1/json-schemas/agentaos-ai-invoice-detail"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.