---
title: "AWB Data Extraction"
method: POST
path: "/ai/awb"
---

# AWB Data Extraction

`POST /ai/awb`

## Request

- Base URL: `https://api.cargoai.co/solutions`
- URL: `https://api.cargoai.co/solutions/ai/awb`
- Auth: API key in header `x-api-key`

AI Powered - Transform AWB image data into structured AWB information and remove manual data entry from your AWB transmission process.

## Headers

- `x-api-key` string, required

## Request body

- object
  - `email` string, required: Requester email address
  - `data` string, required: Base64 encoded image for IMAGE. When type is PDF, data is the s3Url returned by POST /solutions/ai/uploads (an s3://… URI), not a base64 payload.
  - `type` 'IMAGE' | 'PDF', required: media type (IMAGE, PDF)

## Response `200`

200

- object
  - `awb` object
    - `shipper` object
      - `name` string
      - `account_number` string
      - `phone` string
      - `fax` unknown
      - `email` string
      - `address` object
        - `line1` string
        - `line2` string
        - `place` string
        - `city` object
          - `code` string
          - `name` string
        - `postal_code` string
        - `state_province` string
        - `country` object
          - `code` string
          - `name` string
      - `eori` string
    - `consignee` object
      - `name` string
      - `account_number` unknown
      - `phone` string
      - `fax` unknown
      - `email` string
      - `address` object
        - `line1` string
        - `line2` string
        - `place` string
        - `city` object
          - `code` string
          - `name` string
        - `postal_code` string
        - `state_province` string
        - `country` object
          - `code` string
          - `name` string
      - `eori` string
    - `notify` object
      - `name` string
      - `account_number` unknown
      - `phone` unknown
      - `fax` unknown
      - `email` string
      - `address` object
        - `line1` string
        - `line2` string
        - `place` string
        - `city` object
          - `code` string
          - `name` string
        - `postal_code` string
        - `state_province` string
        - `country` object
          - `code` string
          - `name` string
      - `eori` string
    - `routingDetails` object[]
      - `from_airport_code` string
      - `to_airport_code` string
      - `carrier_code` string
      - `flight_number` string
      - `flight_date` string
    - `chargesDeclaration` object
      - `currency_code` string
      - `charge_code` string
      - `weight_or_valuation` string
      - `other` string
      - `values_for_carriage` integer
      - `values_for_custom` integer
      - `values_for_insurance` integer
    - `rates` object[]
      - `number_of_pieces` integer
      - `gross_weight` object
        - `value` number
        - `uom` string
      - `volume` object
        - `value` integer
        - `uom` string
      - `slac` integer
      - `rate_class_code` string
      - `commodity_item_number` string
      - `chargeable_weight` integer
      - `rate_or_charge` number
      - `charge_amount` number
      - `nature_and_quantity_of_goods` string
      - `dims` object[]
        - `pcs` integer
        - `length` integer
        - `width` integer
        - `height` integer
        - `weight` integer
        - `Volume` integer
        - `uom` string
      - `uld` object[]
      - `hsc` unknown
    - `execution` object
      - `date` string
      - `place` string
      - `shipper_signature` string
      - `carrier_signature` string
    - `oci` object
      - `origin_country_code` string
    - `agent` object
      - `iata` string
      - `cass` string
      - `name` string
      - `place` string
    - `handling` object
      - `shc` string
      - `other_info` string
      - `sci` string
    - `otherCharges` unknown
  - `awb_number` string
  - `confidenceScore` number

## Other responses

- `400`: 400
- `402`: Payment Required
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-11-03** `dfd7950d43d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cargoai/apis/solutions/changes/ai/awb/post.md)

---

[API](https://skmtc.dev/cargoai/apis/solutions.md) - [All operations](https://skmtc.dev/cargoai/apis/solutions/llms.txt) - [OpenAPI document](https://skmtc.dev/cargoai/apis/solutions/revisions/dfd7950d43d7?raw)