JOjobadder
Candidate API:Lists

Get a custom field definition

Changed on
get/candidates/fields/custom/{fieldId}

Request

  • Base URL
    https://api.jobadder.com/v2
  • URL
    https://api.jobadder.com/v2/candidates/fields/custom/{fieldId}
  • Auth
    OAuth 2
    Authorization code: https://id.jobadder.com/connect/authorize
    Token URL: https://id.jobadder.com/connect/token scopes: read, read_candidate

Path parameters

fieldIdinteger required

Response

Requested candidate custom field definition

fieldIdinteger required
namestring required
type'Text' | 'List' | 'Date' | 'Lookup' | 'Url' string required

The type of value a custom field expects

mandatoryboolean nullable

Field is mandatory and a value must be provided

maxLengthinteger nullable

Maximum length of a text field

multiLineboolean nullable

Text field can contain a multi-line value

multiSelectboolean nullable

List field allows multiple selections

valuesstring[] nullable

Available values for a list custom field

Example response

{
  "fieldId": 1,
  "name": "Text Field 1",
  "type": "Text",
  "mandatory": true,
  "maxLength": 50,
  "multiLine": true,
  "multiSelect": false,
  "values": []
}

Changes