Skip to main content
The Data Extraction APIs are hosted on a separate platform and do not share authentication with the core eBRC APIs. To get a dedicated Tradelens API key, contact amin@eximfiles.io.

Overview

The Data Extraction APIs turn export documents into structured JSON. Extract rows from shipping bill PDFs to prepare a bulk eBRC upload, or pull billing data out of invoice PDFs.

Base URL

All Data Extraction API requests should be made to:

Authentication

These endpoints authenticate with a Tradelens API key, a separate key from your eBRC API key, sent in the same header style:

Supported document types

Shipping bills

Exporter details, consignee information, product descriptions, quantities and values, and shipping details. Two variants: eBRC-specific fields or the complete document.

Invoices

Vendor and supplier information, line items, amounts and totals, tax information, and payment terms. See Extract Invoice Data.

Request format

  • All requests use multipart/form-data encoding
  • Upload documents as file attachments
  • Supported file format: PDF
  • Maximum file size: 5 MB per document

Response format

Extraction responses are JSON with a status and a document-specific data object:

Error handling

  • 400 - Invalid file format or corrupted document
  • 401 - Invalid or missing API key
  • 413 - File size exceeds limit
  • 422 - Document processing failed
  • 429 - Rate limit exceeded
  • 500 - Internal processing error

Need help?

Contact us

For help with Data Extraction APIs, email amin@eximfiles.io