BY NUMBER7 AIOpen AIdaptIQ ↗Book a demo →Invoice extraction & document processing API
Submit a file or supported document URL, retain the returned job ID and retrieve structured results. Your application owns downstream review, approval and action.
Example invoice · LAB-101File → job → result
POST /api/v1/uploadUpload the document. Processing is asynchronous; upload acceptance is the start of a job.
data.jobIdRetain the returned job ID. Use it to retrieve the result, or associate a verified completion callback with the same job.
data.fileStatusCheck the terminal status. A completed document result is ready for your application’s review and business controls.
Follow the documented job flow with LAB-101. Test the API with your own credentials to inspect the returned result.
Published v1 contract
curl --fail-with-body --request POST \
'https://api.number7ai.com/api/v1/upload?document.type=invoice&document.version=v1' \
--header "Authorization: Bearer $N7_API_KEY" \
--form 'file=@invoice.pdf' \
--form 'fileName=invoice.pdf' \
--form 'fileType=application/pdf'Read and persist data.jobId from the response. Upload acceptance means a job exists; it does not mean processing is complete.
curl --fail-with-body \
'https://api.number7ai.com/api/v1/results/YOUR_JOB_ID' \
--header "Authorization: Bearer $N7_API_KEY"Check data.fileStatus. done means a result is available; failed needs error handling.
The examples use the published request and status names. The completed business-data schema must come from the verified contract for your integration; this site does not invent an invoice response.
A clear ownership boundary
Returns the documented structured document result and processing status.
Checks required accounting fields, routes uncertain cases and owns downstream review, approval and action unless separately implemented.
Extraction completion alone does not establish a valid vendor, approved bill or successful accounting posting. Keep source evidence and the returned job identifier attached to the work.
Asynchronous by design
POST /uploaddata.jobIddata.fileStatus| Status | What your application does |
|---|---|
uploading · processing · scanning · ai_processing | Continue bounded polling or wait for the configured completion webhook. |
done | Retrieve and validate the structured result against the requirements of your workflow. |
failed | Handle the documented job failure and surface the next action. |
Implementation checkpoints
Use Bearer-token authentication. Scope credentials to the agreed account and environment.
The guide recommends polling about every 20 seconds with a timeout. Do not poll indefinitely.
Read the polling guidanceAuthenticate the raw payload before parsing it, then handle duplicate delivery safely.
Read webhook verificationIf a timeout may follow acceptance, reconcile before resubmission. Do not assume an idempotency header exists outside your agreed contract.
Read errors and retriesTry the same source files
The example pack includes a four-page PDF containing two invoices and one credit note. Pages 2–3 belong to one bill. Compare the actual output of the API you evaluate with the answer key.
Compare document boundaries and accounting amounts, then record the API’s result on the same files.
Next step
Map result fields, operational limits, webhook handling and downstream ownership with the product team.
Scope and action
Request the verified integration contract and hosting scope. Public guidance is not a validated machine-readable specification or a promise of SDK availability.
Action: Scope agreement required.
Read the workflow scopeThe recorded product-owner confirmation applies to the named capabilities. Deployment scope, integration permissions and approval requirements are agreed separately.