{
"statusCode": 404,
"statusReasonCode": "CONTRACT_NOT_FOUND",
"error": "Contract not found"
}
Invoice Audits
Create invoice audit
Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Opereit for Developers","colors":{"primary":"#0C55C4","light":"#0C55C4","dark":"#0C55C4"},"logo":{"light":"https://mintcdn.com/opereit/9j1Urm3fK_DUvypy/logo/light.svg?fit=max\u0026auto=format\u0026n=9j1Urm3fK_DUvypy\u0026q=85\u0026s=4608af95a88861de68b83c03ce59241a","dark":"https://mintcdn.com/opereit/9j1Urm3fK_DUvypy/logo/dark.svg?fit=max\u0026auto=format\u0026n=9j1Urm3fK_DUvypy\u0026q=85\u0026s=fb62fc24ca6459562d8c48eceafe81b3"},"favicon":"https://mintcdn.com/opereit/9j1Urm3fK_DUvypy/favicon.png?fit=max\u0026auto=format\u0026n=9j1Urm3fK_DUvypy\u0026q=85\u0026s=9c40a05d586bc0e2b398bdf62372e2c8","api":{"examples":{"languages":["typescript",""]}},"appearance":{"default":"system"},"background":{"decoration":"grid"},"navbar":{"links":[{"href":"mailto:hello@opereit.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.opereit.ai"}},"footer":{"socials":{"github":"https://github.com/opereit","linkedin":"https://linkedin.com/company/obsydian-ai"}},"fonts":{"family":"Inter","weight":400},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"opereit","hasAudioNarration":false,"actualSubdomain":"opereit","customDomains":["developers.opereit.ai"],"gitSource":{"type":"github","owner":"opereit","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae1fe510ab3938238c99c46","collectionId":"bdb10b3b-8346-4926-85cd-4f01028dc315","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1fe510ab3938238c99c46"},"entitlements":{},"buildId":"6ae1fe510ab3938238c99c46","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API reference","count":16},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Claim Management","count":5},{"language":"default","tag":"Contracts","count":4},{"language":"default","tag":"Invoice Audits","count":4},{"language":"default","tag":"Claim documents","count":2},{"language":"default","tag":"Start here","count":2},{"language":"default","tag":"Connectors","count":2},{"language":"default","tag":"Getting started","count":2},{"language":"default","tag":"Webhooks","count":1}]},"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/invoice-audits/create","slug":"/api-reference/endpoint/invoice-audits/create","pageMetadata":{"title":"Create invoice audit","openapi":"POST /v1/invoice-audits","description":"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with `status=PENDING`; auditing runs asynchronously. Poll `GET /v1/invoice-audits` until `status=COMPLETE` to retrieve findings.\n\nAccepted file formats: PDF, CSV.","href":"/api-reference/endpoint/invoice-audits/create"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, 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(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with \", _jsx(_components.code, {\n children: \"status=PENDING\"\n }), \"; auditing runs asynchronously. Poll \", _jsx(_components.code, {\n children: \"GET /v1/invoice-audits\"\n }), \" until \", _jsx(_components.code, {\n children: \"status=COMPLETE\"\n }), \" to retrieve findings.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Accepted file formats: PDF, CSV.\"\n })]\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsx(Note,{children:_jsx(_components.p,{children:`Invoice Auditing needs to be activated on your account before you can use it. Reach out to your Opereit account manager to get it turned on.`})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create invoice audit","openapi":"POST /v1/invoice-audits","description":"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with `status=PENDING`; auditing runs asynchronously. Poll `GET /v1/invoice-audits` until `status=COMPLETE` to retrieve findings.\n\nAccepted file formats: PDF, CSV.","href":"/api-reference/endpoint/invoice-audits/create"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create an invoice audit","description":"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with `status=PENDING`; auditing runs asynchronously. Poll `GET /v1/invoice-audits` until `status=COMPLETE` to retrieve findings.\n\nAccepted file formats: PDF, CSV.","operationId":"createInvoiceAudit","requestBody":"c077af89-1287-4f65-aadb-d13222edc145","responses":{"201":"43e704bc-d666-41ec-b1e3-8806a0e5b3a4","400":"d5230c8d-5df5-40ae-bfab-16b63ac4cb46","401":"cdd49fdc-15d0-4d45-b6b3-6f0eb60616ea","404":"72dd058b-67af-43c4-9e96-f55e104ef1dc"},"method":"post","type":"path","servers":["079abe32-6f90-4e36-b59c-53f74a209f2b"],"security":["9e4f4253-6970-40b4-abf3-c4787f4d03df"],"path":"/v1/invoice-audits","baseUrlOptions":["https://api.opereit.ai"],"title":"Create an invoice audit","codeSamples":[],"requestExampleLanguages":["typescript",""],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file","contract_id"],"properties":{"file":{"type":"string","format":"binary","description":"The carrier invoice document. Accepted MIME types: `application/pdf`, `text/csv`.","isRequired":true,"uniqueKey":"file","typeLabel":"file"},"contract_id":{"type":"string","description":"ID of the contract to audit this invoice against.","isRequired":true,"uniqueKey":"contract_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file":"\u003cstring>","contract_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"43e704bc-d666-41ec-b1e3-8806a0e5b3a4":{"description":"Audit created. Auditing runs asynchronously.","content":{"application/json":{"schema":{"type":"object","properties":{"audit":{"type":"object","description":"An audit of a carrier invoice against a contract.","required":["id","contract_id","status","created_at"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"audit.id","typeLabel":"string"},"contract_id":{"type":"string","description":"Contract this invoice was audited against.","isRequired":true,"uniqueKey":"audit.contract_id","typeLabel":"string"},"status":{"type":"string","enum":["PENDING","INGESTING","AUDITING","COMPLETE","FAILED"],"description":"Audit lifecycle state.\n\n- `PENDING`: queued for processing.\n- `INGESTING`: parsing the invoice file.\n- `AUDITING`: running audit rules.\n- `COMPLETE`: line items and findings are available.\n- `FAILED`: audit failed; see `status_reason`.","isRequired":true,"uniqueKey":"audit.status","typeLabel":"enum\u003cstring>"},"created_at":{"type":"string","format":"date-time","description":"When the audit was created.","isRequired":true,"uniqueKey":"audit.created_at","typeLabel":"string\u003cdate-time>"},"carrier_name":{"oneOf":[{"type":"string","description":"Carrier name (denormalized from the contract for convenience).","uniqueKey":"audit.carrier_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Carrier name (denormalized from the contract for convenience).","uniqueKey":"audit.carrier_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.carrier_name","typeLabel":"string | null"},"status_reason":{"oneOf":[{"type":"string","description":"Explanation when `status=FAILED`.","uniqueKey":"audit.status_reason.oneOf.0","typeLabel":"string"},{"type":"null","description":"Explanation when `status=FAILED`.","uniqueKey":"audit.status_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.status_reason","typeLabel":"string | null"},"total_line_items":{"oneOf":[{"type":"integer","description":"Total line items extracted from the invoice. `null` until ingestion completes.","uniqueKey":"audit.total_line_items.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Total line items extracted from the invoice. `null` until ingestion completes.","uniqueKey":"audit.total_line_items.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.total_line_items","typeLabel":"integer | null"},"completed_at":{"oneOf":[{"type":"string","format":"date-time","description":"When the audit reached a terminal state (`COMPLETE` or `FAILED`).","uniqueKey":"audit.completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"When the audit reached a terminal state (`COMPLETE` or `FAILED`).","uniqueKey":"audit.completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.completed_at","typeLabel":"string\u003cdate-time> | null"},"file":{"oneOf":[{"type":"object","description":"Metadata about the uploaded invoice file.","required":["id","file_url","file_name","original_file_name","created_at"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"audit.file.oneOf.0.id","typeLabel":"string"},"file_url":{"type":"string","format":"uri","description":"Time-limited URL to download the original invoice file.","isRequired":true,"uniqueKey":"audit.file.oneOf.0.file_url","typeLabel":"string\u003curi>"},"file_name":{"type":"string","description":"Storage filename.","isRequired":true,"uniqueKey":"audit.file.oneOf.0.file_name","typeLabel":"string"},"original_file_name":{"type":"string","description":"Filename as uploaded by the client.","isRequired":true,"uniqueKey":"audit.file.oneOf.0.original_file_name","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"When the invoice was uploaded.","isRequired":true,"uniqueKey":"audit.file.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"file_size_bytes":{"oneOf":[{"type":"integer","description":"File size in bytes.","uniqueKey":"audit.file.oneOf.0.file_size_bytes.oneOf.0","typeLabel":"integer"},{"type":"null","description":"File size in bytes.","uniqueKey":"audit.file.oneOf.0.file_size_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.file_size_bytes","typeLabel":"integer | null"},"invoice_number":{"oneOf":[{"type":"string","description":"Carrier invoice number, extracted from the document.","uniqueKey":"audit.file.oneOf.0.invoice_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"Carrier invoice number, extracted from the document.","uniqueKey":"audit.file.oneOf.0.invoice_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.invoice_number","typeLabel":"string | null"},"invoice_date":{"oneOf":[{"type":"string","format":"date","description":"Date on the invoice, extracted from the document.","uniqueKey":"audit.file.oneOf.0.invoice_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date on the invoice, extracted from the document.","uniqueKey":"audit.file.oneOf.0.invoice_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.invoice_date","typeLabel":"string\u003cdate> | null"},"account_number":{"oneOf":[{"type":"string","description":"Carrier account number on the invoice.","uniqueKey":"audit.file.oneOf.0.account_number.oneOf.0","typeLabel":"string"},{"type":"null","description":"Carrier account number on the invoice.","uniqueKey":"audit.file.oneOf.0.account_number.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.account_number","typeLabel":"string | null"},"billing_period_start":{"oneOf":[{"type":"string","format":"date","description":"Start of the billing period covered by the invoice.","uniqueKey":"audit.file.oneOf.0.billing_period_start.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Start of the billing period covered by the invoice.","uniqueKey":"audit.file.oneOf.0.billing_period_start.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.billing_period_start","typeLabel":"string\u003cdate> | null"},"billing_period_end":{"oneOf":[{"type":"string","format":"date","description":"End of the billing period covered by the invoice.","uniqueKey":"audit.file.oneOf.0.billing_period_end.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"End of the billing period covered by the invoice.","uniqueKey":"audit.file.oneOf.0.billing_period_end.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.billing_period_end","typeLabel":"string\u003cdate> | null"},"currency":{"oneOf":[{"type":"string","description":"ISO 4217 currency code the invoice is denominated in.","uniqueKey":"audit.file.oneOf.0.currency.oneOf.0","typeLabel":"string"},{"type":"null","description":"ISO 4217 currency code the invoice is denominated in.","uniqueKey":"audit.file.oneOf.0.currency.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file.oneOf.0.currency","typeLabel":"string | null"}},"uniqueKey":"audit.file.oneOf.0","typeLabel":"object"},{"type":"null","description":"Metadata about the uploaded invoice file.","uniqueKey":"audit.file.oneOf.1","typeLabel":"null"}],"uniqueKey":"audit.file","typeLabel":"object | null"}},"uniqueKey":"audit","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"audit":{"id":"\u003cstring>","contract_id":"\u003cstring>","status":"PENDING","created_at":"2023-11-07T05:31:56Z","carrier_name":"\u003cstring>","status_reason":"\u003cstring>","total_line_items":123,"completed_at":"2023-11-07T05:31:56Z","file":{"id":"\u003cstring>","file_url":"\u003cstring>","file_name":"\u003cstring>","original_file_name":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","file_size_bytes":123,"invoice_number":"\u003cstring>","invoice_date":"2023-12-25","account_number":"\u003cstring>","billing_period_start":"2023-12-25","billing_period_end":"2023-12-25","currency":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d5230c8d-5df5-40ae-bfab-16b63ac4cb46":{"description":"The request was malformed or failed validation.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every endpoint.","required":["statusCode","statusReasonCode","error"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code — same value as the response status.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"statusReasonCode":{"type":"string","enum":["INVALID_REQUEST_BODY","INVALID_QUERY_PARAMETERS","UNSUPPORTED_DOCUMENT_CONTENT_TYPE","CLAIM_NOT_FOUND","CLAIM_ALREADY_EXISTS","CONTRACT_NOT_FOUND","INVOICE_AUDIT_NOT_FOUND","INTERNAL_ERROR","AUTHENTICATION_REQUIRED","INVALID_CREDENTIALS_FORMAT","INVALID_CREDENTIALS_ENCODING","INVALID_CREDENTIALS"],"description":"Machine-readable error code.","isRequired":true,"uniqueKey":"statusReasonCode","typeLabel":"enum\u003cstring>"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present on `400` responses. `formErrors` holds errors not tied to a specific field; `fieldErrors` maps a top-level request field to the list of validation messages raised under it.","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"details.formErrors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.fieldErrors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"details.fieldErrors","typeLabel":"object"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"statusReasonCode":"INVALID_REQUEST_BODY","error":"Invalid request body","details":{"formErrors":[],"fieldErrors":{}}},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"statusReasonCode":"INVALID_REQUEST_BODY","error":"Invalid request body","details":{"formErrors":[],"fieldErrors":{}}}}},"exampleType":"examples"}},"exampleType":"examples"},"cdd49fdc-15d0-4d45-b6b3-6f0eb60616ea":{"description":"Authentication is missing or invalid.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every endpoint.","required":["statusCode","statusReasonCode","error"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code — same value as the response status.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"statusReasonCode":{"type":"string","enum":["INVALID_REQUEST_BODY","INVALID_QUERY_PARAMETERS","UNSUPPORTED_DOCUMENT_CONTENT_TYPE","CLAIM_NOT_FOUND","CLAIM_ALREADY_EXISTS","CONTRACT_NOT_FOUND","INVOICE_AUDIT_NOT_FOUND","INTERNAL_ERROR","AUTHENTICATION_REQUIRED","INVALID_CREDENTIALS_FORMAT","INVALID_CREDENTIALS_ENCODING","INVALID_CREDENTIALS"],"description":"Machine-readable error code.","isRequired":true,"uniqueKey":"statusReasonCode","typeLabel":"enum\u003cstring>"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present on `400` responses. `formErrors` holds errors not tied to a specific field; `fieldErrors` maps a top-level request field to the list of validation messages raised under it.","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"details.formErrors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.fieldErrors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"details.fieldErrors","typeLabel":"object"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":401,"statusReasonCode":"AUTHENTICATION_REQUIRED","error":"Authentication required"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"statusReasonCode":"AUTHENTICATION_REQUIRED","error":"Authentication required"}}},"exampleType":"examples"}},"exampleType":"examples"},"72dd058b-67af-43c4-9e96-f55e104ef1dc":{"description":"The contract does not exist, or belongs to a different organization.","content":{"application/json":{"schema":{"type":"object","description":"Error envelope returned by every endpoint.","required":["statusCode","statusReasonCode","error"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code — same value as the response status.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"statusReasonCode":{"type":"string","enum":["INVALID_REQUEST_BODY","INVALID_QUERY_PARAMETERS","UNSUPPORTED_DOCUMENT_CONTENT_TYPE","CLAIM_NOT_FOUND","CLAIM_ALREADY_EXISTS","CONTRACT_NOT_FOUND","INVOICE_AUDIT_NOT_FOUND","INTERNAL_ERROR","AUTHENTICATION_REQUIRED","INVALID_CREDENTIALS_FORMAT","INVALID_CREDENTIALS_ENCODING","INVALID_CREDENTIALS"],"description":"Machine-readable error code.","isRequired":true,"uniqueKey":"statusReasonCode","typeLabel":"enum\u003cstring>"},"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"object","description":"Present on `400` responses. `formErrors` holds errors not tied to a specific field; `fieldErrors` maps a top-level request field to the list of validation messages raised under it.","properties":{"formErrors":{"type":"array","items":{"type":"string","uniqueKey":"details.formErrors.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.formErrors","typeLabel":"string[]"},"fieldErrors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"details.fieldErrors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"details.fieldErrors.additionalProperties","typeLabel":"string[]"},"uniqueKey":"details.fieldErrors","typeLabel":"object"}},"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":404,"statusReasonCode":"CONTRACT_NOT_FOUND","error":"Contract not found"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"statusReasonCode":"CONTRACT_NOT_FOUND","error":"Contract not found"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9e4f4253-6970-40b4-abf3-c4787f4d03df":{"apiKey":{"type":"http","scheme":"basic","description":"HTTP Basic Auth using your API key. Send `Authorization: Basic base64(key_id:key_secret)`.","scopes":[],"schemeName":"apiKey"}}},"servers":{"079abe32-6f90-4e36-b59c-53f74a209f2b":{"url":"https://api.opereit.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"HTTP Basic Auth using your API key. Send `Authorization: Basic base64(key_id:key_secret)`.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Basic Auth","type":"object","description":"HTTP Basic Auth using your API key. Send `Authorization: Basic base64(key_id:key_secret)`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"opereit","siteName":"Opereit for Developers","title":"Create invoice audit - Opereit for Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T13:35:26.514Z","gitLastModified":"2026-08-25T13:35:05.000Z","originalFileLocation":"api-reference/endpoint/invoice-audits/create.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=\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings. Accepted file formats: PDF, CSV.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Opereit for Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_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/opereit/KKL-I9qKEVNYIEaR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create invoice audit - Opereit for Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings. Accepted file formats: PDF, CSV.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Opereit for Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://opereit.mintlify.app/_mintlify/api/og/v2?division=Invoice+Audits\u0026amp;title=Create+invoice+audit\u0026amp;description=Upload+a+carrier+invoice+and+audit+it+against+the+rates+and+surcharges+of+an+existing+contract.+Returns+immediately+with+%60status%3DPENDING%60%3B+auditing+runs+asynchr\u0026amp;theme=f936422abecfeaf0fc9e3af5\u0026amp;signature=237f9ebf3ef660cd2791262eed9bb664ecac53b068858dde588f957d2343eb6d\">\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 invoice audit - Opereit for Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings. Accepted file formats: PDF, CSV.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://opereit.mintlify.app/_mintlify/api/og/v2?division=Invoice+Audits\u0026amp;title=Create+invoice+audit\u0026amp;description=Upload+a+carrier+invoice+and+audit+it+against+the+rates+and+surcharges+of+an+existing+contract.+Returns+immediately+with+%60status%3DPENDING%60%3B+auditing+runs+asynchr\u0026amp;theme=f936422abecfeaf0fc9e3af5\u0026amp;signature=237f9ebf3ef660cd2791262eed9bb664ecac53b068858dde588f957d2343eb6d\">\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/opereit/KKL-I9qKEVNYIEaR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Opereit for Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C55C4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/invoice-audits/create.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.opereit.ai/#organization\",\"name\":\"Opereit for Developers\",\"url\":\"https://developers.opereit.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/opereit/9j1Urm3fK_DUvypy/logo/light.svg?fit=max\u0026auto=format\u0026n=9j1Urm3fK_DUvypy\u0026q=85\u0026s=4608af95a88861de68b83c03ce59241a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.opereit.ai#website\",\"name\":\"Opereit for Developers\",\"url\":\"https://developers.opereit.ai\",\"publisher\":{\"@id\":\"https://developers.opereit.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create#webpage\",\"url\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create\",\"name\":\"Create invoice audit\",\"description\":\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings. Accepted file formats: PDF, CSV.\",\"dateModified\":\"2026-08-25T13:35:05.000Z\",\"isPartOf\":{\"@id\":\"https://developers.opereit.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Opereit for Developers\",\"item\":\"https://developers.opereit.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create invoice audit\",\"item\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create#apireference\",\"headline\":\"Create invoice audit\",\"name\":\"Create invoice audit\",\"description\":\"Upload a carrier invoice and audit it against the rates and surcharges of an existing contract. Returns immediately with status=PENDING; auditing runs asynchronously. Poll GET /v1/invoice-audits until status=COMPLETE to retrieve findings. Accepted file formats: PDF, CSV.\",\"url\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create\",\"mainEntityOfPage\":{\"@id\":\"https://developers.opereit.ai/api-reference/endpoint/invoice-audits/create#webpage\"},\"dateModified\":\"2026-08-25T13:35:05.000Z\",\"publisher\":{\"@id\":\"https://developers.opereit.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.opereit.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Opereit for Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Opereit for Developers","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Start here","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Check your API key","openapi":"GET /v1/ping","href":"/api-reference/endpoint/ping"}]},{"group":"Claim Management","pages":[{"title":"List claims","openapi":"GET /v1/claims","href":"/api-reference/endpoint/claims/list"},{"title":"Create a claim","openapi":"POST /v1/claims","href":"/api-reference/endpoint/claims/create"},{"title":"Get a claim","openapi":"GET /v1/claims/{id}","href":"/api-reference/endpoint/claims/get"}]},{"group":"Claim documents","pages":[{"title":"Initiate document upload","openapi":"POST /v1/claims/{id}/documents","href":"/api-reference/endpoint/claims/documents/initiate"},{"title":"Confirm document upload","openapi":"POST /v1/claims/{id}/documents/complete","href":"/api-reference/endpoint/claims/documents/complete"}]},{"group":"Contracts","pages":[{"title":"Upload contract","openapi":"POST /v1/contracts","href":"/api-reference/endpoint/contracts/upload"},{"title":"List contracts","openapi":"GET /v1/contracts","href":"/api-reference/endpoint/contracts/list"},{"title":"List contract rates","openapi":"GET /v1/contracts/{contract_id}/rates","href":"/api-reference/endpoint/contracts/list-rates"},{"title":"List contract surcharges","openapi":"GET /v1/contracts/{contract_id}/surcharges","description":"Returns a cursor-paginated list of surcharges extracted from a contract (fuel, residential delivery, peak-season, etc.).","href":"/api-reference/endpoint/contracts/list-surcharges"}]},{"group":"Invoice Audits","pages":[{"title":"Create invoice audit","openapi":"POST /v1/invoice-audits","href":"/api-reference/endpoint/invoice-audits/create"},{"title":"List invoice audits","openapi":"GET /v1/invoice-audits","description":"Returns a cursor-paginated list of invoice audits.","href":"/api-reference/endpoint/invoice-audits/list"},{"title":"List line items","openapi":"GET /v1/invoice-audits/{audit_id}/line-items","href":"/api-reference/endpoint/invoice-audits/list-line-items"},{"title":"List findings","openapi":"GET /v1/invoice-audits/{audit_id}/findings","href":"/api-reference/endpoint/invoice-audits/list-findings"}]},{"group":"Webhooks","pages":[{"title":"Webhooks","href":"/api-reference/webhooks"}]}]}]},"title":"Create invoice audit - Opereit for Developers","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}