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

# Get Custom Field

> Get a single custom field's definition, and value if set, by its ID.

```
get_custom_field
```

## Description

Returns a single custom field's definition — and its stored value, if set — by field ID. Use it to inspect one field before updating it, or to check its type and default value.

## Parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `fieldId` | integer | Yes | — | ID of the custom field to fetch. Resolve via [`get_custom_fields_list`](/mcp/tools/custom-fields/get-custom-fields-list) |
| `businessNumber` | string | Yes | — | Account business number that owns the field (from [`get_business_info`](/mcp/tools/business/get-business-info)) |
| `locationBizNumber` | integer | No | — | Location number to read the field's stored value for a specific location |

## Example Usage

```
Show me custom field 376.
```

```
What type is my "colours" custom field?
```

## Example Response

```json theme={null}
{
  "id": 376,
  "fieldName": "colours",
  "fieldValue": "Green",
  "type": "DROPDOWN_MULTI",
  "defaultValue": "Green",
  "fieldDescription": "This custom field contains a list of colours",
  "filterable": false
}
```

## Response Fields

| Field | Description |
| - | - |
| `id` | The custom field ID |
| `fieldName` | Name of the custom field |
| `type` | Field type (`TEXT`, `URL`, `NUMBER`, `DATE`, `DROPDOWN_SINGLE`, `DROPDOWN_MULTI`, `TEXT_RAW`) |
| `defaultValue` | Default value — present only when set |
| `fieldValue` | Stored value for the location — present only when set |
| `fieldDescription` | Description of the field |
| `filterable` | Whether the field can be used as a filter |

## Notes

* The field **definition** is account-level, but its stored **value** can differ per location. To read a specific location's value, pass its number as `locationBizNumber` (resolve via [`get_child_locations`](/mcp/tools/business/get-child-locations)); otherwise the account-level definition is returned.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.