Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier’s guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document’s own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn’t be read: stop waiting and don’t act on the document. Idempotent on uploadKey — retries return the same document.
Which kind of document this is, when the caller knows. Preserved over the AI classifier's own guess; omit it and the classifier decides. ESTIMATE_SENT / ESTIMATE_RECEIVED are reference paper (an estimate, quote, proposal or contract) and book nothing.
Which side of the books the file came from when the caller knows only that: money_out (the business pays) or money_in (the business is owed). A weak prior for the classifier, which the document's own evidence and a named documentType both outrank.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Equated","colors":{"primary":"#18181b","light":"#f4f4f5","dark":"#18181b"},"logo":{"light":"https://mintcdn.com/equated/Msel0fvhHeByDQOp/logo-light.svg?fit=max\u0026auto=format\u0026n=Msel0fvhHeByDQOp\u0026q=85\u0026s=b8a62ee501e94fe4f6b980d3e222706b","dark":"https://mintcdn.com/equated/Msel0fvhHeByDQOp/logo-dark.svg?fit=max\u0026auto=format\u0026n=Msel0fvhHeByDQOp\u0026q=85\u0026s=9c42a6b8b9928e90f0085772f4d68303"},"favicon":"https://mintcdn.com/equated/Msel0fvhHeByDQOp/favicon.svg?fit=max\u0026auto=format\u0026n=Msel0fvhHeByDQOp\u0026q=85\u0026s=71d241905ec988384c5c2f2c84545ff7","navbar":{"links":[{"href":"https://equated.co","label":"Home"}],"primary":{"type":"button","label":"Book a demo","href":"https://equated.co/book"}},"footer":{"socials":{"website":"https://equated.co"}},"contextual":{"options":["copy","download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"equated","hasAudioNarration":false,"actualSubdomain":"equated","customDomains":["docs.equated.co"],"gitSource":{"type":"github","owner":"equated-org","repo":"equated","deployBranch":"main","contentDirectory":"mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae2acc80a2cfc8cf85720b5","collectionId":"e15cc824-52f5-4651-a8f3-8d06d1c7bca0","liveDeploymentHistoryId":"6ae2acc80a2cfc8cf85720b5","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae958e7535d15408a243225","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Developers \u0026 Agents","count":87},{"language":"default","tag":"API Reference","count":83},{"language":"default","tag":"Using Equated","count":17},{"language":"default","tag":"Documents","count":16},{"language":"default","tag":"Reconciliation","count":14},{"language":"default","tag":"Transactions","count":12},{"language":"default","tag":"Projects","count":10},{"language":"default","tag":"Automations","count":8},{"language":"default","tag":"Everyday workflows","count":7},{"language":"default","tag":"Understand your books","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".diagram-wrap{border:1px solid #ebebeb;border-radius:12px;padding:28px;margin:28px 0;font-family:'Plus Jakarta Sans',system-ui,sans-serif}.diagram-surface{background:#f5f5f4;border:1px solid #ebebeb;border-radius:8px}.diagram-surface-accent,.diagram-surface-dashed{background:#f6f6f6;border:1px solid #d1d5db;border-radius:8px}.diagram-surface-dashed{border:1px dashed #d1d5db}.diagram-row{padding:12px 16px;border-bottom:1px solid #ebebeb;display:flex;justify-content:space-between;align-items:center;font-size:13px}.diagram-row:last-child{border-bottom:none}.diagram-text{color:#0a0a0a;font-weight:500}.diagram-muted,.diagram-pill{color:#6b7280;font-size:12px}.diagram-pill{background:#fff;border:1px solid #ebebeb;border-radius:9999px;padding:5px 12px;color:#0a0a0a;display:inline-flex}.diagram-arrow{color:#d1d5db;font-size:18px}.diagram-eyebrow{font-size:10px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:#6b7280;margin-bottom:12px}"}],"page":{"pagePath":"api-reference/documents/create-a-document-from-an-uploaded-file","slug":"/api-reference/documents/create-a-document-from-an-uploaded-file","pageMetadata":{"title":"Create a document from an uploaded file","description":"Ingest a file uploaded via `POST /documents/upload-urls` as a DRAFT document. Name `documentType` (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier's guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, `uploadContext` (`money_out` / `money_in`) leans the classifier that way without settling anything — the document's own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until `aiExtractionPending` is false. If `aiExtractionFailed` is true instead, the file couldn't be read: stop waiting and don't act on the document. Idempotent on `uploadKey` — retries return the same document.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/ingest","href":"/api-reference/documents/create-a-document-from-an-uploaded-file","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Ingest a file uploaded via \", _jsx(_components.code, {\n children: \"POST /documents/upload-urls\"\n }), \" as a DRAFT document. Name \", _jsx(_components.code, {\n children: \"documentType\"\n }), \" (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier’s guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, \", _jsx(_components.code, {\n children: \"uploadContext\"\n }), \" (\", _jsx(_components.code, {\n children: \"money_out\"\n }), \" / \", _jsx(_components.code, {\n children: \"money_in\"\n }), \") leans the classifier that way without settling anything — the document’s own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until \", _jsx(_components.code, {\n children: \"aiExtractionPending\"\n }), \" is false. If \", _jsx(_components.code, {\n children: \"aiExtractionFailed\"\n }), \" is true instead, the file couldn’t be read: stop waiting and don’t act on the document. Idempotent on \", _jsx(_components.code, {\n children: \"uploadKey\"\n }), \" — retries return the same document.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a document from an uploaded file","description":"Ingest a file uploaded via `POST /documents/upload-urls` as a DRAFT document. Name `documentType` (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier's guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, `uploadContext` (`money_out` / `money_in`) leans the classifier that way without settling anything — the document's own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until `aiExtractionPending` is false. If `aiExtractionFailed` is true instead, the file couldn't be read: stop waiting and don't act on the document. Idempotent on `uploadKey` — retries return the same document.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/ingest","href":"/api-reference/documents/create-a-document-from-an-uploaded-file","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Documents"],"security":["de520890-a1df-493d-926f-b0f79b05618b"],"summary":"Create a document from an uploaded file","description":"Ingest a file uploaded via `POST /documents/upload-urls` as a DRAFT document. Name `documentType` (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier's guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, `uploadContext` (`money_out` / `money_in`) leans the classifier that way without settling anything — the document's own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until `aiExtractionPending` is false. If `aiExtractionFailed` is true instead, the file couldn't be read: stop waiting and don't act on the document. Idempotent on `uploadKey` — retries return the same document.","requestBody":"9fe838b3-6b6c-4b5f-982a-78691a10e627","responses":{"201":"4c84d258-f7ca-474f-a0f3-ba4b72a13653"},"method":"post","type":"path","servers":["06d64966-069c-481d-ad71-1447a267c747"],"path":"/api/documents/ingest","baseUrlOptions":["https://app.equated.co"],"title":"Create a document from an uploaded file","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"uploadKey":{"type":"string","minLength":1,"description":"uploadKey from the presign step, after the PUT succeeded.","isRequired":true,"uniqueKey":"uploadKey","typeLabel":"string"},"documentType":{"type":"string","enum":["RECEIPT","BILL","INVOICE","REIMBURSEMENT","ESTIMATE_SENT","ESTIMATE_RECEIVED"],"description":"Which kind of document this is, when the caller knows. Preserved over the AI classifier's own guess; omit it and the classifier decides. ESTIMATE_SENT / ESTIMATE_RECEIVED are reference paper (an estimate, quote, proposal or contract) and book nothing.","uniqueKey":"documentType","typeLabel":"enum\u003cstring>"},"uploadContext":{"type":"string","enum":["money_in","money_out"],"description":"Which side of the books the file came from when the caller knows only that: money_out (the business pays) or money_in (the business is owed). A weak prior for the classifier, which the document's own evidence and a named documentType both outrank.","uniqueKey":"uploadContext","typeLabel":"enum\u003cstring>"},"counterpartyName":{"type":"string","minLength":1,"maxLength":200,"description":"Vendor (receipt/bill) or customer (invoice) the user named.","uniqueKey":"counterpartyName","typeLabel":"string"},"amount":{"type":"string","pattern":"^\\d+(\\.\\d+)?$","description":"Grand total the user stated, in currency.","uniqueKey":"amount","typeLabel":"string"},"currency":{"type":"string","enum":["CAD","USD","EUR","GBP","AUD"],"description":"ISO currency the user stated. Omit to let extraction decide.","uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"documentDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Receipt/issue date printed on the document.","uniqueKey":"documentDate","typeLabel":"string"},"note":{"type":"string","minLength":1,"maxLength":2000,"description":"Any other context the user gave about this document.","uniqueKey":"note","typeLabel":"string"}},"required":["uploadKey"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"uploadKey":"\u003cstring>","counterpartyName":"\u003cstring>","amount":"\u003cstring>","documentDate":"\u003cstring>","note":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4c84d258-f7ca-474f-a0f3-ba4b72a13653":{"description":"Ingested document","content":{"application/json":{"schema":{"type":"object","properties":{"document":{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"document.id","typeLabel":"integer"},"documentType":{"type":"string","isRequired":true,"uniqueKey":"document.documentType","typeLabel":"string"},"lifecycle":{"type":"string","isRequired":true,"uniqueKey":"document.lifecycle","typeLabel":"string"},"amount":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.amount.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.amount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.amount","typeLabel":"string | null"},"currency":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.currency.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.currency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.currency","typeLabel":"string | null"},"displayTitle":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.displayTitle.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.displayTitle.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.displayTitle","typeLabel":"string | null"},"documentNumber":{"oneOf":[{"type":"string","uniqueKey":"document.documentNumber.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"document.documentNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.documentNumber","typeLabel":"string | null"},"dueDate":{"oneOf":[{"type":"string","uniqueKey":"document.dueDate.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"document.dueDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.dueDate","typeLabel":"string | null"},"createdAt":{"type":"string","uniqueKey":"document.createdAt","typeLabel":"string"},"orgMerchantId":{"oneOf":[{"type":"integer","minimum":0,"exclusiveMinimum":true,"uniqueKey":"document.orgMerchantId.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"exclusiveMinimum":true,"uniqueKey":"document.orgMerchantId.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.orgMerchantId","typeLabel":"integer | null"},"orgMerchant":{"oneOf":[{"type":"object","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true,"isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.name","typeLabel":"string"},"website":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.website.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.website.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.website","typeLabel":"string | null"},"imageUrl":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.imageUrl.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.imageUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.imageUrl","typeLabel":"string | null"},"logo":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logo.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logo","typeLabel":"string | null"},"logoUrl":{"oneOf":[{"type":"string","description":"The image to show: an uploaded image, else a stored logo, else the website's logo. Generated, so it is read-only; set imageUrl on the merchant to change it.","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logoUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The image to show: an uploaded image, else a stored logo, else the website's logo. Generated, so it is read-only; set imageUrl on the merchant to change it.","isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logoUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"document.orgMerchant.oneOf.0.logoUrl","typeLabel":"string | null"}},"required":["id","name","website","imageUrl","logo","logoUrl"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"document.orgMerchant.oneOf.0.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.orgMerchant.oneOf.0.additionalProperties","typeLabel":"null"},"uniqueKey":"document.orgMerchant.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"integer","minimum":0,"exclusiveMinimum":true},"name":{"type":"string"},"website":{"oneOf":[{"type":"string"},{"type":"null"}]},"imageUrl":{"oneOf":[{"type":"string"},{"type":"null"}]},"logo":{"oneOf":[{"type":"string"},{"type":"null"}]},"logoUrl":{"oneOf":[{"type":"string","description":"The image to show: an uploaded image, else a stored logo, else the website's logo. Generated, so it is read-only; set imageUrl on the merchant to change it."},{"type":"null","description":"The image to show: an uploaded image, else a stored logo, else the website's logo. Generated, so it is read-only; set imageUrl on the merchant to change it."}]}},"required":["id","name","website","imageUrl","logo","logoUrl"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"document.orgMerchant.oneOf.1.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.orgMerchant.oneOf.1.additionalProperties","typeLabel":"null"},"uniqueKey":"document.orgMerchant.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.orgMerchant","typeLabel":"object | null"},"amountBase":{"oneOf":[{"type":"string","uniqueKey":"document.amountBase.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"document.amountBase.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.amountBase","typeLabel":"string | null"},"baseCurrency":{"oneOf":[{"type":"string","uniqueKey":"document.baseCurrency.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"document.baseCurrency.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.baseCurrency","typeLabel":"string | null"},"derivedSettlementStatus":{"type":"string","enum":["open","partially_closed","closed"],"uniqueKey":"document.derivedSettlementStatus","typeLabel":"enum\u003cstring>"},"derivedOutstandingAmount":{"oneOf":[{"type":"string","description":"Unapplied balance in the document currency.","uniqueKey":"document.derivedOutstandingAmount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unapplied balance in the document currency.","uniqueKey":"document.derivedOutstandingAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.derivedOutstandingAmount","typeLabel":"string | null"},"payerAccountId":{"oneOf":[{"type":"integer","minimum":0,"exclusiveMinimum":true,"description":"Reimbursement liability/equity payer account; retained on unconfirm and null until selected.","uniqueKey":"document.payerAccountId.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"exclusiveMinimum":true,"description":"Reimbursement liability/equity payer account; retained on unconfirm and null until selected.","uniqueKey":"document.payerAccountId.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.payerAccountId","typeLabel":"integer | null"},"resolution":{"oneOf":[{"type":"string","enum":["unresolved","matched",null],"description":"Receipts only: unresolved (not linked to a transaction) or matched (linked to one); null for other document types.","uniqueKey":"document.resolution.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["unresolved","matched",null],"description":"Receipts only: unresolved (not linked to a transaction) or matched (linked to one); null for other document types.","uniqueKey":"document.resolution.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.resolution","typeLabel":"enum\u003cstring> | null"},"stage":{"oneOf":[{"type":"string","enum":["inbox","outstanding","done",null],"description":"List reads only: where the document stands, read per kind (inbox, outstanding, or done); null for one at none of them.","uniqueKey":"document.stage.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["inbox","outstanding","done",null],"description":"List reads only: where the document stands, read per kind (inbox, outstanding, or done); null for one at none of them.","uniqueKey":"document.stage.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.stage","typeLabel":"enum\u003cstring> | null"},"parentDocumentId":{"oneOf":[{"type":"integer","minimum":0,"exclusiveMinimum":true,"description":"The estimate or quote this document was made from; null when it came from none. Set with set_document_parent.","uniqueKey":"document.parentDocumentId.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"exclusiveMinimum":true,"description":"The estimate or quote this document was made from; null when it came from none. Set with set_document_parent.","uniqueKey":"document.parentDocumentId.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.parentDocumentId","typeLabel":"integer | null"},"archivedAt":{"oneOf":[{"type":"string","description":"When the paper was set aside; null while it is in the lists. Archived paper is returned only when include_archived is asked for.","uniqueKey":"document.archivedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the paper was set aside; null while it is in the lists. Archived paper is returned only when include_archived is asked for.","uniqueKey":"document.archivedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.archivedAt","typeLabel":"string | null"}},"required":["id","documentType","lifecycle","amount","currency","displayTitle"],"additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"document.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"document.additionalProperties","typeLabel":"null"},"isRequired":true,"uniqueKey":"document","typeLabel":"object"}},"required":["document"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"document":{"id":1,"documentType":"\u003cstring>","lifecycle":"\u003cstring>","amount":"\u003cstring>","currency":"\u003cstring>","displayTitle":"\u003cstring>","documentNumber":"\u003cstring>","dueDate":"\u003cstring>","createdAt":"\u003cstring>","orgMerchantId":1,"orgMerchant":{"id":1,"name":"\u003cstring>","website":"\u003cstring>","imageUrl":"\u003cstring>","logo":"\u003cstring>","logoUrl":"\u003cstring>"},"amountBase":"\u003cstring>","baseCurrency":"\u003cstring>","derivedSettlementStatus":"open","derivedOutstandingAmount":"\u003cstring>","payerAccountId":1,"resolution":"unresolved","stage":"inbox","parentDocumentId":1,"archivedAt":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"de520890-a1df-493d-926f-b0f79b05618b":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API token issued from the Equated app under Settings → API Keys and MCP.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"06d64966-069c-481d-ad71-1447a267c747":{"url":"https://app.equated.co","description":"API server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API token issued from the Equated app under Settings → API Keys and MCP.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API token issued from the Equated app under Settings → API Keys and MCP.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"equated","siteName":"Equated","title":"Create a document from an uploaded file - Equated","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T13:07:55.211Z","originalFileLocation":"api-reference/documents/create-a-document-from-an-uploaded-file.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier\u0026#x27;s guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document\u0026#x27;s own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn\u0026#x27;t be read: stop waiting and don\u0026#x27;t act on the document. Idempotent on uploadKey — retries return the same document.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Equated\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a document from an uploaded file - Equated\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier\u0026#x27;s guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document\u0026#x27;s own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn\u0026#x27;t be read: stop waiting and don\u0026#x27;t act on the document. Idempotent on uploadKey — retries return the same document.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Equated\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://equated.mintlify.app/_mintlify/api/og/v2?division=Documents\u0026amp;title=Create+a+document+from+an+uploaded+file\u0026amp;description=Ingest+a+file+uploaded+via+%60POST+%2Fdocuments%2Fupload-urls%60+as+a+DRAFT+document.+Name+%60documentType%60+%28RECEIPT%2C+REIMBURSEMENT%2C+BILL%2C+INVOICE%2C+ESTIMATE_SENT%2C+or+ESTI\u0026amp;theme=8d39df5b741487abc962d5b8\u0026amp;signature=fe3ce755e7f688e57bc9700a2a53db10ff9860a7394f30b687cf1617d00cbe04\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a document from an uploaded file - Equated\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier\u0026#x27;s guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document\u0026#x27;s own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn\u0026#x27;t be read: stop waiting and don\u0026#x27;t act on the document. Idempotent on uploadKey — retries return the same document.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://equated.mintlify.app/_mintlify/api/og/v2?division=Documents\u0026amp;title=Create+a+document+from+an+uploaded+file\u0026amp;description=Ingest+a+file+uploaded+via+%60POST+%2Fdocuments%2Fupload-urls%60+as+a+DRAFT+document.+Name+%60documentType%60+%28RECEIPT%2C+REIMBURSEMENT%2C+BILL%2C+INVOICE%2C+ESTIMATE_SENT%2C+or+ESTI\u0026amp;theme=8d39df5b741487abc962d5b8\u0026amp;signature=fe3ce755e7f688e57bc9700a2a53db10ff9860a7394f30b687cf1617d00cbe04\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/equated/xPtHZOXILZQTbOLh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Equated\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#18181b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/documents/create-a-document-from-an-uploaded-file.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.equated.co/#organization\",\"name\":\"Equated\",\"url\":\"https://docs.equated.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/equated/Msel0fvhHeByDQOp/logo-light.svg?fit=max\u0026auto=format\u0026n=Msel0fvhHeByDQOp\u0026q=85\u0026s=b8a62ee501e94fe4f6b980d3e222706b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.equated.co#website\",\"name\":\"Equated\",\"url\":\"https://docs.equated.co\",\"publisher\":{\"@id\":\"https://docs.equated.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file#webpage\",\"url\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file\",\"name\":\"Create a document from an uploaded file\",\"description\":\"Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier's guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document's own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn't be read: stop waiting and don't act on the document. Idempotent on uploadKey — retries return the same document.\",\"dateModified\":\"2026-10-21T13:07:55.211Z\",\"isPartOf\":{\"@id\":\"https://docs.equated.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.equated.co/api-reference/bank-accounts/list-connected-bank-accounts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documents\",\"item\":\"https://docs.equated.co/api-reference/documents/list-documents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a document from an uploaded file\",\"item\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file#apireference\",\"headline\":\"Create a document from an uploaded file\",\"name\":\"Create a document from an uploaded file\",\"description\":\"Ingest a file uploaded via POST /documents/upload-urls as a DRAFT document. Name documentType (RECEIPT, REIMBURSEMENT, BILL, INVOICE, ESTIMATE_SENT, or ESTIMATE_RECEIVED) when you know it and it is kept over the classifier's guess; omit it and the document lands unsorted for the classifier to name. When all you know is the direction, uploadContext (money_out / money_in) leans the classifier that way without settling anything — the document's own evidence still decides. AI extraction fills the type, amount, dates, counterparty, and line items in the background, guided by any details provided; bills and invoices then also get their draft accrual journal entry. Re-read the document until aiExtractionPending is false. If aiExtractionFailed is true instead, the file couldn't be read: stop waiting and don't act on the document. Idempotent on uploadKey — retries return the same document.\",\"url\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file\",\"mainEntityOfPage\":{\"@id\":\"https://docs.equated.co/api-reference/documents/create-a-document-from-an-uploaded-file#webpage\"},\"dateModified\":\"2026-10-21T13:07:55.211Z\",\"publisher\":{\"@id\":\"https://docs.equated.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.equated.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Equated\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Equated","nav":{"global":null,"tabs":[{"tab":"Using Equated","pages":[{"title":"Using Equated","href":""}]},{"tab":"Developers \u0026 Agents","groups":[{"group":"Build on Equated","pages":[{"title":"Connect your AI","href":"/for-agents"},{"title":"Authentication","href":"/api/authentication"},{"title":"AI integration","href":"/api/mcp"},{"title":"Action safety","href":"/api/action-safety"}]},{"group":"API Reference","pages":[{"group":"Bank Accounts","pages":[{"title":"List connected bank accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /api/bank-accounts","href":"/api-reference/bank-accounts/list-connected-bank-accounts"},{"title":"Get one connected bank account","deprecated":null,"version":null,"openapi":"/openapi.json get /api/bank-accounts/{id}","href":"/api-reference/bank-accounts/get-one-connected-bank-account"}]},{"group":"Transactions","pages":[{"title":"Add a manual transaction to a bank-feed account","deprecated":null,"version":null,"openapi":"/openapi.json post /api/financial-accounts/{id}/transactions","href":"/api-reference/transactions/add-a-manual-transaction-to-a-bank-feed-account"},{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /api/transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Add a manual transaction to a bank-feed account","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions","href":"/api-reference/transactions/add-a-manual-transaction-to-a-bank-feed-account-1"},{"title":"Confirm many transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/bulk-confirm","href":"/api-reference/transactions/confirm-many-transactions"},{"title":"Unconfirm many transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/bulk-unconfirm","href":"/api-reference/transactions/unconfirm-many-transactions"},{"title":"Update a transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/transactions/{id}","href":"/api-reference/transactions/update-a-transaction"},{"title":"Categorize a transaction","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/transactions/{id}/category","href":"/api-reference/transactions/categorize-a-transaction"},{"title":"Confirm a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/{id}/confirm","href":"/api-reference/transactions/confirm-a-transaction"},{"title":"Pay several bills with one transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/{id}/payments","href":"/api-reference/transactions/pay-several-bills-with-one-transaction"},{"title":"Collect several invoices with one transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/{id}/collections","href":"/api-reference/transactions/collect-several-invoices-with-one-transaction"},{"title":"Unconfirm a transaction","deprecated":null,"version":null,"openapi":"/openapi.json post /api/transactions/{id}/unconfirm","href":"/api-reference/transactions/unconfirm-a-transaction"},{"title":"Get one transaction","deprecated":null,"version":null,"openapi":"/openapi.json get /api/transactions/{providerTransactionId}","href":"/api-reference/transactions/get-one-transaction"}]},{"group":"Accounts","pages":[{"title":"List chart-of-accounts entries","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts","href":"/api-reference/accounts/list-chart-of-accounts-entries"},{"title":"Create a custom account","deprecated":null,"version":null,"openapi":"/openapi.json post /api/accounts","href":"/api-reference/accounts/create-a-custom-account"},{"title":"List register accounts with base-currency balances","deprecated":null,"version":null,"openapi":"/openapi.json get /api/accounts/registers","href":"/api-reference/accounts/list-register-accounts-with-base-currency-balances"},{"title":"Update a custom account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/{id}","href":"/api-reference/accounts/update-a-custom-account"},{"title":"Hide or unhide an account","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/accounts/{id}/settings","href":"/api-reference/accounts/hide-or-unhide-an-account"}]},{"group":"Documents","pages":[{"title":"List documents","deprecated":null,"version":null,"openapi":"/openapi.json get /api/documents","href":"/api-reference/documents/list-documents"},{"title":"Create a manual document","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents","href":"/api-reference/documents/create-a-manual-document"},{"title":"Create a document upload URL","description":"Presign a time-limited PUT URL for one document file (.pdf, .png, .jpg, or .jpeg; max 25MB). PUT the raw file bytes to `uploadUrl` with the returned `Content-Type` header, then ingest it with `POST /documents/ingest`. Nothing is recorded until that second call.","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/upload-urls","href":"/api-reference/documents/create-a-document-upload-url"},{"title":"Create a document from an uploaded file","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/ingest","href":"/api-reference/documents/create-a-document-from-an-uploaded-file"},{"title":"Get one document","description":"Returns document detail. Bills and invoices include a settlement summary whose links identify each payment or credit adjustment, its relationId for unapply, backing-JE status, payment base amount, and realized FX.","deprecated":null,"version":null,"openapi":"/openapi.json get /api/documents/{id}","href":"/api-reference/documents/get-one-document"},{"title":"Delete a draft document","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/documents/{id}","href":"/api-reference/documents/delete-a-draft-document"},{"title":"Edit a document's figures","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/documents/{id}","href":"/api-reference/documents/edit-a-documents-figures"},{"title":"Confirm a document","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/{id}/confirm","href":"/api-reference/documents/confirm-a-document"},{"title":"Unconfirm a document","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/{id}/unconfirm","href":"/api-reference/documents/unconfirm-a-document"},{"title":"Apply a payment transaction to a confirmed bill","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/{id}/payments","href":"/api-reference/documents/apply-a-payment-transaction-to-a-confirmed-bill"},{"title":"Remove a settlement allocation from a bill","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/documents/{id}/payments/{relationId}","href":"/api-reference/documents/remove-a-settlement-allocation-from-a-bill"},{"title":"Apply a collection transaction to a confirmed invoice","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/{id}/collections","href":"/api-reference/documents/apply-a-collection-transaction-to-a-confirmed-invoice"},{"title":"Remove a settlement allocation from an invoice","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/documents/{id}/collections/{relationId}","href":"/api-reference/documents/remove-a-settlement-allocation-from-an-invoice"},{"title":"Confirm many documents","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/bulk-confirm","href":"/api-reference/documents/confirm-many-documents"},{"title":"Unconfirm many documents","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/bulk-unconfirm","href":"/api-reference/documents/unconfirm-many-documents"},{"title":"Convert many documents to another type","deprecated":null,"version":null,"openapi":"/openapi.json post /api/documents/bulk-convert","href":"/api-reference/documents/convert-many-documents-to-another-type"}]},{"group":"Actions","pages":[{"title":"Preview (and optionally commit) an action","deprecated":null,"version":null,"openapi":"/openapi.json post /api/actions/preview","href":"/api-reference/actions/preview-and-optionally-commit-an-action"},{"title":"Execute a previously-committed action request","deprecated":null,"version":null,"openapi":"/openapi.json post /api/actions/{id}/execute","href":"/api-reference/actions/execute-a-previously-committed-action-request"},{"title":"List the action kinds an agent can request","deprecated":null,"version":null,"openapi":"/openapi.json get /api/actions/catalog","href":"/api-reference/actions/list-the-action-kinds-an-agent-can-request"}]},{"group":"Reports","pages":[{"title":"Profit \u0026 loss statement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reports/pnl","href":"/api-reference/reports/profit-\u0026-loss-statement"},{"title":"Cash flow statement","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reports/cash-flow","href":"/api-reference/reports/cash-flow-statement"},{"title":"Balance sheet","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reports/balance-sheet","href":"/api-reference/reports/balance-sheet"},{"title":"General ledger","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reports/general-ledger","href":"/api-reference/reports/general-ledger"}]},{"group":"Journal Entries","pages":[{"title":"List posted journal entries","deprecated":null,"version":null,"openapi":"/openapi.json get /api/journal-entries","href":"/api-reference/journal-entries/list-posted-journal-entries"},{"title":"Get a journal entry's activity timeline","deprecated":null,"version":null,"openapi":"/openapi.json get /api/journal-entries/{id}/activity","href":"/api-reference/journal-entries/get-a-journal-entrys-activity-timeline"},{"title":"Get one journal entry","deprecated":null,"version":null,"openapi":"/openapi.json get /api/journal-entries/{id}","href":"/api-reference/journal-entries/get-one-journal-entry"}]},{"group":"Reconciliation","pages":[{"title":"Live close checklist for a date window","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reconciliations/review-items","href":"/api-reference/reconciliation/live-close-checklist-for-a-date-window"},{"title":"Provisional per-account balance checks (feed vs books)","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reconciliations/account-checks","href":"/api-reference/reconciliation/provisional-per-account-balance-checks-feed-vs-books"},{"title":"The org's one-time non-bank opening (INITIAL_BOOKS)","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reconciliations/opening","href":"/api-reference/reconciliation/the-orgs-one-time-non-bank-opening-initial_books"},{"title":"Save the non-bank opening draft","deprecated":null,"version":null,"openapi":"/openapi.json put /api/reconciliations/opening","href":"/api-reference/reconciliation/save-the-non-bank-opening-draft"},{"title":"Move the cutover the books open on","deprecated":null,"version":null,"openapi":"/openapi.json put /api/reconciliations/opening/cutover","href":"/api-reference/reconciliation/move-the-cutover-the-books-open-on"},{"title":"Post the non-bank opening","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/opening/complete","href":"/api-reference/reconciliation/post-the-non-bank-opening"},{"title":"Reopen the posted non-bank opening","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/opening/reopen","href":"/api-reference/reconciliation/reopen-the-posted-non-bank-opening"},{"title":"Per-account reconcile state (the hub)","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reconciliations/accounts","href":"/api-reference/reconciliation/per-account-reconcile-state-the-hub"},{"title":"One account's reconciliation history (chain)","deprecated":null,"version":null,"openapi":"/openapi.json get /api/reconciliations/accounts/{faId}","href":"/api-reference/reconciliation/one-accounts-reconciliation-history-chain"},{"title":"Start or resume the account's reconciliation at a statement date","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/accounts/{faId}","href":"/api-reference/reconciliation/start-or-resume-the-accounts-reconciliation-at-a-statement-date"},{"title":"Set the statement balance on a draft reconciliation","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/reconciliations/account-balances/{id}","href":"/api-reference/reconciliation/set-the-statement-balance-on-a-draft-reconciliation"},{"title":"Complete (freeze) a reconciliation","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/account-balances/{id}/complete","href":"/api-reference/reconciliation/complete-freeze-a-reconciliation"},{"title":"Reopen (undo) a completed reconciliation","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/account-balances/{id}/reopen","href":"/api-reference/reconciliation/reopen-undo-a-completed-reconciliation"},{"title":"Abandon the account's open (uncompleted) reconciliation draft","deprecated":null,"version":null,"openapi":"/openapi.json post /api/reconciliations/accounts/{faId}/abandon","href":"/api-reference/reconciliation/abandon-the-accounts-open-uncompleted-reconciliation-draft"}]},{"group":"Tax","pages":[{"title":"The jurisdiction's tax line catalog","deprecated":null,"version":null,"openapi":"/openapi.json get /api/tax-filings/targets","href":"/api-reference/tax/the-jurisdictions-tax-line-catalog"}]},{"group":"Automations","pages":[{"title":"List automation rules","deprecated":null,"version":null,"openapi":"/openapi.json get /api/automations/rules","href":"/api-reference/automations/list-automation-rules"},{"title":"Create a rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/automations/rules","href":"/api-reference/automations/create-a-rule"},{"title":"Get a rule","deprecated":null,"version":null,"openapi":"/openapi.json get /api/automations/rules/{id}","href":"/api-reference/automations/get-a-rule"},{"title":"Delete a rule","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/automations/rules/{id}","href":"/api-reference/automations/delete-a-rule"},{"title":"Update a rule","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/automations/rules/{id}","href":"/api-reference/automations/update-a-rule"},{"title":"Pause a rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/automations/rules/{id}/pause","href":"/api-reference/automations/pause-a-rule"},{"title":"Archive a rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/automations/rules/{id}/archive","href":"/api-reference/automations/archive-a-rule"},{"title":"Activate a rule","deprecated":null,"version":null,"openapi":"/openapi.json post /api/automations/rules/{id}/activate","href":"/api-reference/automations/activate-a-rule"}]},{"group":"Merchants","pages":[{"title":"Search merchants by name","deprecated":null,"version":null,"openapi":"/openapi.json get /api/merchants/search","href":"/api-reference/merchants/search-merchants-by-name"},{"title":"List a merchant's activity","deprecated":null,"version":null,"openapi":"/openapi.json get /api/merchants/{id}/activity","href":"/api-reference/merchants/list-a-merchants-activity"},{"title":"Merge merchants","deprecated":null,"version":null,"openapi":"/openapi.json post /api/merchants/{id}/merge","href":"/api-reference/merchants/merge-merchants"},{"title":"Get a merchant","deprecated":null,"version":null,"openapi":"/openapi.json get /api/merchants/{id}","href":"/api-reference/merchants/get-a-merchant"},{"title":"List merchants","deprecated":null,"version":null,"openapi":"/openapi.json get /api/merchants","href":"/api-reference/merchants/list-merchants"}]},{"group":"Projects","pages":[{"title":"List project groups","deprecated":null,"version":null,"openapi":"/openapi.json get /api/projects/groups","href":"/api-reference/projects/list-project-groups"},{"title":"Create a project group","deprecated":null,"version":null,"openapi":"/openapi.json post /api/projects/groups","href":"/api-reference/projects/create-a-project-group"},{"title":"Delete a project group; its projects stay, ungrouped","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/projects/groups/{id}","href":"/api-reference/projects/delete-a-project-group;-its-projects-stay-ungrouped"},{"title":"Rename a project group or change its emoji","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/projects/groups/{id}","href":"/api-reference/projects/rename-a-project-group-or-change-its-emoji"},{"title":"List projects","deprecated":null,"version":null,"openapi":"/openapi.json get /api/projects","href":"/api-reference/projects/list-projects"},{"title":"Create a project","deprecated":null,"version":null,"openapi":"/openapi.json post /api/projects","href":"/api-reference/projects/create-a-project"},{"title":"Get a project","deprecated":null,"version":null,"openapi":"/openapi.json get /api/projects/{id}","href":"/api-reference/projects/get-a-project"},{"title":"Delete a project; its records and lines keep their amounts, with no project","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/projects/{id}","href":"/api-reference/projects/delete-a-project;-its-records-and-lines-keep-their-amounts-with-no-project"},{"title":"Update a project","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/projects/{id}","href":"/api-reference/projects/update-a-project"},{"title":"Count the records a project is on","deprecated":null,"version":null,"openapi":"/openapi.json get /api/projects/{id}/usage","href":"/api-reference/projects/count-the-records-a-project-is-on"}]}]}]}]},"basePath":"","title":"Create a document from an uploaded file - Equated","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}