Get Dual Proposals

POSThttps://api.cargopanel.co/v2/carriers/proposal

POSThttps://sandbox-api.cargopanel.co/v2/carriers/proposal

Calculate carrier shipping proposals for both international and domestic destinations simultaneously in a single API call.

Request Fields

packagesarrayrequired

quantity - Quantity of packages (number)
weight - Package weight in kg (number)
dimensions - Length, width, height object

packageTypestringoptional

Type of shipment: package or document. Default is package if left empty.
For document shipments, max weight is 2.5 kg and quantity must be 1 package.

internationalobjectrequired

origin - Origin country code (e.g. TR)
destination - Destination country code (e.g. DE)

domesticobjectoptional

origin - Origin city name (e.g. İstanbul)
destination - Destination city name (e.g. İstanbul)

deliveryTypestringoptional

Delivery type (e.g. DDP or DAP).

hsCodearrayoptional

Array of HS code strings (e.g. ["111", "222"]).

Request Body

{
  "packages": [
    {
      "quantity": 1,
      "weight": 1,
      "dimensions": {
        "length": 10,
        "width": 10,
        "height": 10
      }
    }
  ],
  "international": {
    "origin": "TR",
    "destination": "DE"
  },
  "domestic": {
    "origin": "İstanbul",
    "destination": "İstanbul"
  },
  "deliveryType": "DDP",
  "hsCode": [
    "111",
    "222"
  ]
}

Example Response

200 OK

{
  "international": {
    "proposals": [
      {
        "id": "WIDECT",
        "name": "Widect",
        "price": 15.00,
        "currency": "USD",
        "isValid": true,
        "validationStatus": "success"
      }
    ],
    "chargeableWeight": 1
  },
  "domestic": {
    "proposals": [
      {
        "id": "HEPSIJET",
        "name": "HepsiJET",
        "price": 110.00,
        "currency": "TRY",
        "isValid": true,
        "validationStatus": "success"
      }
    ],
    "chargeableWeight": 1
  }
}

Responses

200Proposals successfully calculated

400Missing parameters or package details

404No proposals available for specified route

Create Dual Shipment

Create Carrier Labels