> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shakesco.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cashback Settings

> Read the configured cashback program, converted to a specific currency

<span style={{display:"none"}}>For the complete documentation index, see [llms.txt](/llms.txt).</span>

Returns the configured spend threshold and reward, with the threshold converted into whichever currency you request.

### Query Parameters

<ParamField query="currency" type="string" required>
  Currency to display the threshold in (e.g. `KES`, `USD`)
</ParamField>

### Response

<ResponseField name="spend_threshold" type="string">
  Spend threshold converted to the requested currency (string with 2 decimals)
</ResponseField>

<ResponseField name="spend_threshold_currency" type="string">
  Currency code matching the request
</ResponseField>

<ResponseField name="reward_tokens" type="string">
  Tokens awarded when threshold is crossed
</ResponseField>

<ResponseField name="is_active" type="boolean">
  `true` if cashback has been configured
</ResponseField>

```javascript theme={null}
const res = await fetch(
  "https://tokens.shakesco.com/cashback-settings?currency=KES",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const settings = await res.json();
```

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "spend_threshold": "500.00",
    "spend_threshold_currency": "KES",
    "reward_tokens": "5.0",
    "is_active": true
  }
  ```
</ResponseExample>