# List custom fields

`GET https://rcur.app/api/v2/custom-fields`

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Page number for pagination |

## Example request

```bash
curl -X GET https://rcur.app/api/v2/custom-fields \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"
```

## Responses

### 200 List of custom fields

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of CustomFields | no |  |
| `data[].id` | string | yes |  |
| `data[].name` | string | yes | Internal name |
| `data[].label` | string | yes | The question as the customer sees it |
| `data[].type` | string | yes | One of: `text`, `textarea`, `number`, `select`, `checkbox`, `date`. |
| `data[].options` | array of strings | yes | The choices of a select field |
| `data[].required` | boolean | yes |  |
| `data[].store_on_customer` | boolean | no | The latest answer is kept on the customer |
| `data[].store_on_record` | boolean | no | The answer is kept on the payment, order or subscription of the checkout |
| `data[].created_at` | string | yes |  |
| `links` | object | no |  |
| `links.first` | string | no |  |
| `links.last` | string | no |  |
| `links.prev` | string | no |  |
| `links.next` | string | no |  |
| `meta` | object | no |  |
| `meta.current_page` | integer | no |  |
| `meta.last_page` | integer | no |  |
| `meta.per_page` | integer | no |  |
| `meta.total` | integer | no |  |

```json
{
    "data": [
        {
            "id": "aB3dE5fG7h",
            "name": "Shirt size",
            "label": "What is your shirt size?",
            "type": "select",
            "options": [
                "S",
                "M",
                "L"
            ],
            "required": false,
            "store_on_customer": false,
            "store_on_record": true,
            "created_at": "2026-10-08 10:00:00"
        }
    ],
    "links": {
        "first": "string",
        "last": "string",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "per_page": 15,
        "total": 6
    }
}
```