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

# Get merchant config

> GET /api/config — your merchant profile and available instalment terms.

Returns the merchant linked to your Bearer token, including the **rules** that define which amounts Float will accept and which instalment terms are offered per amount band.

<Note>
  Rate limited to **5 requests per hour**. Fetch at boot or on a schedule and cache — don't call this per checkout.
</Note>

## Request

```bash theme={null}
curl https://uat-secure.float.co.za/api/config \
  -H "Authorization: Bearer $FLOAT_CLIENT_SECRET"
```

No parameters.

## Response

```json 200 theme={null}
{
  "data": {
    "id": "12345678-1111-1111-1111-1234567890ab",
    "type": "merchants",
    "attributes": {
      "name": "South Park Cows Merch",
      "rules": [
        {
          "from_amount": 10000,
          "to_amount": 100000000,
          "terms": [1, 2, 3, 4, 5, 6]
        }
      ]
    }
  }
}
```

<ResponseField name="data.id" type="string (uuid)">
  Your merchant identifier on the Float platform.
</ResponseField>

<ResponseField name="data.attributes.name" type="string">
  Your merchant display name, as shown to shoppers on the payment page.
</ResponseField>

<ResponseField name="data.attributes.rules" type="array">
  Amount bands and their available instalment terms.

  <Expandable title="rule object">
    <ResponseField name="from_amount" type="integer">
      Minimum checkout amount for this band, in cents (inclusive).
    </ResponseField>

    <ResponseField name="to_amount" type="integer">
      Maximum checkout amount for this band, in cents (inclusive).
    </ResponseField>

    <ResponseField name="terms" type="integer[]">
      Instalment terms (months) available in this band. `1` means a once-off payment.
    </ResponseField>
  </Expandable>
</ResponseField>

## Errors

| HTTP  | When                            |
| ----- | ------------------------------- |
| `401` | Missing or invalid Bearer token |
| `429` | More than 5 requests in an hour |