The following endpoint can be used to retrieve an array of extension fields for a given type of object.

GET /:object_type/extensions/fields

Where object_type describes the object you wish to get the extension fields for. We currently support the following object types:

  1. Contracts
  2. Prospects
  3. Jobs
  4. Issues

Parameters

Table of allowed parameters.

_fieldspartial stringAllows you to specify optional fields and linked objects to include in the response.

Handling the response

Below is a table of available response fields and objects that are returned within the response object of the returned object. The optional fields and objects can be requested in the _fields parameter; see included examples. Underlined values are default.

idunsignedThe extension field id. This can be used on other endpoints that accept the extension_value_id. For example, the update extension  value endpoint accepts this as a url path parameter.
field_typestringThe extension field type for this value. This can be

'text','textbox','int','date','date_time','float','certify','fixed_select','flexible_select','multi_select','lookup','currency', 'hyperlink','contributor'

field_namestringThe extension structure's name assigned to it by you. e.g "My awesome custom field".
optionsarrayThe options for 'fixed_select','flexible_select' or 'multi_select' field type.
link_type_idunsigned intThis represents the type of the linked object type. For example, if "link_type" is job, this will be the id of the job type that these extensions can appear under.
link_idunsignedIf the ID of the object the extension value is against.
link_typestringThe type of object the extension is against. e.g, job, contract, prospect or issue.
requiredstringThis indicates whether this extension field is required for the object.
lookup_typestringWhen lookup this will contain the lookups type. e.g, "company"
exportedstringThis indicates whether this extension field can be exported.
importantstringThis indicates whether this extension field is an important field.
default_valuestringThe default value of this extension field.
informationstringInformation about this extension field.