Directory API: People

Retrieves one specific person

get

Authorizations

BearerCookie

BearerstringRequired

Path parameters

personstring · uuidRequired

Responses

200

OK

application/jsontext/json

fullNamestring · nullableOptional

organizationIdstring · uuidOptional

personCodestring · nullableOptional

personFirstNamestring · nullableOptional

personIdstring · uuidOptional

personLastNamestring · nullableOptional

personTypestring · nullableOptional

userIdstring · uuidOptional

userNamestring · nullableOptional

userEmailstring · nullableOptional

isAdministratorbooleanOptional

isDeveloperbooleanOptional

isLearnerbooleanOptional

isOperatorbooleanOptional

accessRevokedstring · date-time · nullableOptional

accessRevokedBystring · nullableOptional

lastAuthenticatedstring · date-time · nullableOptional

userAccessGrantedstring · date-time · nullableOptional

userAccessGrantedBystring · nullableOptional

userApproveReasonstring · nullableOptional

welcomeEmailsSentToUserinteger · int32 · nullableOptional

emailAlternateEnabledbooleanOptional

emailEnabledbooleanOptional

marketingEmailEnabledbooleanOptional

phonestring · nullableOptional

phoneFaxstring · nullableOptional

phoneHomestring · nullableOptional

phoneOtherstring · nullableOptional

phoneWorkstring · nullableOptional

shippingPreferencestring · nullableOptional

emergencyContactNamestring · nullableOptional

emergencyContactPhonestring · nullableOptional

emergencyContactRelationshipstring · nullableOptional

ageGroupstring · nullableOptional

birthdatestring · date-time · nullableOptional

citizenshipstring · nullableOptional

firstLanguagestring · nullableOptional

genderstring · nullableOptional

languagestring · nullableOptional

regionstring · nullableOptional

timeZonestring · nullableOptional

employerGroupIdstring · uuid · nullableOptional

employeeTypestring · nullableOptional

employeeUnionstring · nullableOptional

jobDivisionstring · nullableOptional

jobTitlestring · nullableOptional

jobsApprovedstring · date-time · nullableOptional

jobsApprovedBystring · nullableOptional

occupationStandardIdstring · uuid · nullableOptional

candidateCompletionProfilePercentinteger · int32 · nullableOptional

candidateCompletionResumePercentinteger · int32 · nullableOptional

candidateIsActivelySeekingboolean · nullableOptional

candidateIsWillingToRelocateboolean · nullableOptional

candidateLinkedInUrlstring · nullableOptional

candidateOccupationListstring · nullableOptional

immigrationApplicantstring · nullableOptional

immigrationCategorystring · nullableOptional

immigrationDestinationstring · nullableOptional

immigrationDisabilitystring · nullableOptional

immigrationLandingDatestring · date-time · nullableOptional

immigrationNumberstring · nullableOptional

memberEndDatestring · date-time · nullableOptional

membershipStatusItemIdstring · uuid · nullableOptional

memberStartDatestring · date-time · nullableOptional

credentialingCountrystring · nullableOptional

educationLevelstring · nullableOptional

industryItemIdstring · uuid · nullableOptional

socialInsuranceNumberstring · nullableOptional

tradeworkerNumberstring · nullableOptional

consentConsultationstring · nullableOptional

consentToSharestring · nullableOptional

referrerstring · nullableOptional

referrerOtherstring · nullableOptional

isArchivedbooleanOptional

whenArchivedstring · date-time · nullableOptional

whenUnarchivedstring · date-time · nullableOptional

accountReviewCompletedstring · date-time · nullableOptional

accountReviewQueuedstring · date-time · nullableOptional

webSiteUrlstring · nullableOptional

createdstring · date-timeOptional

createdBystring · uuid · nullableOptional

customKeyinteger · int32 · nullableOptional

modifiedstring · date-timeOptional

modifiedBystring · uuidOptional

sinModifiedstring · date-time · nullableOptional

get

/api/directory/people/{person}

HTTPcURLJavaScriptPython

GET /v2/e01/api/directory/people/{person} HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

{
  "fullName": "text",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "personCode": "text",
  "personFirstName": "text",
  "personId": "123e4567-e89b-12d3-a456-426614174000",
  "personLastName": "text",
  "personType": "text",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "userName": "text",
  "userEmail": "text",
  "isAdministrator": true,
  "isDeveloper": true,
  "isLearner": true,
  "isOperator": true,
  "accessRevoked": "2026-03-13T15:01:08.117Z",
  "accessRevokedBy": "text",
  "lastAuthenticated": "2026-03-13T15:01:08.117Z",
  "userAccessGranted": "2026-03-13T15:01:08.117Z",
  "userAccessGrantedBy": "text",
  "userApproveReason": "text",
  "welcomeEmailsSentToUser": 1,
  "emailAlternateEnabled": true,
  "emailEnabled": true,
  "marketingEmailEnabled": true,
  "phone": "text",
  "phoneFax": "text",
  "phoneHome": "text",
  "phoneOther": "text",
  "phoneWork": "text",
  "billingAddress": {
    "addressId": "123e4567-e89b-12d3-a456-426614174000",
    "city": "text",
    "country": "text",
    "description": "text",
    "postalCode": "text",
    "province": "text",
    "street1": "text",
    "street2": "text"
  },
  "homeAddress": {
    "addressId": "123e4567-e89b-12d3-a456-426614174000",
    "city": "text",
    "country": "text",
    "description": "text",
    "postalCode": "text",
    "province": "text",
    "street1": "text",
    "street2": "text"
  },
  "shippingAddress": {
    "addressId": "123e4567-e89b-12d3-a456-426614174000",
    "city": "text",
    "country": "text",
    "description": "text",
    "postalCode": "text",
    "province": "text",
    "street1": "text",
    "street2": "text"
  },
  "shippingPreference": "text",
  "workAddress": {
    "addressId": "123e4567-e89b-12d3-a456-426614174000",
    "city": "text",
    "country": "text",
    "description": "text",
    "postalCode": "text",
    "province": "text",
    "street1": "text",
    "street2": "text"
  },
  "emergencyContactName": "text",
  "emergencyContactPhone": "text",
  "emergencyContactRelationship": "text",
  "ageGroup": "text",
  "birthdate": "2026-03-13T15:01:08.117Z",
  "citizenship": "text",
  "firstLanguage": "text",
  "gender": "text",
  "language": "text",
  "region": "text",
  "timeZone": "text",
  "employerGroupId": "123e4567-e89b-12d3-a456-426614174000",
  "employeeType": "text",
  "employeeUnion": "text",
  "jobDivision": "text",
  "jobTitle": "text",
  "jobsApproved": "2026-03-13T15:01:08.117Z",
  "jobsApprovedBy": "text",
  "occupationStandardId": "123e4567-e89b-12d3-a456-426614174000",
  "candidateCompletionProfilePercent": 1,
  "candidateCompletionResumePercent": 1,
  "candidateIsActivelySeeking": true,
  "candidateIsWillingToRelocate": true,
  "candidateLinkedInUrl": "text",
  "candidateOccupationList": "text",
  "immigrationApplicant": "text",
  "immigrationCategory": "text",
  "immigrationDestination": "text",
  "immigrationDisability": "text",
  "immigrationLandingDate": "2026-03-13T15:01:08.117Z",
  "immigrationNumber": "text",
  "memberEndDate": "2026-03-13T15:01:08.117Z",
  "membershipStatusItemId": "123e4567-e89b-12d3-a456-426614174000",
  "memberStartDate": "2026-03-13T15:01:08.117Z",
  "credentialingCountry": "text",
  "educationLevel": "text",
  "industryItemId": "123e4567-e89b-12d3-a456-426614174000",
  "socialInsuranceNumber": "text",
  "tradeworkerNumber": "text",
  "consentConsultation": "text",
  "consentToShare": "text",
  "referrer": "text",
  "referrerOther": "text",
  "isArchived": true,
  "whenArchived": "2026-03-13T15:01:08.117Z",
  "whenUnarchived": "2026-03-13T15:01:08.117Z",
  "accountReviewCompleted": "2026-03-13T15:01:08.117Z",
  "accountReviewQueued": "2026-03-13T15:01:08.117Z",
  "webSiteUrl": "text",
  "created": "2026-03-13T15:01:08.117Z",
  "createdBy": "123e4567-e89b-12d3-a456-426614174000",
  "customKey": 1,
  "modified": "2026-03-13T15:01:08.117Z",
  "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
  "sinModified": "2026-03-13T15:01:08.117Z"
}

Checks for the existence of one specific person

head

Authorizations

BearerCookie

BearerstringRequired

Path parameters

personstring · uuidRequired

Responses

200

OK

application/jsontext/json

booleanOptional

head

/api/directory/people/{person}

HTTPcURLJavaScriptPython

HEAD /v2/e01/api/directory/people/{person} HTTP/1.1
Bearer: YOUR_API_KEY
Accept: */*

200

OK

true

Collects the list of people that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

userIdstring · uuid · nullableOptional

emailExactstring · nullableOptional

eventRolestring · nullableOptional

fullNamestring · nullableOptional

Responses

200

OK

application/jsontext/json

fullNamestring · nullableOptional

organizationIdstring · uuidOptional

personCodestring · nullableOptional

personFirstNamestring · nullableOptional

personIdstring · uuidOptional

personLastNamestring · nullableOptional

personTypestring · nullableOptional

userIdstring · uuidOptional

userNamestring · nullableOptional

userEmailstring · nullableOptional

isAdministratorbooleanOptional

isDeveloperbooleanOptional

isLearnerbooleanOptional

isOperatorbooleanOptional

accessRevokedstring · date-time · nullableOptional

accessRevokedBystring · nullableOptional

lastAuthenticatedstring · date-time · nullableOptional

userAccessGrantedstring · date-time · nullableOptional

userAccessGrantedBystring · nullableOptional

userApproveReasonstring · nullableOptional

welcomeEmailsSentToUserinteger · int32 · nullableOptional

emailAlternateEnabledbooleanOptional

emailEnabledbooleanOptional

marketingEmailEnabledbooleanOptional

phonestring · nullableOptional

phoneFaxstring · nullableOptional

phoneHomestring · nullableOptional

phoneOtherstring · nullableOptional

phoneWorkstring · nullableOptional

shippingPreferencestring · nullableOptional

emergencyContactNamestring · nullableOptional

emergencyContactPhonestring · nullableOptional

emergencyContactRelationshipstring · nullableOptional

ageGroupstring · nullableOptional

birthdatestring · date-time · nullableOptional

citizenshipstring · nullableOptional

firstLanguagestring · nullableOptional

genderstring · nullableOptional

languagestring · nullableOptional

regionstring · nullableOptional

timeZonestring · nullableOptional

employerGroupIdstring · uuid · nullableOptional

employeeTypestring · nullableOptional

employeeUnionstring · nullableOptional

jobDivisionstring · nullableOptional

jobTitlestring · nullableOptional

jobsApprovedstring · date-time · nullableOptional

jobsApprovedBystring · nullableOptional

occupationStandardIdstring · uuid · nullableOptional

candidateCompletionProfilePercentinteger · int32 · nullableOptional

candidateCompletionResumePercentinteger · int32 · nullableOptional

candidateIsActivelySeekingboolean · nullableOptional

candidateIsWillingToRelocateboolean · nullableOptional

candidateLinkedInUrlstring · nullableOptional

candidateOccupationListstring · nullableOptional

immigrationApplicantstring · nullableOptional

immigrationCategorystring · nullableOptional

immigrationDestinationstring · nullableOptional

immigrationDisabilitystring · nullableOptional

immigrationLandingDatestring · date-time · nullableOptional

immigrationNumberstring · nullableOptional

memberEndDatestring · date-time · nullableOptional

membershipStatusItemIdstring · uuid · nullableOptional

memberStartDatestring · date-time · nullableOptional

credentialingCountrystring · nullableOptional

educationLevelstring · nullableOptional

industryItemIdstring · uuid · nullableOptional

socialInsuranceNumberstring · nullableOptional

tradeworkerNumberstring · nullableOptional

consentConsultationstring · nullableOptional

consentToSharestring · nullableOptional

referrerstring · nullableOptional

referrerOtherstring · nullableOptional

isArchivedbooleanOptional

whenArchivedstring · date-time · nullableOptional

whenUnarchivedstring · date-time · nullableOptional

accountReviewCompletedstring · date-time · nullableOptional

accountReviewQueuedstring · date-time · nullableOptional

webSiteUrlstring · nullableOptional

createdstring · date-timeOptional

createdBystring · uuid · nullableOptional

customKeyinteger · int32 · nullableOptional

modifiedstring · date-timeOptional

modifiedBystring · uuidOptional

sinModifiedstring · date-time · nullableOptional

post

/api/directory/people/collect

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/people/collect HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 601

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-03-13T15:01:08.117Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "emailExact": "text",
  "eventRole": "text",
  "fullName": "text"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

[
  {
    "fullName": "text",
    "organizationId": "123e4567-e89b-12d3-a456-426614174000",
    "personCode": "text",
    "personFirstName": "text",
    "personId": "123e4567-e89b-12d3-a456-426614174000",
    "personLastName": "text",
    "personType": "text",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "userName": "text",
    "userEmail": "text",
    "isAdministrator": true,
    "isDeveloper": true,
    "isLearner": true,
    "isOperator": true,
    "accessRevoked": "2026-03-13T15:01:08.117Z",
    "accessRevokedBy": "text",
    "lastAuthenticated": "2026-03-13T15:01:08.117Z",
    "userAccessGranted": "2026-03-13T15:01:08.117Z",
    "userAccessGrantedBy": "text",
    "userApproveReason": "text",
    "welcomeEmailsSentToUser": 1,
    "emailAlternateEnabled": true,
    "emailEnabled": true,
    "marketingEmailEnabled": true,
    "phone": "text",
    "phoneFax": "text",
    "phoneHome": "text",
    "phoneOther": "text",
    "phoneWork": "text",
    "billingAddress": {
      "addressId": "123e4567-e89b-12d3-a456-426614174000",
      "city": "text",
      "country": "text",
      "description": "text",
      "postalCode": "text",
      "province": "text",
      "street1": "text",
      "street2": "text"
    },
    "homeAddress": {
      "addressId": "123e4567-e89b-12d3-a456-426614174000",
      "city": "text",
      "country": "text",
      "description": "text",
      "postalCode": "text",
      "province": "text",
      "street1": "text",
      "street2": "text"
    },
    "shippingAddress": {
      "addressId": "123e4567-e89b-12d3-a456-426614174000",
      "city": "text",
      "country": "text",
      "description": "text",
      "postalCode": "text",
      "province": "text",
      "street1": "text",
      "street2": "text"
    },
    "shippingPreference": "text",
    "workAddress": {
      "addressId": "123e4567-e89b-12d3-a456-426614174000",
      "city": "text",
      "country": "text",
      "description": "text",
      "postalCode": "text",
      "province": "text",
      "street1": "text",
      "street2": "text"
    },
    "emergencyContactName": "text",
    "emergencyContactPhone": "text",
    "emergencyContactRelationship": "text",
    "ageGroup": "text",
    "birthdate": "2026-03-13T15:01:08.117Z",
    "citizenship": "text",
    "firstLanguage": "text",
    "gender": "text",
    "language": "text",
    "region": "text",
    "timeZone": "text",
    "employerGroupId": "123e4567-e89b-12d3-a456-426614174000",
    "employeeType": "text",
    "employeeUnion": "text",
    "jobDivision": "text",
    "jobTitle": "text",
    "jobsApproved": "2026-03-13T15:01:08.117Z",
    "jobsApprovedBy": "text",
    "occupationStandardId": "123e4567-e89b-12d3-a456-426614174000",
    "candidateCompletionProfilePercent": 1,
    "candidateCompletionResumePercent": 1,
    "candidateIsActivelySeeking": true,
    "candidateIsWillingToRelocate": true,
    "candidateLinkedInUrl": "text",
    "candidateOccupationList": "text",
    "immigrationApplicant": "text",
    "immigrationCategory": "text",
    "immigrationDestination": "text",
    "immigrationDisability": "text",
    "immigrationLandingDate": "2026-03-13T15:01:08.117Z",
    "immigrationNumber": "text",
    "memberEndDate": "2026-03-13T15:01:08.117Z",
    "membershipStatusItemId": "123e4567-e89b-12d3-a456-426614174000",
    "memberStartDate": "2026-03-13T15:01:08.117Z",
    "credentialingCountry": "text",
    "educationLevel": "text",
    "industryItemId": "123e4567-e89b-12d3-a456-426614174000",
    "socialInsuranceNumber": "text",
    "tradeworkerNumber": "text",
    "consentConsultation": "text",
    "consentToShare": "text",
    "referrer": "text",
    "referrerOther": "text",
    "isArchived": true,
    "whenArchived": "2026-03-13T15:01:08.117Z",
    "whenUnarchived": "2026-03-13T15:01:08.117Z",
    "accountReviewCompleted": "2026-03-13T15:01:08.117Z",
    "accountReviewQueued": "2026-03-13T15:01:08.117Z",
    "webSiteUrl": "text",
    "created": "2026-03-13T15:01:08.117Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000",
    "customKey": 1,
    "modified": "2026-03-13T15:01:08.117Z",
    "modifiedBy": "123e4567-e89b-12d3-a456-426614174000",
    "sinModified": "2026-03-13T15:01:08.117Z"
  }
]

Counts the people that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

userIdstring · uuid · nullableOptional

emailExactstring · nullableOptional

eventRolestring · nullableOptional

fullNamestring · nullableOptional

Responses

200

OK

application/jsontext/json

countinteger · int32Optional

summarystring · nullableOptional

post

/api/directory/people/count

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/people/count HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 601

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-03-13T15:01:08.117Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "emailExact": "text",
  "eventRole": "text",
  "fullName": "text"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

{
  "count": 1,
  "summary": "text"
}

Downloads the list of people that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

userIdstring · uuid · nullableOptional

emailExactstring · nullableOptional

eventRolestring · nullableOptional

fullNamestring · nullableOptional

Responses

200

OK

No content

post

/api/directory/people/download

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/people/download HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 601

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-03-13T15:01:08.117Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "emailExact": "text",
  "eventRole": "text",
  "fullName": "text"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

No content

Searches for the list of people that match specific criteria

post

Authorizations

BearerCookie

BearerstringRequired

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

identifierstring · uuid · nullableOptional

userIdstring · uuid · nullableOptional

organizationIdstring · uuid · nullableOptional

emailExactstring · nullableOptional

eventRolestring · nullableOptional

fullNamestring · nullableOptional

Responses

200

OK

application/jsontext/json

personIdstring · uuidOptional

personFirstNamestring · nullableOptional

personLastNamestring · nullableOptional

userIdstring · uuidOptional

userNamestring · nullableOptional

userEmailstring · nullableOptional

isAdministratorbooleanOptional

isDeveloperbooleanOptional

isLearnerbooleanOptional

isOperatorbooleanOptional

timeZonestring · nullableOptional

post

/api/directory/people/search

HTTPcURLJavaScriptPython

POST /v2/e01/api/directory/people/search HTTP/1.1
Bearer: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 601

{
  "identifier": "123e4567-e89b-12d3-a456-426614174000",
  "origin": {
    "when": "2026-03-13T15:01:08.117Z",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "user": "123e4567-e89b-12d3-a456-426614174000",
    "proxy": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "reason": "text",
    "source": "text"
  },
  "filter": {
    "page": 1,
    "pageSize": 1,
    "sort": "text",
    "excludes": "text",
    "includes": "text",
    "format": "text"
  },
  "texts": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "userId": "123e4567-e89b-12d3-a456-426614174000",
  "organizationId": "123e4567-e89b-12d3-a456-426614174000",
  "emailExact": "text",
  "eventRole": "text",
  "fullName": "text"
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

200

OK

[
  {
    "personId": "123e4567-e89b-12d3-a456-426614174000",
    "personFirstName": "text",
    "personLastName": "text",
    "userId": "123e4567-e89b-12d3-a456-426614174000",
    "userName": "text",
    "userEmail": "text",
    "isAdministrator": true,
    "isDeveloper": true,
    "isLearner": true,
    "isOperator": true,
    "timeZone": "text"
  }
]