--- title: "find one participant" method: GET path: "/api/servicepulse/participants/{identifier}" tags: ["participants"] --- # find one participant `GET /api/servicepulse/participants/{identifier}` ## Request - Base URL: `https://services.fountain.com` - URL: `https://services.fountain.com/api/servicepulse/participants/{identifier}` - Auth: HTTP bearer Find one participant by its unique identifier. ## Path parameters - `identifier` string, uuid, required ## Response `200` One participant document found. Wrapped in a JsonAPI root response with document as data. - object - `data` Participant - `uuid` string, uuid - `createdAt` string, date-time - `createdBy` string, uuid - `lastUpdatedAt` string, date-time - `lastUpdatedBy` string, uuid - `lastUpdatedByAudience` string - `lastUpdatedByAudienceUuid` string, uuid - `lastUpdatedByImpersonatedBy` string, uuid - `lastUpdatedByCompanyUuid` string, uuid - `lastUpdatedByEnterpriseUuid` string, uuid - `companyUuid` string, uuid, required - `workerUuid` string, uuid, required - `topLevelAiData` TopLevelAiData - `averageSentiment` number - `analysisText` string - `aiKeyInsights` object[] - `analysisText` string - `insightName` string - `sentimentAnalysis` number - `status` 'completed' | 'errored' | 'notStarted' | 'pending' | 'skipped' - `virtualWorkesr` object - `uuid` string, uuid: Unique identifier - `createdAt` string, date-time: Creation timestamp - `createdBy` string, uuid: Creator UUID - `lastUpdatedAt` string, date-time: Last update timestamp - `lastUpdatedBy` string, uuid: Last updater UUID - `lastUpdatedByAudience` string: Audience of last updater - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater - `firstname` string, required - `lastname` string - `middlename` string - `hasNoMiddleName` boolean - `displayFullName` string - `dashboardUrl` object - `slug` string, required - `baseUrl` string - `personalEmail` object, required - `email` string, email, required - `verified` boolean - `verifiedAt` string, date-time - `workEmail` object - `email` string, email - `verified` boolean - `verifiedAt` string, date-time - `mobilePhone` object - `number` string - `countryCode` string - `verified` boolean - `verifiedAt` string, date-time - `prefersWhatsApp` boolean: The worker is reachable on WhatsApp at their mobile phone number - `homePhone` object - `number` string - `countryCode` string - `verified` boolean - `verifiedAt` string, date-time - `homeAddress` object - `address1` string - `address2` string - `city` string - `county` string - `zip` string - `state` string - `country` string - `timezone` string - `locale` string, nullable - `companyUuid` string, uuid, required - `company` object - `uuid` string, uuid - `name` string - `slug` string - `jobUuid` string, uuid, nullable - `job` object - `uuid` string, uuid - `name` string - `description` string - `jobIdentifiers` object[] - `jobUuid` string, uuid - `relationship` 'primary' | 'secondary' - `jobs` object[] - `uuid` string, uuid - `name` string - `description` string - `allowUnscheduledShift` boolean - `brandUuid` string, uuid, nullable - `brand` object - `uuid` string, uuid - `name` string - `einUuid` string, uuid, nullable - `ein` object - `uuid` string, uuid - `label` string - `locationUuid` string, uuid - `locationUuids` string[] - `locationGroupUuids` string[] - `locations` object[] - `uuid` string, uuid: Unique identifier - `createdAt` string, date-time: Creation timestamp - `createdBy` string, uuid: Creator UUID - `lastUpdatedAt` string, date-time: Last update timestamp - `lastUpdatedBy` string, uuid: Last updater UUID - `lastUpdatedByAudience` string: Audience of last updater - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater - `name` string, required - `description` string - `companyUuid` string, uuid - `street_address` string - `address_2` string - `city` string - `state_code` string - `postal_code` string - `country_code` 'US' | 'AD' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'AE' | 'UM' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': 2-letter ISO country code - `locationNotes` string - `timezone` string - `language` string - `hrisId` string: Stable identifier for this location in the customer's HRIS. Unique per company and immutable once set; used as a composite upsert lookup key. - `externalLocation` object: Metadata storage of the location data from an external source - `source` 'hire' | 'hire-go' | 'workday' | 'kombo', required - `externalIdentifier` string, required - `externalCreatedAt` string, date-time, required - `geolocation` object - `latitude` number, required - `longitude` number, required - `brandUuid` string, uuid, nullable - `isRemote` boolean - `ownerUuid` string, uuid, nullable - `locationGroupUuid` string, uuid, nullable - `virtualLocationGroup` object - `name` string - `tags` object[] - `uuid` string, uuid - `name` string - `people` object - `uuid` string, required: reference UUID of the people entity - `index` number, required: index of the number of profile for one people entity - `locked` boolean, required: whether the people entity is locked - `reasons` string[] - `history` object[] - `uuid` string, required - `index` number - `locked` boolean - `reasons` string[] - `replacedAt` string, nullable, required - `replacedBy` 'checkRehire' | 'identitySplit' | 'dataCollection' | 'manual', required - `rehire` object - `isRehire` boolean: whether the worker is a rehire - `uuid` string: UUID of the previous worker profile. Absent when there is no matching duplicate. - `reasons` string[]: Why the rehire flag was set. Mirrors people.reasons for deduplication context. - `externalId` string: reference ID in external HRIS - `externalSource` string: source of truth for worker externalId - `externalSourceAccount` string: account of the external source - `hrisId` string: The worker's id in the customer's HRIS, written by a Kombo sync in either direction - `applicantId` string: reference ID in ATS - `applicantSource` string: source of truth for worker applicantId - `backgroundCheckYardstikCandidateId` string: reference ID in 3rd party background check system - `dateOfBirth` string, date - `startDate` string, date - `hireDate` string, date - `terminationDate` string, date, nullable - `firstSeenAt` string, date-time - `lastSeenAt` string, date-time - `employmentStatus` object - `type` 'created' | 'preHire' | 'active' | 'rehire' | 'inactive' | 'terminated' | 'temporary' - `subtype` 'applicant' | 'employee' | 'leaveOfAbsence' | 'suspended' | 'seasonal' | 'furloughed' | 'resigned' | 'fired' | 'involuntarySeparation' | 'archived' - `lastStatusUpdateDate` string, date-time - `archivedOrigin` 'applicant' | 'worker', nullable - `avatar` string, uri - `manager` object - `uuid` string, uuid - `displayFullName` string - `customAttributes` object[] - `customAttributeUuid` string, uuid - `value` union, required - string - string[] - object - `uuid` string, uuid - `url` string - `metadata` object - object - `address` string - `address2` string - `city` string - `state` string - `zip` string - `country` string - boolean - unknown - `translatedValue` string - `selectedLabels` string[] - `invalid` boolean - `invalidDetail` string - `invalidSource` 'type' | 'rule' - `lastCheckedGeneration` integer: Definition generation this value was last checked against. Absent or older than the definition generation means the value is stale: not evaluated against the current rule. Read-only. - `validationStatus` 'valid' | 'invalid' | 'stale': Freshness of this value against the definition rule, derived on read from lastCheckedGeneration and the definition generation. `valid` and `invalid` mean the value was checked against the current generation; `invalid` carries invalidDetail. `stale` means the rule changed since the last check, so invalid and invalidDetail are not authoritative and the value refreshes on its next write. Absent when the definition carries no rule, or when worker attribute validation is off for the company. Read-only. - `customAttribute` object - `uuid` string, uuid - `createdAt` string, date-time: Creation timestamp - `createdBy` string, uuid: Creator UUID - `lastUpdatedAt` string, date-time: Last update timestamp - `lastUpdatedBy` string, uuid: Last updater UUID - `lastUpdatedByAudience` string: Audience of last updater - `lastUpdatedByAudienceUuid` string, uuid: Audience UUID of last updater - `lastUpdatedByImpersonatedBy` string, uuid: Impersonator UUID - `lastUpdatedByCompanyUuid` string, uuid: Company UUID of last updater - `lastUpdatedByEnterpriseUuid` string, uuid: Enterprise UUID of last updater - `companyUuid` string, uuid: Company UUID - `label` string, required - `key` string - `dataType` 'string' | 'number' | 'date' | 'boolean' | 'select' | 'address' | 'media' | 'signature' | 'complianceDocument', required - `description` string - `options` object[] - `value` string, required - `label` string - `archived` boolean: If true, this option is unavailable for new worker selections. - `hireValue` unknown - `resource` string - `resourceIdentifier` string, uuid - `readOnly` boolean: If true, this attribute cannot be modified. Can only be set by system. - `hidden` boolean: If true, this attribute won't be shown. Can only be set by system. - `protected` boolean: If true, this attribute can only be accessed by users with certain rights. - `hireDataKeyId` integer: The ID of the hire data key - `origin` 'wx' | 'hire': Which system authored this attribute definition - `attributeSectionUuid` string, uuid, nullable: UUID of the attributeSection this attribute is grouped under on the worker profile Attributes tab. Null, absent or a deleted section means unassigned: the UI renders an unassigned applicant-origin attribute (hireDataKeyId set) under the virtual "Applicant Attributes" section, otherwise under a trailing "Other" group. A hidden attribute never renders, even inside a company section. - `validation` union: Optional format rule enforced on this attribute. Absent means no rule: exactly the pre-validation behavior. Send null to remove a rule — over JSON that is the only way to say "clear it", since an absent key is a partial patch that leaves the stored rule alone. - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - unknown - `generation` integer: Monotonically increasing definition generation. Increments only when the validation rule changes. A value is current against the rule only when its lastCheckedGeneration equals this. Read-only. - `calculatedCustomAttributes` object - `segmentEnabled` boolean: if false, worker will not be in segment without the "include deactivated workers" option - `segmentUuids` string[]: list of the different segments the worker is matching - `messagingEnabled` boolean: if false, worker will not receive any message, except if the message has the "forceSend" option - `ssoEnabled` boolean: whether or not to enable Worker Portal SSO on this particular worker - `isTestWorker` boolean: declarative setting to help differenciate test workers from real workers - `importUpdatesLocked` boolean: if true, imported workers from our partners will update existing worker records with new data - `importProvider` 'none' | 'hire' - `technicalOptions` object - `lockEin` boolean: if true, do not allow to update the worker's EIN - `ssn` string - `appliedForSsn` boolean - `securityGroupUuids` string[] - `payRate` object - `uuid` string, uuid - `rate` number - `overtimeRate` number - `externalId` string - `currency` 'USD' | 'GBP' | 'EUR' - `createdAt` string, date-time - `payRateExceptions` object[] - `uuid` string, uuid - `rate` number - `overtimeRate` number - `currency` 'USD' | 'GBP' | 'EUR' - `locationUuid` string, uuid - `jobUuid` string, uuid - `externalId` string - `createdAt` string, date-time - `supervisorUuid` string, uuid, nullable: Employer acting as supervisor for this worker - `openingOwnerUuid` string, uuid, nullable: Employer acting as opening owner for this worker - `openingUuid` string, uuid: Opening UUID assigned to this worker - `hasBackendRole` boolean - `bank` object: Bank account details - `accountNumber` string: Bank account number - `name` string: Account holder’s name - `routingNumber` string: Bank routing number - `iban` string: International Bank Account Number - `nationalIdentificationNumber` string: National identification number - `nationalTaxIdentificationNumber` string: National tax identification number - `pronouns` string: Preferred pronouns - `nationality` 'US' | 'AD' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'AE' | 'UM' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW', nullable: Nationality as a 2-letter ISO 3166-1 alpha-2 country code - `gender` 'MALE' | 'FEMALE' | 'NON_BINARY' | 'OTHER' | 'DECLINE_TO_SELF_IDENTIFY' - `ethnicity` 'AMERICAN_INDIAN_OR_ALASKA_NATIVE' | 'ASIAN_OR_INDIAN_SUBCONTINENT' | 'BLACK_OR_AFRICAN_AMERICAN' | 'HISPANIC_OR_LATINO' | 'NATIVE_HAWAIIAN_OR_OTHER_PACIFIC_ISLANDER' | 'TWO_OR_MORE_RACES' | 'WHITE' | 'PREFER_NOT_TO_DISCLOSE' - `maritalStatus` 'SINGLE' | 'MARRIED_FILING_JOINTLY' | 'MARRIED_FILING_SEPARATELY' | 'HEAD_OF_HOUSEHOLD' | 'QUALIFYING_WIDOW_OR_WIDOWER_WITH_DEPENDENT_CHILD' - `veteranStatus` 'I_AM_NOT_A_PROTECTED_VETERAN' | 'I_IDENTIFY_AS_ONE_OR_MORE_OF_THE_CLASSIFICATIONS_OF_A_PROTECTED_VETERAN' | 'I_DONT_WISH_TO_ANSWER' - `disability` 'YES_I_HAVE_A_DISABILITY_OR_PREVIOUSLY_HAD_A_DISABILITY' | 'NO_I_DONT_HAVE_A_DISABILITY' | 'I_DONT_WISH_TO_ANSWER' - `underrepresentedGroupStatus` 'MEMBER_OF_UNDERREPRESENTED_GROUP' | 'NOT_A_MEMBER' | 'PREFER_NOT_TO_DISCLOSE' - `education` 'HIGH_SCHOOL_DIPLOMA_OR_EQUIVALENT' | 'SOME_COLLEGE' | 'ASSOCIATES_DEGREE' | 'BACHELORS_DEGREE' | 'MASTERS_DEGREE' | 'DOCTORAL_DEGREE' | 'PROFESSIONAL_DEGREE' - `driverLicenseNumber` string - `driverLicenseState` string - `driverLicenseExpirationDate` string - `talentUuid` string, uuid - `smsOptOut` object: SMS opt-out settings for the worker - `optedOutAt` string, date-time, nullable: ISO datetime (UTC) when the worker opted out - `status` boolean: Current opt-out status - `optedOutByAudience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent': Who initiated the opt-out - `optedOutByAudienceUuid` string, uuid: UUID of the entity that initiated the opt-out - `optedOutOverrideByAudienceUuid` string, nullable: UUID of the audience who overrode the opt-out - `optedOutOverrideAt` string, date-time, nullable: ISO datetime (UTC) when the opt-out was overridden - `senders` object[]: Sender numbers the worker stopped individually. Carrier-written; `status` outranks it - `number` string, required: Sender number the STOP arrived on - `optedOutAt` string, date-time: ISO datetime (UTC) when the worker stopped it - `optedOutByAudience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent': Who initiated the opt-out - `optedOutByAudienceUuid` string: UUID of the entity that initiated the opt-out - `whatsAppOptOut` object: WhatsApp opt-out settings for the worker - `optedOutAt` string, date-time, nullable: ISO datetime (UTC) when the worker opted out - `status` boolean: Current WhatsApp opt-out status - `optedOutByAudience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent': Who initiated the opt-out - `optedOutByAudienceUuid` string, uuid: UUID of the entity that initiated the opt-out - `optedOutOverrideByAudienceUuid` string, nullable: UUID of the audience who overrode the opt-out - `optedOutOverrideAt` string, date-time, nullable: ISO datetime (UTC) when the opt-out was overridden - `callOptOut` object, nullable: AI call opt-out. Only status is client-writable; attribution belongs to the server. - `status` boolean - `source` 'call' | 'admin' | 'worker' | 'system' - `executionUuid` string, uuid, nullable - `optedOutAt` string, date-time, nullable - `optedOutByAudience` 'worker' | 'employer' | 'enterpriseIdentity' | 'superUser' | 'system' | 'thirdParty' | 'kiosk' | 'agent' - `optedOutByAudienceUuid` string - `optedOutOverrideByAudienceUuid` string, nullable - `optedOutOverrideAt` string, date-time, nullable - `opening` object - `uuid` string, uuid - `title` string - `meta` ResponsesPartMeta - `timestamp` string, date-time, required - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE' - `path` string - `jti` string - `rid` string - `count` number - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it. - `status` string - `duration` number - `size` number ## Other responses - `500`: default error response --- [API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)