Get All Zones of a Country

Retrieve all zones (states/provinces) associated with a specific country by its country ID.

🗺️ Get All Zones of a Country

Use this endpoint to fetch paginated state or region data for a selected country.

---

🔹 HTTP Request

GET API-URL/countries/COUNTRY-ID/zones

---

🔸 URL Segments

Segment	Required	Description
COUNTRY-ID	Yes	Country ID to retrieve zones for.

---

🧾 Query Parameters

Parameter	Default	Description
page	1	Current page to retrieve.
per_page	10	Items per page to retrieve.

---

🔐 Authorization Header

X-API-KEY: your-api-key-here

---

💻 PHP Example

// get country zones
$response = $endpoint->getZones(COUNTRY-ID, $pageNumber = 1, $perPage = 10);

// DISPLAY RESPONSE
echo '<hr /><pre>';
print_r($response->body);
echo '</pre>';

---

📦 Sample JSON Response

{
  "status": "success",
  "data": {
    "count": "65",
    "total_pages": 7,
    "current_page": 1,
    "next_page": 2,
    "prev_page": null,
    "records": [
      {
        "zone_id": "5101",
        "name": "Alabama",
        "code": "AL"
      },
      {
        "zone_id": "5102",
        "name": "Alaska",
        "code": "AK"
      },
      {
        "zone_id": "5103",
        "name": "American Samoa",
        "code": "AS"
      },
      {
        "zone_id": "5104",
        "name": "Arizona",
        "code": "AZ"
      },
      {
        "zone_id": "5105",
        "name": "Arkansas",
        "code": "AR"
      },
      {
        "zone_id": "5106",
        "name": "Armed Forces Africa",
        "code": "AF"
      },
      {
        "zone_id": "5107",
        "name": "Armed Forces Americas",
        "code": "AA"
      },
      {
        "zone_id": "5108",
        "name": "Armed Forces Canada",
        "code": "AC"
      },
      {
        "zone_id": "5109",
        "name": "Armed Forces Europe",
        "code": "AE"
      },
      {
        "zone_id": "5110",
        "name": "Armed Forces Middle East",
        "code": "AM"
      }
    ]
  }
}