# 1. Get Province List

Get Provinces — Retrieve the reference list of provinces (no parameters). Returns a standard response envelope suitable for populating area selectors.

# Overview

Auth: --
Method: GET

# Path

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

# Request

Query parameters: None.

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/provinces" \
  -H "Content-Type: application/json" \

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

qs := url.Values{}

u := "http:///partner/reference/areas/provinces"
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/provinces"))
    .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": "Provinces retrieved successfully",
  "data": [
    {
      "id": "632e4041-b063-4da9-9cd9-26c976cead77",
      "name": "Aceh"
    },
    {
      "id": "d88e5a92-1697-4e3f-9a2f-9472d7388e7a",
      "name": "Sumatera Utara"
    },
    {
      "id": "fe86ccae-5de3-4f06-b4c5-c0418e36ca86",
      "name": "Sumatera Barat"
    },
    {
      "id": "0a58f2d4-7581-4abf-84da-2384b5293968",
      "name": "Riau"
    },
    {
      "id": "a06244b3-248c-4c92-b880-d940198959b3",
      "name": "Jambi"
    },
    {
      "id": "8eef56a3-8f88-4278-b08a-cc6db49c434d",
      "name": "Sumatera Selatan"
    },
    {
      "id": "3af14047-9f4d-40cf-ac16-eb770baefb73",
      "name": "Bengkulu"
    },
    {
      "id": "5ad90ec0-944f-4218-a28f-fc5b5fe6b1e6",
      "name": "Lampung"
    },
    {
      "id": "c823cbcc-32f0-4f1a-a946-fde4a879f290",
      "name": "Kepulauan Bangka Belitung"
    },
    {
      "id": "8753ca3b-4ccd-49f8-8be2-67c2614c5027",
      "name": "Kepulauan Riau"
    },
    {
      "id": "947f72a7-cf54-47d9-a4fd-f1eaf7bddfb2",
      "name": "Jawa Barat"
    },
    {
      "id": "f0c582e6-705b-4b2c-b7be-e781469283d9",
      "name": "Jawa Tengah"
    },
    {
      "id": "2c3c2b4b-94fc-4349-bc42-567a354565d8",
      "name": "Daerah Istimewa Yogyakarta"
    },
    {
      "id": "fd254b8f-a060-464d-896a-a05433320db8",
      "name": "Jawa Timur"
    },
    {
      "id": "b229c881-1e64-4f4a-a0e6-046619077275",
      "name": "Banten"
    },
    {
      "id": "074823b6-5789-41d3-830a-5d6143421be3",
      "name": "Bali"
    },
    {
      "id": "f8aad4a8-cc9a-485a-83fb-bca49f280da2",
      "name": "Nusa Tenggara Barat"
    },
    {
      "id": "2f406d72-8e10-48da-a803-2b9e2321366c",
      "name": "Nusa Tenggara Timur"
    },
    {
      "id": "1cfaeaeb-e386-4ebc-81d2-2d8abe7aa358",
      "name": "Kalimantan Barat"
    },
    {
      "id": "2125536f-46cc-4628-9d66-82029ad6dc4d",
      "name": "Kalimantan Tengah"
    },
    {
      "id": "1123b47f-2e45-4aad-9b88-c1d9277ef127",
      "name": "Kalimantan Selatan"
    },
    {
      "id": "16f28c9b-f3b0-4e0a-a042-0b5494b040a2",
      "name": "Kalimantan Timur"
    },
    {
      "id": "53bf0250-cae2-492b-9346-5e0aeb843da6",
      "name": "Kalimantan Utara"
    },
    {
      "id": "4eb9a07a-90a0-4ef8-87ba-e0563807c367",
      "name": "Sulawesi Utara"
    },
    {
      "id": "4d1d302e-0749-48b4-80ad-6293fb10861a",
      "name": "Sulawesi Tengah"
    },
    {
      "id": "6748eada-4bd1-4202-94fc-d6f3d3e863d3",
      "name": "Sulawesi Selatan"
    },
    {
      "id": "dc4aede2-3f0c-4166-a4aa-dc3f1a43ee76",
      "name": "Sulawesi Tenggara"
    },
    {
      "id": "a6683058-0888-4ae1-a752-ffe4b367c3fd",
      "name": "Gorontalo"
    },
    {
      "id": "63a8ba13-fb22-43cb-8213-514b68e38877",
      "name": "Sulawesi Barat"
    },
    {
      "id": "ab766e42-e636-49cc-981b-12ffdd4f204d",
      "name": "Maluku"
    },
    {
      "id": "e00876a6-159f-4c5a-adc0-7d353f6dace5",
      "name": "Maluku Utara"
    },
    {
      "id": "dbe69c7c-7b15-4db2-907c-59c3d0a87944",
      "name": "Papua"
    },
    {
      "id": "189049df-6b89-40fb-9989-65486cd44fe6",
      "name": "Papua Barat"
    },
    {
      "id": "4a2b99e7-082c-481f-a38e-a1c56a2289a0",
      "name": "DKI Jakarta"
    }
  ]
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.