Skip to main content
POST
https://api.crbtrack.com
/
api
/
v1
/
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": []
}
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

​
idempotencyKey
string
Optional unique key to prevent duplicate submissions (8-64 characters).
​
awbNumber
string
required
Air Waybill number (8-20 characters). Format: XXX-XXXXXXXX (carrier prefix + 8 digits).
​
flightNumber
string
Flight number (e.g., LA2480).
​
flightDate
string
Scheduled flight date in YYYY-MM-DD format.
​
originAirport
string
Origin airport code (e.g., MIA).
​
destinationAirport
string
Destination airport code (e.g., UIO).
​
carrier
string
Carrier name (e.g., LATAM Airlines).
​
country
string
Destination country code (2-letter ISO).
​
parcels
array
required
List of parcels to include in the manifest.
​
attachment
string
Base64-encoded AWB PDF document.

​
Response

​
success
boolean
Whether the manifest was submitted successfully
​
shipment
object
The created shipment details
​
linked
integer
Number of parcels successfully linked to the shipment
​
notFound
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": []
}

​
Validation Rules

  • 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 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
  • 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