Invoice API documentation

One invoice. One job ID. A result your application can use.

Integrate invoice extraction and document processing through the Number7 AI API. Upload a document, retain its job ID and retrieve the structured result by polling or a signed completion webhook.

Start with one invoice Discuss your integration

01 · SubmitFile or supported URLPOST /upload

02 · TrackRetain the job IDdata.jobId

03 · RetrieveRead completion statusdata.fileStatus

04 · UseYour application decidesReview · approval · action

The documented API returns document data and processing state. A completed job does not establish vendor validity, approval, posting or payment.

Quickstart

Authenticate, upload one invoice and retrieve its job result.

Completion webhooks

Verify the raw payload before handling a completion callback.

Errors & retries

Choose whether to correct, wait, reconcile or escalate.

Contract availability

Check what is published and request the verified integration contract.

Documentation updates

See revisions to documentation and examples.

The first request uses multipart upload.

Use the published invoice type and v1 query parameters. Persist data.jobId from the response before you begin polling.

Invoice upload · cURL

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'

Follow the result lookup

Keep the integration boundary visible.

Number7 AI API

Process the document

Accept a supported source, process it asynchronously and return the documented result and status.

Your application

Own the business workflow

Apply required fields, client context, review, approval and downstream action. Retain the original source and job identifier.

Explore the document API Explore the full AP workflow