Locations, quotes, and availability

curl "$BASE_URL/api/v2/external/pickup-locations?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{
  "items": [
    {
      "pickupLocationId": "8cf2088f-e1c1-3bc6-a971-c4380b4447e2",
      "merchantId": "01a1933b-ce3e-7876-8891-ed6de2671aaa",
      "branchId": "de252e36-4d90-38cb-a101-dd08f5a1ccbd",
      "code": "SANDBOX_PICKUP",
      "name": "Sandbox Pickup",
      "cityCode": "RUH",
      "latitude": 24.713600,
      "longitude": 46.675300,
      "status": "ACTIVE",
      "timezone": "Asia/Riyadh",
      "openingHours": [
        { "dayOfWeek": 1, "opensAt": "00:00:00", "closesAt": "23:59:59" }
      ],
      "pickupWaves": [ { "waveTime": "09:00:00", "label": "Sandbox" } ]
    }
  ],
  "nextCursor": null
}

curl "$BASE_URL/api/v2/external/coverage/areas" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

{ "scope": "AREAS", "cities": [ { "cityId": "ea59d6f2-6e99-4918-81ed-d008d544429b", "cityCode": "RUH", "nameAr": "الرياض", "nameEn": "Riyadh", "districts": [], "wholeCity": true } ] }

curl -X POST "$BASE_URL/api/v2/external/quotes" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "merchantId": "01a1933b-ce3e-7876-8891-ed6de2671aaa",
    "branchId": "de252e36-4d90-38cb-a101-dd08f5a1ccbd",
    "pickupLocationId": "8cf2088f-e1c1-3bc6-a971-c4380b4447e2",
    "destinationLatitude": 24.774265,
    "destinationLongitude": 46.738586
  }'

{
  "distanceMetres": 13582,
  "durationSeconds": 837,
  "price": { "amount": 34.00, "currency": "SAR" },
  "routeGeometry": "{xkcn@yty_xA??dBxF_EzAu@ViEvAgZ…",
  "routeGeometryFormat": "POLYLINE6",
  "quoteId": "01a1933c-6c58-7580-8350-b50eb335b33d",
  "expiresAt": "2026-10-31T18:47:53.080964Z"
}

curl -X POST "$BASE_URL/api/v2/external/serviceability" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pickup": { "savedLocationCode": "SANDBOX_PICKUP" },
    "destination": { "latitude": 24.774265, "longitude": 46.738586 },
    "pickupWindow": { "start": "2026-11-01T07:00:00Z", "end": "2026-11-01T08:00:00Z" }
  }'

{ "serviceable": true, "unavailableReasonCode": null, "evaluatedAt": "2026-10-31T18:39:23.915856Z", "coverageZoneVersionId": "34587cde-129a-3edd-9ccc-ec2df14912b6" }