Geliştirici Merkezi

curl https://api.kargojet.com/partner-api/v1/addresses/senders \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "title": "Merkez Depo",
  "contactName": "Operasyon Ekibi",
  "phone": "08500000000",
  "city": "İstanbul",
  "district": "Tuzla",
  "addressLine": "Orhanlı Mah. Depo Cad. No: 12",
  "isDefault": true
}

{
  "id": "addr_sender_01HX",
  "type": "sender",
  "title": "Merkez Depo",
  "isDefault": true,
  "createdAt": "2026-05-09T12:00:00Z"
}

curl https://api.kargojet.com/partner-api/v1/addresses/recipients \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "name": "Ayşe Yılmaz",
  "phone": "5551112233",
  "city": "İstanbul",
  "district": "Kadıköy",
  "addressLine": "Caferağa Mah. Örnek Sok. No: 10"
}

{
  "id": "addr_recipient_01HX",
  "name": "Ayşe Yılmaz",
  "city": "İstanbul",
  "district": "Kadıköy"
}

curl https://api.kargojet.com/partner-api/v1/addresses \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "data": [
    { "id": "addr_01HX", "type": "warehouse", "title": "Merkez Depo" }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 1 }
}

curl https://api.kargojet.com/partner-api/v1/addresses/{addressId} \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "id": "addr_01HX",
  "type": "warehouse",
  "title": "Merkez Depo",
  "city": "İstanbul",
  "district": "Tuzla",
  "isDefault": true
}

curl https://api.kargojet.com/partner-api/v1/addresses/{addressId} \
  -X DELETE \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "deleted": true }

curl https://api.kargojet.com/partner-api/v1/locations/cities \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

[{ "code": "34", "name": "İstanbul" }, { "code": "06", "name": "Ankara" }]

curl https://api.kargojet.com/partner-api/v1/locations/cities/{cityCode}/districts \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

[{ "name": "Kadıköy", "isRemoteArea": false }, { "name": "Şile", "isRemoteArea": true }]

curl https://api.kargojet.com/partner-api/v1/shipments \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "reference": "ORD-10042",
  "carrierCode": "aras",
  "recipient": { "name": "Ayşe Yılmaz", "phone": "5551112233" },
  "parcel": { "widthCm": 30, "lengthCm": 20, "heightCm": 10, "weightKg": 1.4 }
}

{ "id": "shp_01HX", "trackingNumber": "3489123412", "status": "label_created" }

curl https://api.kargojet.com/partner-api/v1/shipments/drafts \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "draftId": "draft_01HX", "offers": [{ "carrierCode": "yurtici", "amount": 82.5 }] }

curl https://api.kargojet.com/partner-api/v1/shipments/cod \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "reference": "ORD-10043", "cod": { "amount": 1299.9, "paymentType": "card" } }

{ "id": "shp_cod_01HX", "codStatus": "pending_collection" }

curl https://api.kargojet.com/partner-api/v1/provider-shipments \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "id": "shp_provider_01HX", "providerAccountId": "pa_01HX" }

curl https://api.kargojet.com/partner-api/v1/shipments \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "data": [{ "id": "shp_01HX", "status": "in_transit" }], "pagination": { "total": 1 } }

curl https://api.kargojet.com/partner-api/v1/shipments/{draftId}/accept-offer \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "offerId": "offer_01HX" }

{ "shipmentId": "shp_01HX", "trackingNumber": "3489123412" }

curl https://api.kargojet.com/partner-api/v1/shipments/{shipmentId}/clone \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "draftId": "draft_clone_01HX" }

curl https://api.kargojet.com/partner-api/v1/shipments/{shipmentId}/return \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "returnCode": "KJ-RET-4921", "expiresAt": "2026-05-16T12:00:00Z" }

curl https://api.kargojet.com/partner-api/v1/shipments/{shipmentId}/packages \
  -X PUT \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "packages": [
    { "id": "pkg_01HX", "desi": 3 },
    { "desi": 2, "weight_kg": 1.4 }
  ]
}

{ "id": "shp_01HX", "package_count": 2, "expected_desi_total": 5 }

curl https://api.kargojet.com/partner-api/v1/tracking/status-codes \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

[{ "code": "in_transit", "label": "Yolda" }, { "code": "delivered", "label": "Teslim edildi" }]

curl https://api.kargojet.com/partner-api/v1/providers/service-codes \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

[{ "carrierCode": "aras", "service": "standard", "label": "Standart Teslimat" }]

curl https://api.kargojet.com/partner-api/v1/webhooks/endpoints \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "url": "https://example.com/webhooks/kargojet", "events": ["shipment.delivered", "shipment.failed"] }

{ "id": "wh_01HX", "status": "active", "secret": "kj_whsec_..." }

curl https://api.kargojet.com/partner-api/v1/webhooks/endpoints \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "data": [{ "id": "wh_01HX", "url": "https://example.com/webhooks/kargojet" }] }

curl https://api.kargojet.com/partner-api/v1/webhooks/endpoints/{webhookId}/test \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "delivered": true, "statusCode": 202, "durationMs": 184 }

curl https://api.kargojet.com/partner-api/v1/webhooks/endpoints/{webhookId} \
  -X DELETE \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "deleted": true }

curl https://api.kargojet.com/partner-api/v1/wallet/balance \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "available": 15420.5, "blocked": 820.0, "currency": "TRY" }

curl https://api.kargojet.com/partner-api/v1/prices \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "senderAddressId": "addr_01HX", "parcel": { "desi": 3 }, "recipientCity": "Ankara" }

{ "offers": [{ "carrierCode": "mng", "amount": 74.9, "currency": "TRY" }] }

curl https://api.kargojet.com/partner-api/v1/cod/shipments \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "reference": "ORD-10043",
  "carrierCode": "aras",
  "recipient": {
    "name": "Mehmet Demir",
    "phone": "5552223344",
    "city": "Bursa",
    "district": "Nilüfer",
    "addressLine": "Ataevler Mah. Örnek Cad. No: 8"
  },
  "parcel": { "widthCm": 25, "lengthCm": 18, "heightCm": 12, "weightKg": 1.2 },
  "cod": {
    "amount": 1499.90,
    "currency": "TRY",
    "paymentType": "cash_or_card",
    "collectionReference": "ORD-10043-KAPIDA"
  }
}

{
  "id": "shp_cod_01HX",
  "trackingNumber": "3489123412",
  "cod": {
    "status": "pending_collection",
    "amount": 1499.90,
    "commission": 29.90,
    "netAmount": 1470.00
  }
}

curl https://api.kargojet.com/partner-api/v1/cod/shipments \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "shipmentId": "shp_cod_01HX",
      "reference": "ORD-10043",
      "trackingNumber": "3489123412",
      "status": "collected",
      "amount": 1499.90,
      "netAmount": 1470.00
    }
  ],
  "pagination": { "page": 1, "limit": 25, "total": 1 }
}

curl https://api.kargojet.com/partner-api/v1/cod/summary \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "currency": "TRY",
  "pendingCollection": 32500.00,
  "collected": 184250.75,
  "commission": 4210.50,
  "transferable": 180040.25,
  "transferred": 95000.00
}

curl https://api.kargojet.com/partner-api/v1/cod/transfers \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{
  "data": [
    {
      "id": "cod_tr_01HX",
      "status": "paid",
      "grossAmount": 184250.75,
      "commission": 4210.50,
      "netAmount": 180040.25,
      "paidAt": "2026-05-09T12:00:00Z"
    }
  ]
}

curl https://api.kargojet.com/partner-api/v1/cod/reconciliation \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{
  "dateFrom": "2026-05-01",
  "dateTo": "2026-05-09",
  "carrierCode": "aras",
  "includeTransferred": true
}

{
  "jobId": "cod_rec_01HX",
  "status": "processing",
  "estimatedReadyAt": "2026-05-09T12:05:00Z"
}

curl https://api.kargojet.com/partner-api/v1/parcel-templates \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "name": "Küçük Kutu", "widthCm": 20, "lengthCm": 15, "heightCm": 10, "weightKg": 0.4 }

{ "id": "tpl_01HX", "billableDesi": 1 }

curl https://api.kargojet.com/partner-api/v1/parcel-templates \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "data": [{ "id": "tpl_01HX", "name": "Küçük Kutu", "billableDesi": 1 }] }

curl https://api.kargojet.com/partner-api/v1/parcel-templates/{templateId} \
  -X DELETE \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "deleted": true }

curl https://api.kargojet.com/partner-api/v1/provider-accounts \
  -X POST \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ORD-10042" \
  -d @payload.json

{ "carrierCode": "aras", "customerCode": "123456", "username": "api_user", "password": "***" }

{ "id": "pa_01HX", "carrierCode": "aras", "status": "test_required" }

curl https://api.kargojet.com/partner-api/v1/provider-accounts \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "data": [{ "id": "pa_01HX", "carrierCode": "aras", "status": "active" }] }

curl https://api.kargojet.com/partner-api/v1/provider-accounts/{providerAccountId} \
  -X DELETE \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

{ "deleted": true }

curl https://api.kargojet.com/partner-api/v1/error-codes \
  -X GET \
  -H "Authorization: Bearer $KARGOJET_API_TOKEN" \
  -H "Content-Type: application/json"

[{ "code": "invalid_recipient_address", "httpStatus": 422, "action": "Adres il/ilçe eşleşmesini kontrol edin." }]