M
Production API v1

Freight-document intelligence inside your workflow.

Submit PDFs, track durable processing, retrieve structured data, download Excel or CSV files, and receive signed status events—without creating a second document silo.

Start the quickstart Explore API reference

API access is available on Scale and Custom plans.

Submit a document
curl -X POST "https://manifestai.io/api/v1/documents" \
  -H "Authorization: Bearer $MANIFEST_AI_API_KEY" \
  -H "Idempotency-Key: shipment-1042-invoice" \
  -F "file=@commercial-invoice.pdf" \
  -F "profile_id=YOUR_PROFILE_ID"

Scoped credentials

One-time secret reveal, expiry, rotation, and immediate revocation.

Safe submission retries

Required idempotency and duplicate protection prevent repeated work.

Signed events

HMAC-signed, retry-safe completion events with endpoint restrictions.

One workspace

API and portal documents share credits, retention, history, and exports.

One durable lifecycle

From PDF submission to operational data.

The API is asynchronous by design, so long document jobs survive client disconnects and can be observed through polling or webhooks.

  1. 01

    Submit

    Send an authorized PDF with a saved layout profile or approved field definition. Credits and duplicates are checked before queueing.

  2. 02

    Process

    Manifest AI checkpoints work page by page, applies operational quality checks, and keeps current state available through one document resource.

  3. 03

    Consume

    Retrieve structured fields in JSON, download Excel or exact-column CSV, and reopen the same record in the portal when human context is needed.

Stable REST surface

Small enough to learn. Complete enough to operate.

API v1 covers entitlement discovery, reusable layouts, destination templates, durable document processing, lifecycle controls, structured results, Excel or CSV exports, and privacy deletion.

Read the complete reference
GET/api/v1/account

Credits, scopes, and current limits

GET/api/v1/profiles

Saved layout profiles

GET/api/v1/export-templates

Exact destination column templates

POST/api/v1/documents

Submit a PDF for durable processing

GET/api/v1/documents/{id}

Status and retained structured result

POST/api/v1/documents/{id}/actions

Pause, resume, or cancel

GET/api/v1/documents/{id}/export

Download Excel or request UTF-8 CSV

Built for server-to-server use

Security controls that are part of the contract.

  • Workspace-scoped authorization and least-privilege key scopes.
  • Required idempotency and file-level duplicate protection.
  • Weighted rate limits, active-job quotas, and page-credit controls.
  • Restricted public HTTPS webhook targets with signed delivery.
  • Temporary encrypted PDF storage and explicit result deletion.
  • Request IDs and audit events for operational traceability.
Read security and data handling
Accepted response
{
  "data": {
    "id": "doc_01K1...",
    "object": "document",
    "status": "queued",
    "page_count": 12,
    "source": "api",
    "links": {
      "self": "/api/v1/documents/doc_01K1...",
      "export": "/api/v1/documents/doc_01K1.../export",
      "portal": "/dashboard?job=doc_01K1..."
    }
  }
}
Integration patterns

Connect document data to the workflow you already run.

TMS and ERP imports

Convert reviewed freight documents into the exact columns required by downstream systems.

Shared inbox automation

Pair an authorized email-ingestion service with API submission and signed completion events.

Operations queues

Show document status inside internal shipment, brokerage, or finance tools.

Batch reconciliation

Submit controlled batches and compare invoice totals, line items, and packing-list data.

Customer portals

Let authenticated customers initiate work while keys and document processing remain server-side.

Data retention workflows

Export required records and delete retained customer content when business retention ends.

Developer FAQ

Answers before you integrate.

Which plans include API access?+

Scale includes production API access and signed webhooks. Custom supports agreed limits and integration requirements. Free Validation and Professional use the secure web workspace.

Do API documents appear in the portal?+

Yes. Portal uploads and API submissions share one workspace, document history, page-credit balance, retention controls, and result access.

How are duplicate requests prevented?+

Every submission requires an Idempotency-Key, and file fingerprints provide a second guard against accidental double processing.

Can a webhook include extracted customer data?+

Webhook events contain identifiers, status, and resource links. The receiving server retrieves the current result through the authenticated API.

Build your first secure document workflow.

Follow the quickstart, validate the complete lifecycle, then request Scale access for production API credentials.

Open quickstart Request Scale