Skip to main content
GET
Get one field definition by key

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

field_key
string
required

Query Parameters

object
string
required

The object the field belongs to: one of account, activity, contact, opportunity, project, task, user, or a custom object's key (GET /v1/objects lists them)

Response

200 - application/json

Successful Response

key
string
required
kind
enum<string>
required
Available options:
standard,
custom
label
string
required
type
string
required
currency_code
string | null
formula
Formula · object | null

Set on a formula field: how its value is computed, in the shape formula takes on POST /v1/fields

hidden
boolean
default:false
mandatory
boolean
default:false
object
string | null

The object whose id(s) the value holds: set on reference fields (one id) and on id lists such as a contact's accounts (type text_list)

option_labels
Option Labels · object | null
options
string[] | null
owner
enum<string>
default:statisfy
Available options:
statisfy,
crm,
warehouse,
integration,
ai,
computed
syncs_to_crm
boolean
default:false
writable
boolean
default:false