# Freight & Customs API

> Read supplied invoices, packing lists, and bills of lading, cross-check quantities, weights, values, and parties, and suggest HS code candidates from the public UK Trade Tariff. No declaration is submitted.

- Product: https://www.brainiac.software/api/freight-customs
- Docs: https://www.brainiac.software/api/freight-customs/docs
- OpenAPI: https://www.brainiac.software/api/freight-customs/openapi.json
- Contact: support@brainiac.software (https://www.brainiac.software/contact)

## Operations

- POST /api/v1/freight-customs/shipping-document-extract — $0.05 USDC — Extract a shipping document: Read parties, addresses, goods lines, weights, values, and references from supplied shipment text or a text-based PDF. Fields that are not printed are left empty. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-shipping-document-extract
- POST /api/v1/freight-customs/commercial-invoice-validate — $0.05 USDC — Validate a commercial invoice: Check that supplied invoice lines, quantities, and amounts agree, and that the seller, buyer, currency, and total are present. No duty is calculated. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-commercial-invoice-validate
- POST /api/v1/freight-customs/packing-list-validate — $0.04 USDC — Validate a packing list: Check package counts and net and gross weights on a supplied packing list. A missing weight is not treated as zero. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-packing-list-validate
- POST /api/v1/freight-customs/bill-of-lading-extract — $0.05 USDC — Extract a bill of lading: Read the bill of lading number, shipper, consignee, container, and weight from supplied text. No shipment is booked. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-bill-of-lading-extract
- POST /api/v1/freight-customs/shipment-document-consistency — $0.06 USDC — Cross-check shipment documents: Compare references, parties, quantities, and weights across at least two supplied documents. A field that appears on only one document is reported separately from a conflict. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-shipment-document-consistency
- POST /api/v1/freight-customs/hs-code-candidate-suggest — $0.06 USDC — Suggest HS code candidates: Search the public UK Trade Tariff for commodity candidates matching a goods description. The result is not a customs classification and does not state a duty. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-hs-code-candidate-suggest
- POST /api/v1/freight-customs/data-completeness — $0.04 USDC — Check customs data completeness: List shipment fields that are present or missing in the supplied documents. Duty, restrictions, sanctions, and country-specific requirements stay unverified. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-data-completeness
- POST /api/v1/freight-customs/shipment-weight-volume-calculate — $0.03 USDC — Calculate shipment weight and volume: Sum supplied package weights and calculate volume from centimetre dimensions. Volumetric weight is calculated only when the request includes a divisor. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-shipment-weight-volume-calculate
- POST /api/v1/freight-customs/incoterms-obligation-extract — $0.04 USDC — Extract Incoterms obligations: Read a named Incoterms rule and its named place from the request. The obligation text is that named rule. No duty amount is calculated. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-incoterms-obligation-extract
- POST /api/v1/freight-customs/preparation-report — $0.12 USDC — Prepare a customs evidence report: Combine document checks, weight evidence, the named Incoterm, and UK Trade Tariff candidates. No declaration is submitted and no shipment is booked. Docs: https://www.brainiac.software/api/freight-customs/docs#freight-customs-preparation-report