Get an employee's custom fields

GET {{baseUrl}}/v1/employees/:employee_id/custom_fields?page=<number>&per=<number>

Returns a list of the employee's custom fields.

scope: employees:read

Request Params

KeyDatatypeRequiredDescription
pagestringThe page that is requested. When unspecified, will load all objects unless endpoint forces pagination.
perstringNumber of objects per page. For majority of endpoints will default to 25

HEADERS

KeyDatatypeRequiredDescription
X-Gusto-API-VersionstringDetermines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.
Acceptstring

RESPONSES

status: OK

{&quot;custom_fields&quot;:[{&quot;id&quot;:&quot;ee515986-f3ca-49da-b576-2691b95262f9&quot;,&quot;company_custom_field_id&quot;:&quot;ea7e5d57-6abb-47d7-b654-347c142886c0&quot;,&quot;name&quot;:&quot;employee_level&quot;,&quot;description&quot;:&quot;Employee Level&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;2&quot;,&quot;selection_options&quot;:null},{&quot;id&quot;:&quot;3796e08d-c2e3-434c-b4de-4ce1893e7b59&quot;,&quot;company_custom_field_id&quot;:&quot;299650e4-e970-4acf-9bf0-6f05585d20ba&quot;,&quot;name&quot;:&quot;t-shirt size&quot;,&quot;description&quot;:&quot;What is your t-shirt size?&quot;,&quot;type&quot;:&quot;text&quot;,&quot;value&quot;:&quot;md&quot;,&quot;selection_options&quot;:null},{&quot;id&quot;:&quot;3796e08d-c2e3-434c-b4de-4ce1893e7b59&quot;,&quot;company_custom_field_id&quot;:&quot;024ec137-6c92-43a3-b061-14a9720531d6&quot;,&quot;name&quot;:&quot;favorite fruit&quot;,&quot;description&quot;:&quot;Which is your favorite fruit?&quot;,&quot;type&quot;:&quot;radio&quot;,&quot;value&quot;:&quot;apple&quot;,&quot;selection_options&quot;:[&quot;apple&quot;,&quot;banana&quot;,&quot;orange&quot;]}]}