Retrieve Object Field Options API
Overview
Use the Retrieve Object Field Options endpoint to programmatically retrieve the configured option values for selectable field types such as dropdowns, dynamic tags, radio buttons, and checkboxes.
This endpoint supports schema-aware integrations by allowing external systems to align with an Object’s current field configuration and validate allowed values before submitting Record updates. Because selectable options may vary across Objects or environments, retrieving them dynamically helps prevent invalid data submissions and hard-coded dependencies.
The material on this page builds on information covered in Objects Core Concepts and the Object Data Model.
Why Use this API?
Call this endpoint when your integration needs to understand which values are permitted for selectable fields. In most implementations, a direct call is unnecessary because field options are included in the /fields/ and /custom-objects/*/details responses. It is most useful when field options must be retrieved independently or when minimizing payload size is important.
Common scenarios include:
Building dynamic UI components that reflect Object configuration
Validating values before writing data to Records
Supporting integrations across multiple businesses with different schemas
Avoiding hard-coded option IDs or labels
Synchronizing controlled vocabularies between systems
Because Custom Fields extend the default data model to store additional data, retrieving their configuration is often a prerequisite for reliable Record operations.
Retrieve Object Field Options API Behavior
Understanding how this endpoint behaves helps prevent common integration mistakes.
This endpoint returns the configured option values for a specific field (for example, dropdown, radio, checkboxes, or dynamic tags) and does not return Record-level field values
The request is scoped using
object_pkandfield_pk(UUIDs) and integrations typically retrieve or store these identifiers as part of Object and field discoveryIf
include_entity_count=true, the response includesentity_countand becomes paginated, which is useful when you need to understand how widely an option is usedBecause selectable values are configuration-driven, retrieving options dynamically helps integrations adapt across businesses with different Object setups
Retrieve Object Field Options Endpoint
Want to try the API out? Visit our Swagger docs.
Retrieve Object Field Options Schemas
What's Next?
After retrieving field options via the API, you can:
Retrieve Object and field metadata to understand schema structure.
Create or update Records using validated option identifiers.
Combine field options with metadata APIs to support dynamic, schema-aware integrations.
For more information on Objects, check out the following topics:
Last updated
Was this helpful?