Provinces

Developing

GET

/v1/address/provinces

Retrieves a paginated list of provinces/states in Indonesia with their unique identifiers and names. Results are alphabetically sorted by province name.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

start

integer

optional

Pagination offset (default: 0)

Example:

limit

integer

optional

Number of records per page (default: 10)

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

total

integer

required

data

array [object {2}]

required

name

string

required

Province name

integer

required

Province ID

Example

{
    "total": 34,
    "data": [
        {
            "name": "BALI",
            "id": 28
        },
        {
            "name": "BANTEN",
            "id": 2
        },
        {
            "name": "BENGKULU",
            "id": 7
        },
        {
            "name": "D.I. ACEH",
            "id": 8
        },
        {
            "name": "DI YOGYAKARTA",
            "id": 5
        },
        {
            "name": "DKI JAKARTA",
            "id": 1
        },
        {
            "name": "GORONTALO",
            "id": 22
        },
        {
            "name": "JAMBI",
            "id": 9
        },
        {
            "name": "JAWA BARAT",
            "id": 3
        },
        {
            "name": "JAWA TENGAH",
            "id": 4
        }
    ]
}

Coverage Area

Cities