Submit Manifest - CrossBorderly API

{
  "idempotencyKey": "manifest-2024-001",
  "awbNumber": "180-12345678",
  "flightNumber": "LA2480",
  "flightDate": "2024-12-25",
  "originAirport": "MIA",
  "destinationAirport": "UIO",
  "carrier": "LATAM Airlines",
  "country": "EC",
  "parcels": [
    {
      "trackingNumber": "CBECUSD123456789",
      "bagCode": "BAG-A001-001",
      "ConsigneeName": "María García",
      "Dni": "1234567890"
    },
    {
      "trackingNumber": "CBECUSD123456790",
      "bagCode": "BAG-A001-001"
    },
    {
      "trackingNumber": "CBECUSD123456791",
      "bagCode": "BAG-A001-002"
    }
  ]
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 3,
    "totalWeight": 7.5
  },
  "linked": 3,
  "notFound": []
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 2,
    "totalWeight": 5.0
  },
  "linked": 2,
  "notFound": ["INVALID123456789"]
}

{
  "success": false,
  "error": {
    "code": "MANIFEST_LOCKED",
    "message": "This AWB has already been submitted and cannot be modified",
    "message_es": "Esta guía aérea ya fue enviada y no puede ser modificada",
    "requestId": "req_abc123"
  }
}

POST

api

manifests

submit

{
  "idempotencyKey": "manifest-2024-001",
  "awbNumber": "180-12345678",
  "flightNumber": "LA2480",
  "flightDate": "2024-12-25",
  "originAirport": "MIA",
  "destinationAirport": "UIO",
  "carrier": "LATAM Airlines",
  "country": "EC",
  "parcels": [
    {
      "trackingNumber": "CBECUSD123456789",
      "bagCode": "BAG-A001-001",
      "ConsigneeName": "María García",
      "Dni": "1234567890"
    },
    {
      "trackingNumber": "CBECUSD123456790",
      "bagCode": "BAG-A001-001"
    },
    {
      "trackingNumber": "CBECUSD123456791",
      "bagCode": "BAG-A001-002"
    }
  ]
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 3,
    "totalWeight": 7.5
  },
  "linked": 3,
  "notFound": []
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 2,
    "totalWeight": 5.0
  },
  "linked": 2,
  "notFound": ["INVALID123456789"]
}

{
  "success": false,
  "error": {
    "code": "MANIFEST_LOCKED",
    "message": "This AWB has already been submitted and cannot be modified",
    "message_es": "Esta guía aérea ya fue enviada y no puede ser modificada",
    "requestId": "req_abc123"
  }
}

Submits a manifest that groups multiple parcels under an Air Waybill (AWB) for a single shipment. This is typically done before parcels are handed over to the carrier.

Request Body

string

Optional unique key to prevent duplicate submissions (8-64 characters).

string

required

Air Waybill number (8-20 characters). Format: XXX-XXXXXXXX (carrier prefix + 8 digits).

string

Flight number (e.g., LA2480).

string

Scheduled flight date in YYYY-MM-DD format.

string

Origin airport code (e.g., MIA).

string

Destination airport code (e.g., UIO).

string

Carrier name (e.g., LATAM Airlines).

string

Destination country code (2-letter ISO).

array

required

List of parcels to include in the manifest.

Show Parcel fields

string

required

Tracking number of an existing parcel.

string

Bag code for grouping parcels (e.g., BAG-A001-001).

string

Receiver name (for validation).

string

Receiver national ID (for validation).

string

Base64-encoded AWB PDF document.

Response

boolean

Whether the manifest was submitted successfully

object

The created shipment details

Show Shipment fields

string

Unique shipment ID

string

The AWB number

string

Shipment status (MANIFEST_SUBMITTED)

integer

Number of parcels in the manifest

number

Combined weight of all parcels (lbs)

integer

Number of parcels successfully linked to the shipment

array

Tracking numbers that were not found in the system

{
  "idempotencyKey": "manifest-2024-001",
  "awbNumber": "180-12345678",
  "flightNumber": "LA2480",
  "flightDate": "2024-12-25",
  "originAirport": "MIA",
  "destinationAirport": "UIO",
  "carrier": "LATAM Airlines",
  "country": "EC",
  "parcels": [
    {
      "trackingNumber": "CBECUSD123456789",
      "bagCode": "BAG-A001-001",
      "ConsigneeName": "María García",
      "Dni": "1234567890"
    },
    {
      "trackingNumber": "CBECUSD123456790",
      "bagCode": "BAG-A001-001"
    },
    {
      "trackingNumber": "CBECUSD123456791",
      "bagCode": "BAG-A001-002"
    }
  ]
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 3,
    "totalWeight": 7.5
  },
  "linked": 3,
  "notFound": []
}

{
  "success": true,
  "shipment": {
    "id": "shp_abc123def456",
    "awbNumber": "180-12345678",
    "status": "MANIFEST_SUBMITTED",
    "parcelCount": 2,
    "totalWeight": 5.0
  },
  "linked": 2,
  "notFound": ["INVALID123456789"]
}

{
  "success": false,
  "error": {
    "code": "MANIFEST_LOCKED",
    "message": "This AWB has already been submitted and cannot be modified",
    "message_es": "Esta guía aérea ya fue enviada y no puede ser modificada",
    "requestId": "req_abc123"
  }
}

Validation Rules

Tracking Number Validation

All tracking numbers must exist in the system
Parcels must be in LABEL_GENERATED or ORDERED status
Parcels cannot already be assigned to another manifest

AWB Validation

AWB number format: 3-digit carrier prefix + 8 digits (e.g., 180-12345678)
Cannot reuse an AWB that has already been submitted
Cannot modify a manifest after submission

Country Validation

Ecuador: Receiver ID (Cédula/RUC) validated against SRI database
Mexico: RFC format validated if provided
Colombia: Cédula format validated

Bag Codes

Parcels can be grouped into bags using the bagCode field. This is optional but recommended for large shipments.

{
  "parcels": [
    { "trackingNumber": "...", "bagCode": "BAG-001" },
    { "trackingNumber": "...", "bagCode": "BAG-001" },
    { "trackingNumber": "...", "bagCode": "BAG-002" }
  ]
}

Bags help with:

Physical grouping during shipping
Customs documentation
Weight tracking per container

Void Order Single Tracking

​Request Body

​Response

​Validation Rules

​Bag Codes

Request Body

Response

Validation Rules

Bag Codes