> ## Documentation Index > Fetch the complete documentation index at: https://developers.respondent.io/llms.txt > Use this file to discover all available pages before exploring further. > Retrieve a participant's profile including engagement history and available profile fields. Note: some demographic and professional fields are being deprecated — refer to the changelog for details. # Retrieve participant profile ## OpenAPI ````yaml get /v1/profiles/{profileId} openapi: 3.0.0 info: title: Partner API description: Public API for partner integrations version: '1.0' contact: {} servers: - url: https://api-staging.respondent.io security: [] tags: [] paths: /v1/profiles/{profileId}: get: tags: - profiles summary: Retrieve participant profile description: >- Retrieves a participant profile by ID. **Breaking change (Prod: Apr 1, Staging: Mar 18):** Response will no longer include `lastName`, `location`, `age`, `gender`, `educationLevel`, `householdIncome`, `industry`, `jobFunctions`, `company`, `companySize`, `seniorityLevel`. operationId: ProfilesController_findOne parameters: - name: x-api-key in: header required: true schema: type: string - name: x-api-secret in: header required: true schema: type: string - name: profileId required: true in: path schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/Profile' components: schemas: Profile: type: object properties: id: type: string format: ObjectId userId: type: string format: ObjectId firstName: type: string lastInitial: type: string picture: type: string nullable: true jobTitle: type: string employmentStatus: $ref: '#/components/schemas/EmploymentStatus' jobFunctions: type: array items: $ref: '#/components/schemas/JobFunction' linkedinUrl: type: string skills: default: [] type: array items: $ref: '#/components/schemas/SimpleSkill' topics: deprecated: true type: array items: $ref: '#/components/schemas/SimpleTopic' company: type: string deprecated: true companySize: $ref: '#/components/schemas/CompanySize' location: deprecated: true allOf: - $ref: '#/components/schemas/ProfileLocation' gender: $ref: '#/components/schemas/Gender' age: type: string deprecated: true educationLevel: $ref: '#/components/schemas/EducationLevel' ethnicity: $ref: '#/components/schemas/Ethnicities' householdIncome: $ref: '#/components/schemas/HouseholdIncome' industry: deprecated: true type: array items: type: string seniorityLevel: $ref: '#/components/schemas/SeniorityLevel' gdprDeletedAt: type: string description: >- Indicates this profile was GDPR deleted, and their data has been anonymized. Their associated screeners will also be deleted. socialLinks: type: object deprecated: true required: - id - userId - firstName - lastInitial - skills EmploymentStatus: type: string enum: - owner - employedfulltime - employedparttime - unemployedlookingforwork - unemployed - retired - disabled - homemaker - fulltimestudent - parttimestudent JobFunction: type: string description: |- Available for Industry professionals (B2B) projects Max: 3 enum: - accountingAuditing - administrative - advertising - analyst - artCreative - businessDevelopment - consulting - customerService - distribution - design - education - finance - generalBusiness - healthcareProvider - humanResources - informationTechnology - legal - management - manufacturing - marketing - other - publicRelations - purchasing - productManagement - projectManagement - production - qualityAssurance - research - sales - science - strategyPlanning - supplyChain - training - writingEditing SimpleSkill: type: object properties: id: type: string format: ObjectId name: type: string slug: type: string validated: type: boolean default: false type: type: string default: skill required: - id - name - slug - validated - type SimpleTopic: type: object properties: id: type: string format: ObjectId name: type: string required: - id - name CompanySize: type: string enum: - selfemployed - 1-10 - 11-50 - 51-200 - 201-500 - 501-1000 - 1001-5000 - 5001-10000 - 10000+ - all ProfileLocation: type: object properties: city: $ref: '#/components/schemas/ProfileLocationCity' zipcode: type: string default: null state: type: string loc: $ref: '#/components/schemas/ProfileLocationLoc' required: - city - loc Gender: type: string enum: - male - female - other - nonbinary - transmale - transfemale - prefernottoanswer - N/A EducationLevel: type: string enum: - somehighschool - highschoolgraduate - somecollegenodegree - tradetechnicalvocationaltraining - associatedegree - bachelordegree - masterdegree - doctoratedegree - N/A Ethnicities: type: string enum: - americanindianalaskannative - hispaniclatino - blackorafricanamerican - asianpacificislander - whitecaucasian - middleeastern - multipleethnicity - prefernotdisclose - N/A HouseholdIncome: type: string enum: - <30000 - 30000-39999 - 40000-59999 - 60000-79999 - 80000-99999 - 100000-149999 - 150000-199999 - 200000+ - all - all SeniorityLevel: type: string enum: - unpaid - student - training - entrylevel - senior - manager - director - chiefofficer - partner - vicepresident ProfileLocationCity: type: object properties: id: type: string country: $ref: '#/components/schemas/CountryCode' city: type: string state: type: string formattedAddress: type: string administrative_area_level_1: type: string postal_code: type: string locality: type: string location: $ref: '#/components/schemas/ProfileLocationCityLocation' zip: type: string nullable: true required: - id - country - city - formattedAddress - location ProfileLocationLoc: type: object properties: type: type: string coordinates: type: array items: type: number required: - type - coordinates CountryCode: type: string enum: - AF - AX - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BV - BR - VG - IO - BN - BG - BF - BI - CV - KH - CM - CA - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CK - CR - HR - CU - CW - CY - CZ - CI - CD - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - KP - MK - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RO - RW - RE - SH - KN - LC - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SK - SI - SB - SO - ZA - GS - KR - ES - LK - SD - SR - SJ - SE - CH - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TM - TC - TV - TR - VI - UG - UA - AE - GB - UM - US - UY - UZ - VU - VE - VN - WF - EH - YE - ZM - ZW - all ProfileLocationCityLocation: type: object properties: latitude: type: number longitude: type: number required: - latitude - longitude ````