# List custom field templates

URL: /en/docs/api/v1/custom-fields/get
Last Updated: 2026-07-30T21:15:44.938Z

## Description
No description available.

## Available Actions
- Execute GET request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### GET /api/v1/custom-fields

**List custom field templates**

Retrieve all custom field templates for the current tenant.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Responses:**

- `200` - List of custom field templates
  - `customFields` (array of CustomFieldTemplate (object))
    - `title` (string)
    - `collection` (enum: accounts | contacts)
    - `type` (enum: text | number | boolean | date | select | multi_select | checkbox)
    - `always_ask` (boolean)
    - `required` (boolean)
    - `display` (array of enum: header | document)
    - `default_value` (string)
    - `order` (integer): Lower numbers are displayed first; defaults to the end of the list.
    - `translations` (array of CustomFieldTranslation (object))
      - `languages_code` (enum: en-US | de-DE | fr-FR)
      - `title` (string)
    - `options` (array of CustomFieldOption (object))
      - `value` (string)
      - `label` (array of CustomFieldOptionLabel (object))
        - `languages_code` (enum: en-US | de-DE | fr-FR)
        - `translation` (string)

  Example (Successful response):
  
  ```json
  {
  "customFields": [
    {
      "id": "cft-123",
      "title": "Job title",
      "collection": "contacts",
      "type": "text",
      "always_ask": true,
      "required": true,
      "translations": [
        {
          "languages_code": "en-US",
          "title": "Job title"
        },
        {
          "languages_code": "de-DE",
          "title": "Berufsbezeichnung"
        }
      ]
    }
  ]
}
  ```
- `401` - Unauthorized
- `403` - Forbidden - Admin role required
- `500` - Internal server error - Failed to load custom fields

**Code samples:**

cURL:

```bash
curl -X GET "https://app.orbiqhq.com/api/v1/custom-fields" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

```