List Delivery Windows

Get available delivery windows for a specific zone and date.

GET /integrations/yango/delivery-windows

Request

Query Parameters

Parameter	Type	Required	Description
zone	string	Yes*	Zone name (e.g., TLV-CENTER)
address	string	Yes*	Delivery address (geocoded automatically)
date	string	Yes	Date in YYYY-MM-DD format

*Either zone or address is required, but not both

Headers

Header	Required	Description
X-API-Key	Yes	Your API key

Examples

Query by Zone

cURL

curl -X GET "https://api.courimax.com/api/integrations/yango/delivery-windows?zone=TLV-CENTER&date=2026-08-20" \
  -H "X-API-Key: cmx_your_api_key"

JavaScript (Fetch)

const params = new URLSearchParams({
  zone: 'TLV-CENTER',
  date: '2026-08-20'
});

const response = await fetch(
  `https://api.courimax.com/api/integrations/yango/delivery-windows?${params}`,
  {
    headers: {
      'X-API-Key': 'cmx_your_api_key'
    }
  }
);

const windows = await response.json();
console.log(windows);

Python (Requests)

import requests

params = {
    'zone': 'TLV-CENTER',
    'date': '2026-08-20'
}

response = requests.get(
    'https://api.courimax.com/api/integrations/yango/delivery-windows',
    headers={
        'X-API-Key': 'cmx_your_api_key'
    },
    params=params
)

windows = response.json()
print(windows)

Query by Address

cURL

curl -X GET "https://api.courimax.com/api/integrations/yango/delivery-windows?address=Rothschild+Blvd+1,+Tel+Aviv&date=2026-08-20" \
  -H "X-API-Key: cmx_your_api_key"

JavaScript (Fetch)

const params = new URLSearchParams({
  address: 'Rothschild Blvd 1, Tel Aviv',
  date: '2026-08-20'
});

const response = await fetch(
  `https://api.courimax.com/api/integrations/yango/delivery-windows?${params}`,
  {
    headers: {
      'X-API-Key': 'cmx_your_api_key'
    }
  }
);

const windows = await response.json();
console.log(windows);

Python (Requests)

import requests

params = {
    'address': 'Rothschild Blvd 1, Tel Aviv',
    'date': '2026-08-20'
}

response = requests.get(
    'https://api.courimax.com/api/integrations/yango/delivery-windows',
    headers={
        'X-API-Key': 'cmx_your_api_key'
    },
    params=params
)

windows = response.json()
print(windows)

Response

Success (200 OK) - Zone Query

{
  "zone": "TLV-CENTER",
  "date": "2026-08-20",
  "timezone": "Asia/Jerusalem",
  "windows": [
    {
      "start": "2026-08-20T08:00:00+03:00",
      "end": "2026-08-20T12:00:00+03:00",
      "available": true,
      "scheduledCount": 5,
      "capacityLimit": 20
    },
    {
      "start": "2026-08-20T12:00:00+03:00",
      "end": "2026-08-20T16:00:00+03:00",
      "available": true,
      "scheduledCount": 12,
      "capacityLimit": 20
    },
    {
      "start": "2026-08-20T16:00:00+03:00",
      "end": "2026-08-20T20:00:00+03:00",
      "available": false,
      "scheduledCount": 20,
      "capacityLimit": 20
    }
  ]
}

Success (200 OK) - Address Query

When querying by address, the response is an array of windows for all matching zones:

[
  {
    "zone": "TLV-CENTER",
    "date": "2026-08-20",
    "timezone": "Asia/Jerusalem",
    "windows": [...]
  },
  {
    "zone": "TLV-NORTH",
    "date": "2026-08-20",
    "timezone": "Asia/Jerusalem",
    "windows": [...]
  }
]

Response Fields

Field	Type	Description
zone	string	Zone name
date	string	Date (YYYY-MM-DD)
timezone	string	Timezone (e.g., Asia/Jerusalem)
windows	array	Available delivery windows
windows[].start	string	Window start time (ISO 8601)
windows[].end	string	Window end time (ISO 8601)
windows[].available	boolean	Whether window has capacity
windows[].scheduledCount	number	Number of orders scheduled
windows[].capacityLimit	number	Maximum capacity per window

Standard Windows

Delivery windows follow the Israeli work week pattern:

• AM: 08:00 - 12:00
• PM: 12:00 - 16:00
• EVE: 16:00 - 20:00

No deliveries on Friday (5) and Saturday (6).

Error Responses

400 Bad Request - Missing or invalid parameters

{
  "statusCode": 400,
  "message": "date query parameter is required (format: YYYY-MM-DD)",
  "error": "Bad Request"
}

{
  "statusCode": 400,
  "message": "Provide either zone or address, not both",
  "error": "Bad Request"
}

401 Unauthorized - Missing or invalid API key

{
  "statusCode": 401,
  "message": "Missing X-API-Key header",
  "error": "Unauthorized"
}

404 Not Found - Zone or address not found

{
  "statusCode": 404,
  "message": "Zone \"INVALID-ZONE\" not found",
  "error": "Not Found"
}

Capacity Management

Each delivery window has a capacity limit (default: 20 orders per window per zone). When a window reaches capacity:

• available becomes false
• New orders cannot be scheduled in that window
• Existing orders remain unaffected

Next Steps

• Bulk Availability - Get availability for multiple zones and dates
• Create Order - Schedule orders in available windows