{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"HyAgentX Exchange Global Accounting and Tax Read API","version":"1.0.0","description":"Implemented accounting and tax read API. All financial source reads execute under a dedicated read-only database role. Live provider statements and jurisdiction profiles must be separately configured and verified."},"servers":[{"url":"https://hyagentx.com","description":"This HyAgentX Exchange instance"}],"tags":[{"name":"Finance export","description":"Purpose-scoped financial reads only."}],"paths":{"/v1/finance-export/capabilities":{"get":{"operationId":"getExportCapabilities","summary":"Get ExportCapabilities","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]},{"ExportOAuth":["tax:read"]},{"ExportOAuth":["finance_documents:read"]}],"parameters":[],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Capabilities"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/legal-entities":{"get":{"operationId":"listExportLegalEntities","summary":"List ExportLegalEntities","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]},{"ExportOAuth":["tax:read"]},{"ExportOAuth":["finance_documents:read"]}],"parameters":[{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalEntityPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/accounts":{"get":{"operationId":"listAccounts","summary":"List Accounts","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/journal-entries":{"get":{"operationId":"listJournalEntries","summary":"List JournalEntries","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JournalEntryPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/invoices":{"get":{"operationId":"listInvoices","summary":"List Invoices","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["finance_documents:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoicePage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/settlements":{"get":{"operationId":"listSettlements","summary":"List Settlements","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SettlementPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/tax-documents":{"get":{"operationId":"listTaxDocuments","summary":"List TaxDocuments","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["tax:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"},{"$ref":"#/components/parameters/Jurisdiction"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaxDocumentPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/reports":{"get":{"operationId":"listReports","summary":"List Reports","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English. Filter report types and fields by underlying scopes: accounting:read permits accounting reports; tax:read permits tax summaries. Do not expose identifiers of other report classes.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]},{"ExportOAuth":["tax:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/changes":{"get":{"operationId":"listFinancialChanges","summary":"List FinancialChanges","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English. Intersect finance_changes:read with underlying scopes. No data leak via event counts, object IDs or cross-entity cursors. Return resume_cursor even at the tail.","tags":["Finance export"],"security":[{"ExportOAuth":["finance_changes:read","accounting:read"]},{"ExportOAuth":["finance_changes:read","tax:read"]},{"ExportOAuth":["finance_changes:read","finance_documents:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/documents/{id}":{"get":{"operationId":"getFinanceDocument","summary":"Get FinanceDocument","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English. Validate the document class against the grant. A signed URL is an authorization-bearing artifact with an expiry; do not log it.","tags":["Finance export"],"security":[{"ExportOAuth":["finance_documents:read"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1},"description":"Object ACL checked in addition to OAuth scope."}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/corrections":{"get":{"operationId":"listFinancialCorrection","summary":"List reviewed corrections","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialCorrectionPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/fiscal-profiles":{"get":{"operationId":"listFiscalProfileExport","summary":"List reviewed fiscal-profiles","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["finance_documents:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"},{"$ref":"#/components/parameters/PeriodFrom"},{"$ref":"#/components/parameters/PeriodTo"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiscalProfileExportPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/payment-obligations":{"get":{"operationId":"listPaymentObligations","summary":"List PaymentObligation records","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentObligationPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/payment-schedules":{"get":{"operationId":"listPaymentSchedules","summary":"List PaymentSchedule records","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentSchedulePage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/v1/finance-export/funding-allocations":{"get":{"operationId":"listFundingAllocations","summary":"List FundingAllocation records","description":"Read-only operation. Enforce audience, current grant, data-owner tenant, legal entity, purpose and permitted fields on the server. All human-readable platform messages are English.","tags":["Finance export"],"security":[{"ExportOAuth":["accounting:read"]}],"parameters":[{"$ref":"#/components/parameters/Entity"},{"$ref":"#/components/parameters/Cursor"},{"$ref":"#/components/parameters/Limit"},{"$ref":"#/components/parameters/Snapshot"}],"responses":{"200":{"description":"Authorized read result; no source financial mutation.","headers":{"Content-Language":{"schema":{"const":"en"}},"Cache-Control":{"schema":{"const":"private, no-store"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FundingAllocationPage"}}}},"400":{"description":"Invalid filter, cursor combination or profile period.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"401":{"description":"Authentication is missing, invalid or revoked.","headers":{"Content-Language":{"schema":{"const":"en"}},"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Insufficient data, purpose, entity or scope grant.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Resource unavailable; may conceal unauthorized object existence.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Method not allowed. No financial mutation methods are exposed.","headers":{"Content-Language":{"schema":{"const":"en"}},"Allow":{"schema":{"const":"GET, HEAD, OPTIONS"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"DATA_NOT_READY or conflicting snapshot context.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"410":{"description":"SNAPSHOT_EXPIRED or CURSOR_EXPIRED. Follow the explicit recovery action.","headers":{"Content-Language":{"schema":{"const":"en"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded. Honor Retry-After.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Service temporarily unavailable; source financial writes remain independent.","headers":{"Content-Language":{"schema":{"const":"en"}},"Retry-After":{"schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"securitySchemes":{"ExportOAuth":{"type":"oauth2","description":"Confidential client with private_key_jwt authentication; short-lived tokens, dedicated finance-export audience and revocable server-side entity/purpose grant. Token acquisition does not grant financial writes. Authentication-server metadata supplies the supported signing/token-binding profile.","flows":{"clientCredentials":{"tokenUrl":"https://hyagentx.com/auth/token","scopes":{"accounting:read":"Read approved accounting records within the grant.","tax:read":"Read tax records within the grant.","finance_documents:read":"Read authorized invoices and supporting documents.","finance_changes:read":"Read change notifications, intersected with the underlying data scopes."}}}}},"parameters":{"Entity":{"name":"legal_entity_id","in":"query","required":true,"schema":{"type":"string","minLength":1},"description":"Must belong to the authenticated grant; never expands access."},"PeriodFrom":{"name":"period_from","in":"query","schema":{"type":"string","format":"date"},"description":"Inclusive business-date boundary. Must be paired with period_to. Does not replace the change feed for late postings."},"PeriodTo":{"name":"period_to","in":"query","schema":{"type":"string","format":"date"},"description":"Exclusive business-date boundary, interpreted using the selected accounting/tax profile."},"Cursor":{"name":"cursor","in":"query","schema":{"type":"string","minLength":1},"description":"Opaque scope-bound page or incremental cursor. Expired cursors return an explicit error."},"Snapshot":{"name":"snapshot_id","in":"query","schema":{"type":"string","minLength":1},"description":"Omit for initial read. Reuse the server-issued snapshot across pages/resources. Reject conflicting cursor or filters."},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},"Jurisdiction":{"name":"tax_jurisdiction","in":"query","schema":{"type":"string","minLength":1},"description":"Must be configured and authorized; global API paths are country-independent."}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string","minLength":1,"description":"English summary."},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string","minLength":1,"description":"Safe English description; do not expose another entity or secrets."},"instance":{"type":"string","minLength":1},"code":{"type":"string","minLength":1,"description":"Stable machine-readable code."},"correlation_id":{"type":"string","minLength":1},"retryable":{"type":"boolean"},"safe_to_retry":{"type":"boolean"},"next_action":{"type":"object","properties":{"type":{"type":"string","enum":["REAUTHENTICATE","REQUEST_SCOPE","RETRY_AFTER","RESTART_SNAPSHOT","RESYNC_CHANGES","CONTACT_SUPPORT","WAIT_FOR_DATA"]},"after_seconds":{"type":"integer","minimum":0}},"required":["type"],"additionalProperties":false}},"required":["type","title","status","detail","instance","code","correlation_id","retryable","safe_to_retry","next_action"],"additionalProperties":false},"Money":{"type":"object","properties":{"amount":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency. Never inferred from locale or country."}},"required":["amount","currency"],"additionalProperties":false,"description":"Exact decimal string. Never a binary floating-point value."},"EffectivePeriod":{"type":"object","properties":{"effective_from":{"type":"string","format":"date-time"},"effective_to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["effective_from","effective_to"],"additionalProperties":false,"description":"Start inclusive, end exclusive; null end is open-ended."},"LegalProfile":{"type":"object","properties":{"profile_ref":{"type":"string","minLength":1},"registered_name":{"type":["string","null"],"minLength":1,"description":"Reviewed legal name, or null while an individual has supplied only a public display name."},"domicile_country":{"type":"string","pattern":"^[A-Z]{2}$"},"tax_registration_ids":{"type":"array","items":{"type":"string","minLength":1}},"effective_period":{"$ref":"#/components/schemas/EffectivePeriod"},"principal_type":{"type":"string","enum":["INDIVIDUAL","ORGANIZATION","UNSPECIFIED"],"description":"Legal nature recorded in this historical profile, independent of tax registration and commercial role."}},"required":["profile_ref","registered_name","domicile_country","tax_registration_ids","effective_period"],"additionalProperties":false},"LegalEntity":{"type":"object","properties":{"legal_entity_id":{"type":"string","minLength":1},"data_owner_tenant_id":{"type":"string","minLength":1},"current_profile_ref":{"type":"string","minLength":1},"profiles":{"type":"array","items":{"$ref":"#/components/schemas/LegalProfile"}}},"required":["legal_entity_id","data_owner_tenant_id","current_profile_ref","profiles"],"additionalProperties":false,"description":"Only grant-authorized entities. Historical profiles never rewrite issued documents."},"Account":{"type":"object","properties":{"account_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"chart_revision":{"type":"string","minLength":1},"code":{"type":"string","minLength":1},"label":{"type":"string","minLength":1,"description":"English platform label."},"account_type":{"type":"string","enum":["ASSET","LIABILITY","EQUITY","REVENUE","EXPENSE"]},"effective_period":{"$ref":"#/components/schemas/EffectivePeriod"}},"required":["account_id","legal_entity_id","chart_revision","code","label","account_type","effective_period"],"additionalProperties":false},"JournalLine":{"type":"object","properties":{"line_id":{"type":"string","minLength":1},"account_id":{"type":"string","minLength":1},"side":{"type":"string","enum":["DEBIT","CREDIT"]},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency. Never inferred from locale or country."}},"required":["line_id","account_id","side","amount","currency"],"additionalProperties":false},"JournalEntry":{"type":"object","properties":{"journal_id":{"type":"string","minLength":1},"revision":{"type":"integer","minimum":1},"legal_entity_id":{"type":"string","minLength":1},"legal_profile_ref":{"type":"string","minLength":1},"accounting_profile_ref":{"type":"string","minLength":1},"posted_at":{"type":"string","format":"date-time"},"effective_on":{"type":"string","format":"date"},"status":{"type":"string","enum":["POSTED"]},"source_event_id":{"type":"string","minLength":1},"reversal_of":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"correction_of":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"entries":{"type":"array","items":{"$ref":"#/components/schemas/JournalLine"}}},"required":["journal_id","revision","legal_entity_id","legal_profile_ref","accounting_profile_ref","posted_at","effective_on","status","source_event_id","reversal_of","correction_of","entries"],"additionalProperties":false,"description":"Debits equal credits per currency. Append-only: corrections create new entries."},"TaxComponent":{"type":"object","properties":{"tax_jurisdiction":{"type":"string","minLength":1,"description":"Country plus jurisdiction where required; not restricted to CH."},"tax_type":{"type":"string","minLength":1,"description":"Country-profile code such as VAT, GST, SALES_TAX or WITHHOLDING."},"tax_code":{"type":"string","minLength":1},"tax_status":{"type":"string","enum":["DETERMINED","UNDETERMINED","NOT_APPLICABLE"]},"taxable_amount":{"$ref":"#/components/schemas/Money"},"rate_percent":{"anyOf":[{"type":"string","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"},{"type":"null"}]},"tax_amount":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"exemption_reason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"tax_ruleset_ref":{"type":"string","minLength":1}},"required":["tax_jurisdiction","tax_type","tax_code","tax_status","taxable_amount","rate_percent","tax_amount","exemption_reason","tax_ruleset_ref"],"additionalProperties":false,"description":"Unknown tax is null with UNDETERMINED status, never assumed zero."},"Invoice":{"type":"object","properties":{"invoice_id":{"type":"string","minLength":1},"revision":{"type":"integer","minimum":1},"document_type":{"type":"string","enum":["INVOICE","CREDIT_NOTE","DEBIT_NOTE"]},"legal_entity_id":{"type":"string","minLength":1},"issuer_legal_entity_id":{"type":"string","minLength":1},"issuer_legal_profile_ref":{"type":"string","minLength":1},"counterparty_ref":{"type":"string","minLength":1,"description":"Only minimum authorized counterparty information."},"issued_on":{"type":"string","format":"date"},"net":{"$ref":"#/components/schemas/Money"},"tax_components":{"type":"array","items":{"$ref":"#/components/schemas/TaxComponent"}},"gross":{"$ref":"#/components/schemas/Money"},"correction_of":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"document_ref":{"type":"string","minLength":1},"fiscal_context":{"$ref":"#/components/schemas/InvoiceFiscalContext"}},"required":["invoice_id","revision","document_type","legal_entity_id","issuer_legal_entity_id","issuer_legal_profile_ref","counterparty_ref","issued_on","net","tax_components","gross","correction_of","document_ref"],"additionalProperties":false,"description":"Amounts use the invoice currency. Original issuer/profile remain immutable after relocation."},"Settlement":{"type":"object","properties":{"settlement_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"order_ref":{"type":"string","minLength":1},"payable_ref":{"type":"string","minLength":1},"amount":{"$ref":"#/components/schemas/Money"},"provider_ref":{"type":"string","minLength":1},"transfer_status":{"type":"string","minLength":1},"bank_payout_status":{"type":"string","minLength":1},"reconciliation_status":{"type":"string","enum":["PENDING","MATCHED","EXCEPTION"]},"recorded_at":{"type":"string","format":"date-time"}},"required":["settlement_id","legal_entity_id","order_ref","payable_ref","amount","provider_ref","transfer_status","bank_payout_status","reconciliation_status","recorded_at"],"additionalProperties":false,"description":"No bank account secrets, payment credentials or write capability."},"FXConversion":{"type":"object","properties":{"source_amount":{"$ref":"#/components/schemas/Money"},"target_amount":{"$ref":"#/components/schemas/Money"},"rate":{"type":"string","pattern":"^(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"rate_convention":{"type":"string","enum":["TARGET_PER_SOURCE"]},"rate_as_of":{"type":"string","format":"date-time"},"rate_source":{"type":"string","minLength":1},"rounding_rule_ref":{"type":"string","minLength":1}},"required":["source_amount","target_amount","rate","rate_convention","rate_as_of","rate_source","rounding_rule_ref"],"additionalProperties":false},"TaxDocument":{"type":"object","properties":{"tax_document_id":{"type":"string","minLength":1},"revision":{"type":"integer","minimum":1},"legal_entity_id":{"type":"string","minLength":1},"legal_profile_ref":{"type":"string","minLength":1},"invoice_id":{"type":"string","minLength":1},"issued_on":{"type":"string","format":"date"},"journal_status":{"type":"string","enum":["POSTED"]},"tax_profile_ref":{"type":"string","minLength":1},"tax_period_ref":{"type":"string","minLength":1},"tax_components":{"type":"array","items":{"$ref":"#/components/schemas/TaxComponent"}},"tax_currency_conversion":{"anyOf":[{"$ref":"#/components/schemas/ReviewedFXConversion"},{"$ref":"#/components/schemas/FXConversion"},{"type":"null"}]},"correction_of":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"document_type":{"enum":["INVOICE","CREDIT_NOTE","DEBIT_NOTE"]},"tax_effective_on":{"type":"string","format":"date"},"tax_direction":{"enum":["OUTPUT","INPUT_UNASSESSED"]}},"required":["tax_document_id","revision","legal_entity_id","legal_profile_ref","invoice_id","issued_on","journal_status","tax_profile_ref","tax_period_ref","tax_components","tax_currency_conversion","correction_of","document_type"],"additionalProperties":false},"ExportManifest":{"type":"object","properties":{"manifest_id":{"type":"string","minLength":1},"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"ledger_watermark":{"type":"string","minLength":1},"filter_hash":{"type":"string","minLength":1},"record_count":{"type":"integer","minimum":0},"content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"control_totals":{"type":"array","items":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency. Never inferred from locale or country."},"total_debits":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"},"total_credits":{"type":"string","pattern":"^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$"}},"required":["currency","total_debits","total_credits"],"additionalProperties":false}},"accounting_profile_ref":{"type":["string","null"],"minLength":1},"generated_at":{"type":"string","format":"date-time"},"accounting_profile_refs":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true}},"required":["manifest_id","schema_version","snapshot_id","legal_entity_id","ledger_watermark","filter_hash","record_count","content_sha256","control_totals","accounting_profile_ref","generated_at"],"additionalProperties":false},"Report":{"type":"object","properties":{"report_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"report_type":{"type":"string","enum":["TRIAL_BALANCE","INCOME_EXPENSE","TAX_SUMMARY"]},"status":{"type":"string","enum":["PROVISIONAL","FINAL"]},"period_from":{"type":"string","format":"date"},"period_to":{"type":"string","format":"date"},"period_timezone":{"type":"string","minLength":1,"description":"IANA time zone, independent of UI language."},"accounting_profile_ref":{"type":["string","null"],"minLength":1},"tax_profile_ref":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"manifest":{"$ref":"#/components/schemas/ExportManifest"},"document_ref":{"type":"string","minLength":1},"accounting_profile_refs":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true},"tax_profile_refs":{"type":"array","items":{"type":"string","minLength":1},"uniqueItems":true}},"required":["report_id","legal_entity_id","report_type","status","period_from","period_to","period_timezone","accounting_profile_ref","tax_profile_ref","manifest","document_ref"],"additionalProperties":false,"description":"Only pre-generated reports in the grant. Metadata does not permit closing a period or filing a tax return."},"Change":{"type":"object","properties":{"event_id":{"type":"string","minLength":1},"sequence":{"type":"string","minLength":1,"description":"Opaque ordered position, not a floating-point number."},"legal_entity_id":{"type":"string","minLength":1},"object_type":{"type":"string","minLength":1},"object_id":{"type":"string","minLength":1},"revision":{"type":"integer","minimum":1},"change_type":{"type":"string","enum":["CREATED","CORRECTED","REVERSED","PROFILE_CHANGED","UPDATED"]},"recorded_at":{"type":"string","format":"date-time"},"effective_on":{"type":"string","format":"date"}},"required":["event_id","sequence","legal_entity_id","object_type","object_id","revision","change_type","recorded_at","effective_on"],"additionalProperties":false,"description":"Events must be intersected with all underlying object/data scopes. The feed never exposes unauthorized object existence."},"Document":{"type":"object","properties":{"document_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"media_type":{"type":"string","enum":["application/pdf","text/csv","application/json"]},"content_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"download_url":{"type":"string","format":"uri"},"expires_at":{"type":"string","format":"date-time"},"manifest_ref":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["document_id","legal_entity_id","media_type","content_sha256","download_url","expires_at","manifest_ref"],"additionalProperties":false,"description":"Short-lived access to the already authorized object. Scope and expiry must also be enforced when fetching the bytes."},"Capabilities":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"language":{"type":"string","enum":["en"]},"read_only":{"const":true},"granted_scopes":{"type":"array","items":{"type":"string","enum":["accounting:read","tax:read","finance_documents:read","finance_changes:read"]}},"legal_entity_ids":{"type":"array","items":{"type":"string","minLength":1}},"configured_jurisdictions":{"type":"array","items":{"type":"string","minLength":1}},"formats":{"type":"array","items":{"type":"string","enum":["application/json","text/csv","application/pdf"]}},"max_page_size":{"type":"integer","minimum":1},"api_audience":{"type":"string","minLength":1},"supported_resources":{"type":"array","items":{"type":"string","minLength":1}}},"required":["schema_version","language","read_only","granted_scopes","legal_entity_ids","configured_jurisdictions","formats","max_page_size","api_audience","supported_resources"],"additionalProperties":false,"description":"Global schema does not imply all jurisdictions are enabled. Required data grants are enforced independently of request filters."},"LegalEntityPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/LegalEntity"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"AccountPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Account"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"JournalEntryPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/JournalEntry"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"InvoicePage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Invoice"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"SettlementPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Settlement"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"TaxDocumentPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/TaxDocument"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"ReportPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Report"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"ChangePage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/Change"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"resume_cursor":{"type":"string","minLength":1,"description":"Persist after processing all data; use on the next incremental request even when next_cursor is null."}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor","resume_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"ReviewedFXConversion":{"type":"object","properties":{"source_amount":{"$ref":"#/components/schemas/Money"},"reporting_amount":{"$ref":"#/components/schemas/Money"},"rate_ref":{"type":"string"},"numerator":{"type":"string","pattern":"^[1-9][0-9]*$"},"denominator":{"type":"string","pattern":"^[1-9][0-9]*$"},"rate_date":{"type":"string","format":"date"},"method":{"type":"string"},"source_ref":{"type":"string"},"rounding":{"const":"HALF_UP_MINOR_UNIT"}},"required":["source_amount","reporting_amount","rate_ref","numerator","denominator","rate_date","method","source_ref","rounding"],"additionalProperties":false},"InvoiceFiscalContext":{"type":"object","properties":{"commercial_role":{"const":"DISCLOSED_MARKETPLACE_AGENT"},"component":{"enum":["MEDIA","PLATFORM_FEE"]},"profile_ref":{"type":"string"},"invoice_authority_ref":{"type":"string"},"payment_operation_ref":{"type":["string","null"]},"issuer":{"type":"object","properties":{"registered_name":{"type":"string"},"registered_address":{"type":"string"},"domicile_country":{"type":"string"},"tax_registration_ids":{"type":"array","items":{"type":"object","properties":{"country":{"type":"string"},"scheme":{"type":"string"},"value":{"type":"string"}},"required":["country","scheme","value"],"additionalProperties":false}}},"required":["registered_name","registered_address","domicile_country","tax_registration_ids"],"additionalProperties":false},"tax_period_ref":{"type":"string"},"tax_date":{"type":"string","format":"date"},"tax_determination_ref":{"type":"string"},"reporting_conversion":{"anyOf":[{"$ref":"#/components/schemas/ReviewedFXConversion"},{"type":"null"}]},"correction_id":{"type":"string"},"correction_reason":{"type":"string"},"original_invoice_ref":{"type":"string"},"tax_reporting_status":{"type":"string"},"posting_period_ref":{"type":"string"},"posting_date":{"type":"string","format":"date"},"payment_milestone_ref":{"type":"string"}},"required":["commercial_role","component","profile_ref","invoice_authority_ref","issuer","tax_period_ref","tax_date","tax_determination_ref","reporting_conversion","payment_operation_ref"],"additionalProperties":false},"FinancialCorrection":{"type":"object","properties":{"correction_id":{"type":"string"},"legal_entity_id":{"type":"string"},"order_ref":{"type":"string"},"kind":{"type":"string"},"state":{"type":"string"},"document_state":{"type":"string"},"journal_state":{"type":"string"},"cash_state":{"type":"string"},"tax_state":{"type":"string"},"cash_action":{"type":"string"},"reason":{"type":"string"},"recorded_at":{"type":"string","format":"date-time"},"effective_on":{"type":"string","format":"date"},"original_tax_period_ref":{"type":["string","null"]},"source_refs":{"type":"array","items":{"type":"string"}},"document_refs":{"type":"array","items":{"type":"string"}},"journal_refs":{"type":"array","items":{"type":"string"}},"cash_amount":{"$ref":"#/components/schemas/Money"},"cash_operations":{"type":"array","items":{"type":"object","properties":{"operation_id":{"type":"string"},"kind":{"type":"string"},"state":{"type":"string"},"provider_ref":{"type":["string","null"]},"original_operation_ref":{"type":"string"},"amount":{"$ref":"#/components/schemas/Money"}},"required":["operation_id","kind","state","provider_ref","original_operation_ref","amount"],"additionalProperties":false}},"filing_receipt_ref":{"type":["string","null"],"minLength":1},"receivable_receipt_ref":{"type":["string","null"],"minLength":1}},"required":["correction_id","legal_entity_id","order_ref","kind","state","document_state","journal_state","cash_state","tax_state","cash_action","reason","recorded_at","effective_on","original_tax_period_ref","source_refs","document_refs","journal_refs","cash_amount","cash_operations"],"additionalProperties":false},"FiscalProfileExport":{"type":"object","properties":{"profile_ref":{"type":"string"},"legal_entity_id":{"type":"string"},"environment":{"enum":["sandbox","production"]},"content_hash":{"type":"string"},"activated_at":{"type":"string","format":"date-time"},"configuration":{"type":"object","properties":{"registered_name":{"type":"string","minLength":1,"maxLength":250},"principal_type":{"type":"string","enum":["INDIVIDUAL","ORGANIZATION"]},"tax_capacity":{"type":"string","enum":["BUSINESS","NON_BUSINESS"]},"domicile_country":{"type":"string","pattern":"^[A-Z]{2}$"},"registered_address":{"type":"string","minLength":5,"maxLength":1000},"tax_registration_ids":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"country":{"type":"string","pattern":"^[A-Z]{2}$"},"scheme":{"type":"string","minLength":3,"maxLength":500},"value":{"type":"string","minLength":3,"maxLength":500}},"required":["country","scheme","value"],"additionalProperties":false}},"tax_status":{"type":"string","enum":["REGISTERED","NOT_REGISTERED"]},"operating_countries":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"service_types":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"string","minLength":3,"maxLength":500}},"effective_from":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"effective_to":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"period_timezone":{"type":"string","minLength":3,"maxLength":500},"accounting_currency":{"type":"string","pattern":"^[A-Z]{3}$"},"reporting_currency":{"type":"string","pattern":"^[A-Z]{3}$"},"commercial_role":{"type":"string","const":"DISCLOSED_MARKETPLACE_AGENT"},"tax_point_basis":{"type":"string","enum":["INVOICE_ISSUED","PAYMENT_RECEIVED","SERVICE_START"]},"invoice_authority_ref":{"type":"string","minLength":3,"maxLength":500},"review":{"type":"object","properties":{"source_ref":{"type":"string","minLength":3,"maxLength":500},"reviewed_by":{"type":"string","minLength":3,"maxLength":500},"reviewed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"evidence_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["source_ref","reviewed_by","reviewed_at","evidence_sha256"],"additionalProperties":false},"accounts":{"type":"object","propertyNames":{"type":"string","enum":["PSP_CLEARING","CUSTOMER_FUNDS","SELLER_PAYABLE","PLATFORM_REVENUE","TAX_PAYABLE","SELLER_RECOVERABLE","CUSTOMER_REFUND_PAYABLE","CUSTOMER_RECEIVABLE"]},"additionalProperties":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":500},"label":{"type":"string","minLength":3,"maxLength":500},"type":{"type":"string","enum":["ASSET","LIABILITY","EQUITY","REVENUE","EXPENSE"]}},"required":["code","label","type"],"additionalProperties":false},"required":["PSP_CLEARING","CUSTOMER_FUNDS","SELLER_PAYABLE","PLATFORM_REVENUE","TAX_PAYABLE","SELLER_RECOVERABLE","CUSTOMER_REFUND_PAYABLE","CUSTOMER_RECEIVABLE"]},"additional_accounts":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":500},"label":{"type":"string","minLength":3,"maxLength":500},"type":{"type":"string","enum":["ASSET","LIABILITY","EQUITY","REVENUE","EXPENSE"]}},"required":["code","label","type"],"additionalProperties":false}},"periods":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"ref":{"type":"string","minLength":3,"maxLength":500},"start":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"end":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"filing_status":{"type":"string","enum":["NOT_FILED","FILED"]},"filing_receipt_ref":{"anyOf":[{"type":"string","minLength":3,"maxLength":500},{"type":"null"}]}},"required":["ref","start","end","filing_status","filing_receipt_ref"],"additionalProperties":false}},"rules":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":500},"component":{"type":"string","enum":["MEDIA","PLATFORM_FEE"]},"service_type":{"type":"string","minLength":3,"maxLength":500},"supplier_country":{"type":"string","pattern":"^[A-Z]{2}$"},"customer_country":{"type":"string","pattern":"^[A-Z]{2}$"},"service_country":{"type":"string","pattern":"^[A-Z]{2}$"},"customer_tax_status":{"type":"string","enum":["REGISTERED","NOT_REGISTERED"]},"customer_tax_capacity":{"type":"string","enum":["BUSINESS","NON_BUSINESS"]},"effective_from":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"effective_to":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"tax_jurisdiction":{"type":"string","minLength":3,"maxLength":500},"tax_type":{"type":"string","minLength":3,"maxLength":500},"tax_code":{"type":"string","minLength":3,"maxLength":500},"treatment":{"type":"string","enum":["STANDARD","EXEMPT","REVERSE_CHARGE","OUT_OF_SCOPE"]},"rate_basis_points":{"type":"integer","minimum":0,"maximum":10000},"explanation":{"type":"string","minLength":10,"maxLength":2000},"exemption_reason":{"anyOf":[{"type":"string","minLength":5,"maxLength":1000},{"type":"null"}]},"review":{"type":"object","properties":{"source_ref":{"type":"string","minLength":3,"maxLength":500},"reviewed_by":{"type":"string","minLength":3,"maxLength":500},"reviewed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"evidence_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["source_ref","reviewed_by","reviewed_at","evidence_sha256"],"additionalProperties":false}},"required":["id","component","service_type","supplier_country","customer_country","service_country","customer_tax_status","effective_from","effective_to","tax_jurisdiction","tax_type","tax_code","treatment","rate_basis_points","explanation","exemption_reason","review"],"additionalProperties":false}},"fx_rates":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":3,"maxLength":500},"from":{"type":"string","pattern":"^[A-Z]{3}$"},"to":{"type":"string","pattern":"^[A-Z]{3}$"},"numerator":{"type":"string","pattern":"^[1-9][0-9]{0,23}$"},"denominator":{"type":"string","pattern":"^[1-9][0-9]{0,23}$"},"effective_from":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"effective_to":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"rate_date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"method":{"type":"string","minLength":3,"maxLength":500},"review":{"type":"object","properties":{"source_ref":{"type":"string","minLength":3,"maxLength":500},"reviewed_by":{"type":"string","minLength":3,"maxLength":500},"reviewed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"},"evidence_sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["source_ref","reviewed_by","reviewed_at","evidence_sha256"],"additionalProperties":false}},"required":["id","from","to","numerator","denominator","effective_from","effective_to","rate_date","method","review"],"additionalProperties":false}}},"required":["registered_name","domicile_country","registered_address","tax_registration_ids","tax_status","operating_countries","service_types","effective_from","effective_to","period_timezone","accounting_currency","reporting_currency","commercial_role","tax_point_basis","invoice_authority_ref","review","accounts","periods","rules","fx_rates"],"additionalProperties":false}},"required":["profile_ref","legal_entity_id","environment","content_hash","activated_at","configuration"],"additionalProperties":false},"FinancialCorrectionPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FinancialCorrection"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"FiscalProfileExportPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FiscalProfileExport"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"PaymentObligation":{"type":"object","properties":{"obligation_id":{"type":"string","minLength":1},"order_id":{"type":"string","minLength":1},"milestone_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"debtor_legal_entity_id":{"type":"string","minLength":1},"creditor_legal_entity_id":{"type":"string","minLength":1},"kind":{"enum":["MEDIA","SERVICE","PLATFORM_FEE","COVERAGE","FINANCING_REPAYMENT"]},"contractual_ceiling":{"$ref":"#/components/schemas/Money"},"earned":{"$ref":"#/components/schemas/Money"},"transferred":{"$ref":"#/components/schemas/Money"},"due_at":{"type":["string","null"],"format":"date-time"},"state":{"type":"string","minLength":1},"terms_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"recorded_at":{"type":"string","format":"date-time"}},"required":["obligation_id","order_id","milestone_id","legal_entity_id","debtor_legal_entity_id","creditor_legal_entity_id","kind","contractual_ceiling","earned","transferred","due_at","state","terms_hash","recorded_at"],"additionalProperties":false},"PaymentObligationPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentObligation"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"PaymentSchedule":{"type":"object","properties":{"milestone_id":{"type":"string","minLength":1},"order_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"reference":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"quantity":{"type":"integer","minimum":1},"accepted_quantity":{"type":"integer","minimum":0},"state":{"type":"string","minLength":1},"start_at":{"type":"string","format":"date-time"},"end_at":{"type":"string","format":"date-time"},"funding_due_at":{"type":"string","format":"date-time"},"provider_due_at":{"type":["string","null"],"format":"date-time"},"payment_due_at":{"type":["string","null"],"format":"date-time"},"accepted_at":{"type":["string","null"],"format":"date-time"},"invoice_received_at":{"type":["string","null"],"format":"date-time"},"invoice_valid_at":{"type":["string","null"],"format":"date-time"},"invoice_refs":{"type":"array","items":{"type":"string","minLength":1}},"recorded_at":{"type":"string","format":"date-time"}},"required":["milestone_id","order_id","legal_entity_id","reference","title","quantity","accepted_quantity","state","start_at","end_at","funding_due_at","provider_due_at","payment_due_at","accepted_at","invoice_received_at","invoice_valid_at","invoice_refs","recorded_at"],"additionalProperties":false},"PaymentSchedulePage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/PaymentSchedule"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."},"FundingAllocation":{"type":"object","properties":{"allocation_id":{"type":"string","minLength":1},"order_id":{"type":"string","minLength":1},"legal_entity_id":{"type":"string","minLength":1},"facility_ref":{"type":["string","null"]},"ceiling":{"$ref":"#/components/schemas/Money"},"funded":{"$ref":"#/components/schemas/Money"},"repaid":{"$ref":"#/components/schemas/Money"},"restricted":{"$ref":"#/components/schemas/Money"},"released":{"$ref":"#/components/schemas/Money"},"credit_exposure":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"recorded_at":{"type":"string","format":"date-time"}},"required":["allocation_id","order_id","legal_entity_id","facility_ref","ceiling","funded","repaid","restricted","released","credit_exposure","recorded_at"],"additionalProperties":false},"FundingAllocationPage":{"type":"object","properties":{"schema_version":{"type":"string","minLength":1},"snapshot_id":{"type":"string","minLength":1},"snapshot_expires_at":{"type":"string","format":"date-time"},"ledger_watermark":{"type":"string","minLength":1},"generated_at":{"type":"string","format":"date-time"},"data_complete_through":{"type":"string","format":"date-time"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FundingAllocation"}},"next_cursor":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["schema_version","snapshot_id","snapshot_expires_at","ledger_watermark","generated_at","data_complete_through","data","next_cursor"],"additionalProperties":false,"description":"All pages use a stable, scope-bound snapshot. Pass snapshot_id from the first response across resources for a consistent export. Filters may not change within a cursor."}}},"x-architecture-revision":"1.2","x-language":"en","x-read-only":true,"x-required-runtime-controls":["Deny every source financial write at gateway, service and database layers.","Grant entity/tenant/time/purpose scope is always authoritative.","Legal relocation creates profiles or entities; never rewrites past records.","Use snapshot-consistent pagination and incremental changes for late corrections.","Internal audit/metrics writes are not financial mutations.","Never imply all-country tax compliance from the global schema."]}