Skip to content
All APIs

Sambara · Finance · 1 endpoint

Samsat Jabar (PKB)

What a Samsat Jabar plate owes — both the on-time programme tariff and the non-programme one, with the road-insurance and registration lines.

Status
Operational
Price
1 credit / request
Rate limit
120 / 60s
Cache
30m
Requests
2

Endpoint

How to call it

GET/v1/vehicle-tax/jabar/{plate}

Code

Request — cURL

v1

curl https://api.diraz.co.id/v1/vehicle-tax/jabar/%7Bplate%7D \
  -H "Authorization: Bearer drz_live_…"

For AI agents

Callable through the MCP server with the same key:

call_api {"endpoint":"vehicle-tax-jabar","params":{"colour":"1"}}

Parameters

platepath segment · required
The vehicle's plate number, space-separated, West Java (Jabar) registered.
colourstring · optional
The plate (TNKB) colour: `1` black (default), `2` red — government, `3` yellow — commercial.Default: 1

Example response

200 OK

JSON

{
  "data": {
    "plate": "D 1234 ABC",
    "brand": "HONDA",
    "model": "BRIO SATYA 1.2 E CVT CKD",
    "colour": "PUTIH",
    "owner_sequence": "1",
    "kind": "Roda 4",
    "year_made": "2023",
    "period_from": "2027-01-22",
    "period_to": "2028-01-22",
    "tax_due_date": "2027-01-22",
    "registration_expiry_date": "2029-01-22",
    "region": "KAB.BANDUNG II SRG",
    "program": { "pkb_pokok": 1505500, "pkb_denda": 0, "opsen_pkb_pokok": 993700, "opsen_pkb_denda": 0, "swdkllj_pokok": 143000, "swdkllj_denda": 0, "pnbp_stnk": 0, "pnbp_tnkb": 0, "total": 2642200 },
    "non_program": { "pkb_pokok": 1599400, "pkb_denda": 0, "opsen_pkb_pokok": 1055700, "opsen_pkb_denda": 0, "swdkllj_pokok": 143000, "swdkllj_denda": 0, "pnbp_stnk": 0, "pnbp_tnkb": 0, "total": 2798100 },
    "processed_at": "2026-08-20 07:31:39",
    "can_be_paid": true
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T00:31:39.000Z",
    "age_seconds": 42,
    "next_update_at": "2026-08-20T01:01:39.000Z"
  }
}
plate / brand / model / colour / year_made
The vehicle the board resolved.
tax_due_date / registration_expiry_date / period_from / period_to
The tax period and the dates that matter at a renewal.
program.total
The tariff paid on time through the programme — PKB, the provincial surcharge, road insurance (SWDKLLJ), and registration fees, with penalties.
non_program.total
The same board outside the programme — the difference is what lateness costs.
region
The samsat area the vehicle is registered under.
can_be_paid
Whether the board currently accepts payment for this period.

Errors

When something goes wrong

Every failure carries a stable machine-readable code and the same meta.request_id a success carries — quote it and we can find your request. Errors are never billed.

401 Unauthorized

JSON

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is invalid, expired, or revoked."
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ"
  }
}
UNAUTHORIZEDHTTP 401
Missing, malformed, expired, or revoked API key.
FORBIDDENHTTP 403
The key is valid but lacks the scope this product needs.
VALIDATION_ERRORHTTP 422
A query parameter is the wrong type or out of range.
RATE_LIMITEDHTTP 429
Rate limit exhausted. `Retry-After` says how long to wait.
SERVICE_UNAVAILABLEHTTP 503
No data recent enough to serve. Carries `Retry-After`, and is never billed.

Data freshness

Every response is timestamped

as_of is when the data was published, age_seconds how old it is now, and next_update_at when newer data is expected.

  • Up to date

    200

    Inside its published window. Almost every request.

  • Delayed

    delayed: true

    Newer data is late; you get the latest there is, flagged.

  • Unavailable

    503

    Nothing recent enough. Carries Retry-After, never billed.

Health

Is it up?

  • Samsat Jabar (PKB)

1/1 passing