DEdesty
Order

List Indonesian Districts

Changed on

Description

List Indonesian provinces, cities, and districts as paginated district records. Use districtId when creating a manual order. This feature is in testing and has not been released to production.

Use the existing merchant-tenant Bearer token. Results are sorted lexicographically by districtId. A page beyond the last page returns an empty results array while retaining the totals. No request body is required.

Example: GET /api/region/list?pageNumber=1&pageSize=500

The shared pagination fields are pageNumber, pageSize, totalCount, totalPages, and results.

{"code":"0","msg":null,"data":{"pageNumber":1,"pageSize":500,"totalCount":1,"totalPages":1,"results":[{"districtId":"<actual district ID>","province":"Demo province","city":"Demo city","district":"Demo district"}]},"success":true}

Errors

  • INVALID_PARAMETER: pageNumber is below 1, pageSize is outside 1–500, or a parameter has an invalid format.
  • INVALID_TOKEN: authentication failed.
  • LIMIT_REQUEST: existing request rate limit exceeded.
  • SERVER_ERROR: downstream service unavailable or another server error.

Business, authentication, and rate-limit errors use HTTP 200; unexpected exceptions use HTTP 500. Always inspect the response code.

get/api/region/list

Request

  • Base URL
    https://api.desty.app
  • Auth
    none declared. Required headers: Authorization

Query parameters

pageNumberstring

Page number; defaults to 1, minimum 1.

pageSizestring

Page size; defaults to 500, range 1–500.

Headers

Authorizationstring required

Authorization (Only:Bearer <access_token>)

Request body text/plain

string binary required

Response

successful operation

code'0' | 'INVALID_PARAMETER' | 'INVALID_TOKEN' | 'LIMIT_REQUEST' | 'SERVER_ERROR' required

Business result code. 0 indicates success; other values indicate an error.

msgstring nullable

Result message; normally null on success.

successboolean required

True when code equals 0.

Changes