# Kurs Pajak (Tax Reference Rates)

The KMK-decreed exchange rate board Indonesian invoices and customs declarations are legally required to use, with the decree citation and its validity period.

- Method: `GET`
- Path: `/v1/tax/fx-rates`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |
| `limit` | integer | optional | Return only the first N currencies. |

**Example request**

```bash
curl https://api.diraz.ae/v1/tax/fx-rates \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "decree": {
      "number": "KMK Nomor 39/KM.10/2015",
      "document": "kurs/2015/KMK 39 KM.10 2015 SK Kurs Periode 2 - 8 September 2015.pdf",
      "period_from": "2015-09-02T00:00:00+07:00",
      "period_to": "2015-09-08T23:59:59+07:00"
    },
    "query_date": "2015-09-02",
    "rates": [
      { "code": "JPY", "country": "Jepang", "currency": "Yen", "value": 11644.57, "unit": 100, "direction": "up" },
      { "code": "KRW", "country": "Korea", "currency": "Won", "value": 11.85, "unit": 1, "direction": "up" },
      { "code": "USD", "country": "Amerika Serikat", "currency": "Dolar", "value": 14036, "unit": 1, "direction": "up" }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2015-09-02T00:00:00+07:00",
    "age_seconds": 42,
    "next_update_at": "2016-08-20T00:00:00.000Z"
  }
}
```