# 3. Get District List by City ID

Get Districts — Retrieve the reference list of districts filtered by the selected city; returns a standard response envelope for populating area selectors.

# Overview

Auth: --
Method: GET

# Path

https://partners-api.tocobagus.net/api/v1 /partner/reference/areas/districts

# Request

# Query Parameters

Name	Type	Required	Description
`cityId`	string	❌	—

Required headers: None.

# Request Payload

Request payload: Not used for GET.

# Example Request

Curl Node.js Go Java

curl -X GET "http:///partner/reference/areas/districts?cityId=%3CcityId%3E" \
  -H "Content-Type: application/json" \

const qs = new URLSearchParams({
  "cityId": "<cityId>"
});
const url = "http:///partner/reference/areas/districts" + (qs.toString() ? "?" + qs.toString() : "");
const res = await fetch(url, {
  method: "GET",
  headers: {}
});
const json = await res.json();
console.log(json);

qs := url.Values{}
qs.Set("cityId", "<cityId>")
u := "http:///partner/reference/areas/districts"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("GET", u, nil)

req.Header.Set("Content-Type","application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("http:///partner/reference/areas/districts?cityId=%3CcityId%3E"))
    .header("Content-Type","application/json")
    
    .method("GET", java.net.http.HttpRequest.BodyPublishers.noBody())
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

# Responses

# Example Responses

200 OK

{
  "success": true,
  "message": "Districts retrieved successfully",
  "data": [
    {
      "id": "11b343c2-7bc4-4739-836c-0fd66439c2e1",
      "name": "Medan Belawan"
    },
    {
      "id": "1d675103-63c7-40aa-804e-67c59090d7e9",
      "name": "Medan Tembung"
    },
    {
      "id": "2f71e8c6-39f7-4f82-b06e-75678766918a",
      "name": "Medan Polonia"
    },
    {
      "id": "81ef4a7a-9e64-4298-8ab1-fe3fc4ee4c24",
      "name": "Medan Baru"
    },
    {
      "id": "50f900f6-4e1e-463c-917d-f5c5fa000c21",
      "name": "Medan Denai"
    },
    {
      "id": "34eea4d3-61fc-47a3-b807-cb53aac97df9",
      "name": "Medan Tuntungan"
    },
    {
      "id": "17e03edc-544f-4b9c-9148-ac4359c0f837",
      "name": "Medan Perjuangan"
    },
    {
      "id": "1fe3f867-e14d-4ee3-9a94-98db2aaeca76",
      "name": "Medan Timur"
    },
    {
      "id": "6bd207e4-005b-4110-a8a7-9ea0833cfe5b",
      "name": "Medan Helvetia"
    },
    {
      "id": "3ff374d8-5af0-4dca-b5da-d3639704adc8",
      "name": "Medan Barat"
    },
    {
      "id": "6f2c5e39-2b3d-42b7-9148-10a89e24ecc3",
      "name": "Medan Labuhan"
    },
    {
      "id": "d3eb00d7-a6b7-4696-bb19-498647d44a6e",
      "name": "Medan Maimun"
    },
    {
      "id": "92254c46-420e-44ca-98a7-ba5d732c4280",
      "name": "Medan Kota"
    },
    {
      "id": "c4a4bbbf-e2f3-45a2-b459-7cb815ff0f2c",
      "name": "Medan Deli"
    },
    {
      "id": "741aca9e-4fb4-489e-8797-f86e96352d96",
      "name": "Medan Amplas"
    },
    {
      "id": "c74b79c7-b06b-49f3-954d-99823aeee9ed",
      "name": "Medan Johor"
    },
    {
      "id": "02d1fc39-a89f-4a8e-9894-408c822cb825",
      "name": "Medan Marelan"
    },
    {
      "id": "2f229dc1-bcf6-49cd-8e49-fc9fd83a3c35",
      "name": "Medan Area"
    },
    {
      "id": "171a528c-a7f7-469c-9a0d-b50725c352f0",
      "name": "Medan Sunggal"
    },
    {
      "id": "729cc6c7-c2e9-4f24-a19c-dee7c8e5ce02",
      "name": "Medan Selayang"
    },
    {
      "id": "07c451a3-fe6c-4a89-a5a5-31f6a6ce2e6d",
      "name": "Medan Petisah"
    }
  ]
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.