The Candidate object

{
  "id": "string",
  "remote_id": "string",
  "created_at": "2023-01-01T00:00:00Z",
  "modified_at": "2023-01-01T00:00:00Z",
  "first_name": "string",
  "last_name": "string",
  "company": "string",
  "title": "string",
  "remote_created_at": "2023-01-01T00:00:00Z",
  "remote_updated_at": "2023-01-01T00:00:00Z",
  "last_interaction_at": "2023-01-01T00:00:00Z",
  "is_private": true,
  "can_email": true,
  "locations": [
    "string"
  ],
  "phone_numbers": [
    {
      "created_at": "2023-01-01T00:00:00Z",
      "modified_at": "2023-01-01T00:00:00Z",
      "value": "string",
      "phone_number_type": "HOME",
      "remote_was_deleted": true
    }
  ],
  "email_addresses": [
    {
      "created_at": "2023-01-01T00:00:00Z",
      "modified_at": "2023-01-01T00:00:00Z",
      "value": "string",
      "email_address_type": "PERSONAL",
      "remote_was_deleted": true
    }
  ],
  "urls": [
    {
      "created_at": "2023-01-01T00:00:00Z",
      "modified_at": "2023-01-01T00:00:00Z",
      "value": "string",
      "url_type": "PERSONAL",
      "remote_was_deleted": true
    }
  ],
  "tags": [
    "string"
  ],
  "applications": [
    "string"
  ],
  "attachments": [
    "string"
  ],
  "remote_was_deleted": true,
  "field_mappings": {
    "organization_defined_targets": {
      "string": {}
    },
    "linked_account_defined_targets": {
      "string": {}
    }
  },
  "remote_data": [
    {
      "path": "string",
      "data": {}
    }
  ]
}

The Candidate object is used to represent profile information about a given Candidate. Because it is specific to a Candidate, this information stays constant across applications.

idstringOptionalRead-onlyformat: "uuid"

remote_idstring or nullOptional

The third-party API ID of the matching object.

created_atdatetimeOptionalRead-only

The datetime that this object was created by Merge.

modified_atdatetimeOptionalRead-only

The datetime that this object was modified by Merge.

first_namestring or nullOptional

The candidate's first name.

last_namestring or nullOptional

The candidate's last name.

companystring or nullOptional

The candidate's current company.

titlestring or nullOptional

The candidate's current title.

remote_created_atdatetime or nullOptional

When the third party's candidate was created.

remote_updated_atdatetime or nullOptional

When the third party's candidate was updated.

last_interaction_atdatetime or nullOptional

When the most recent interaction with the candidate occurred.

is_privateboolean or nullOptional

Whether or not the candidate is private.

can_emailboolean or nullOptional

Whether or not the candidate can be emailed.

locationslist of strings or nullOptional

The candidate's locations.

phone_numberslist of objectsOptional

email_addresseslist of objectsOptional

urlslist of objectsOptional

tagslist of stringsOptional

Array of `Tag` names as strings.

applicationslist of stringsOptional

Array of `Application` object IDs.

attachmentslist of stringsOptional

Array of `Attachment` object IDs.

remote_was_deletedbooleanOptional

Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).

field_mappingsobject or nullOptionalRead-only

remote_datalist of objects or nullOptionalRead-only