# Custom Fields

Configurable input fields for posts in your Featurebase organization. Custom fields allow you to collect additional structured data when users create posts.

## List custom fields

 - [GET /v2/custom_fields](https://docs.featurebase.app/rest-api/custom-fields/listcustomfields.md): Returns all custom fields configured in your organization.

This endpoint returns all custom fields at once (typically a small list). No pagination is supported.

### Response Format

Returns a list object with:
- object - Always "list"
- data - Array of custom field objects
- nextCursor - Always null

### Custom Field Object

Each custom field includes:
- id - Unique field identifier
- label - Field label displayed to users
- type - Field type (text, number, select, multi-select, checkbox, date)
- required - Whether the field is required
- placeholder - Placeholder text (for text/number fields)
- public - Whether the field value is publicly visible
- internal - Whether the field is for internal use only
- options - Array of options (for select/multi-select fields)

### Field Types

- text - Single line text input
- number - Numeric input
- select - Single-choice dropdown
- multi-select - Multiple-choice dropdown
- checkbox - Boolean checkbox
- date - Date picker

## Get a custom field by ID

 - [GET /v2/custom_fields/{id}](https://docs.featurebase.app/rest-api/custom-fields/getcustomfield.md): Retrieves a single custom field by its unique identifier.

Returns the custom field object if found in your organization.

### Response

Returns a custom field object with:
- id - Unique field identifier
- label - Field label displayed to users
- type - Field type (text, number, select, multi-select, checkbox, date)
- required - Whether the field is required
- placeholder - Placeholder text (for text/number fields)
- public - Whether the field value is publicly visible
- internal - Whether the field is for internal use only
- options - Array of options (for select/multi-select fields)

### Errors

- 404 - Custom field not found in your organization