> ## Documentation Index > Fetch the complete documentation index at: https://support.profilebehavior.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Profile > Returns the report data for a specific individual If a custom ID has been applied to a profile via an Assessment Invite or other means, that `customId` can be used in place of the `profileId` when querying. ### Querying with Custom IDs * If querying with a `customId` this endpoint will return an array of profiles matching that ID versus a single document when querying with a `profileId`. * If a `customId` has only been applied to one profile, querying by that ID will still return an array with that single profile included. ## OpenAPI ````yaml GET /profile/{profileId} openapi: 3.1.0 info: title: Profile Behavior API description: > Unlock actionable behavioral insights for leadership, teamwork, recruiting, and team culture. Profile delivers powerful assessments, analytics, and reporting for businesses, athletic teams, and higher education. For full product information, code samples, and API reference, see our [support documentation](https://support.profilebehavior.com). > **LLMs and AI agents**: See [llms.txt](https://support.profilebehavior.com/llms.txt) for a machine-readable index of all documentation pages. > **MCP connector:** LLM clients (ChatGPT apps, Claude connectors) speak to `/mcp` over streamable HTTP. They discover OAuth automatically via [/.well-known/oauth-protected-resource](https://vanguard.profilebehavior.com/.well-known/oauth-protected-resource), returned in the `WWW-Authenticate` header on any 401. > **Legacy manifests:** - [/.well-known/ai-plugin.json](https://vanguard.profilebehavior.com/.well-known/ai-plugin.json) - [/.well-known/mcp.json](https://vanguard.profilebehavior.com/.well-known/mcp.json) version: 3.0.0 termsOfService: https://profilebehavior.com/legal/terms contact: name: Support url: https://profilebehavior.com/contact email: support@profilebehavior.com x-llm-sitemap: https://support.profilebehavior.com/llms.txt x-documentation-site: https://support.profilebehavior.com x-ai-plugin-manifest: https://vanguard.profilebehavior.com/.well-known/ai-plugin.json x-mcp-manifest: https://vanguard.profilebehavior.com/.well-known/mcp.json x-mcp-endpoint: https://vanguard.profilebehavior.com/mcp x-oauth-protected-resource: https://vanguard.profilebehavior.com/.well-known/oauth-protected-resource servers: - url: https://vanguard.profilebehavior.com/api/v4 security: - M2M: [] - OAuth2: [] tags: - name: test description: Endpoints for testing the API. - name: assessment_invites description: Information on sending invitations to take the assessment. - name: assessments description: Behavioral, leadership, and communication assessment endpoints. - name: accounts description: >- Endpoints for retrieving and managing account and organization information. - name: fixtures description: Endpoints for retrieving fixture data content such as report language. - name: playbook_ai description: Endpoints for generating and retrieving Playbook AI related content. - name: profiles description: Endpoints for individual behavioral profile management. - name: resource_aliases description: >- Endpoints for managing resource alias records that link Profile data to custom defined keys. - name: tags description: >- Endpoints for individual profile tags, categorization, and group management. paths: /profile/{profileId}: get: tags: - profiles summary: Get information about a specific profile by ID description: | Returns the report data for a specific individual operationId: GetProfile parameters: - name: profileId in: path description: | ID of the profile to retrieve required: true schema: type: string responses: '200': description: Success content: application/json: schema: allOf: - $ref: '#/components/schemas/Success' - type: object properties: profile: $ref: '#/components/schemas/Profile' example: code: 200 profile: id: 60e9ca73c500a9001534ad84 createdAt: '2025-09-26T13:49:53.256Z' updatedAt: '2025-09-26T14:37:29.157Z' email: hello@profilebehavior.com firstName: John lastName: Doe disc: style: CS d: 34.66185580566288 i: 19.018670835970415 s: 66.40729193181404 c: 84.98081737824077 core: first: freedom second: wealth third: wisdom fourth: familyHappiness fifth: achievement focus: flexibility: score: 88 level: veryHigh facets: creativity: score: 100 level: veryHigh aestheticAppreciation: score: 87 level: veryHigh emotionalAwareness: score: 68 level: high innovativeness: score: 75 level: high intellectualCuriosity: score: 100 level: veryHigh openMindedness: score: 100 level: veryHigh organization: score: 78 level: high facets: selfBelief: score: 87 level: veryHigh systemization: score: 75 level: high responsibility: score: 68 level: high goalOriented: score: 87 level: veryHigh discipline: score: 50 level: baseline prudence: score: 100 level: veryHigh communication: score: 23 level: low facets: friendliness: score: 6 level: veryLow sociability: score: 0 level: veryLow leadership: score: 37 level: low vigor: score: 37 level: low adventureSeeking: score: 12 level: veryLow cheerfulness: score: 50 level: baseline understanding: score: 46 level: baseline facets: trust: score: 37 level: low integrity: score: 50 level: baseline generosity: score: 75 level: high teamwork: score: 25 level: low humility: score: 56 level: baseline compassion: score: 37 level: low stability: score: 81 level: veryHigh facets: composure: score: 68 level: high temperance: score: 93 level: veryHigh optimism: score: 81 level: veryHigh confidence: score: 56 level: baseline selfControl: score: 93 level: veryHigh resilience: score: 93 level: veryHigh availableAssessments: - 64b935448d1d9b54cb9cb5d5 - 6047fca80001b34e77245e71 - 6047fcba0001b34e77245e73 completedAssessments: - 64b935448d1d9b54cb9cb5d5 - 6047fca80001b34e77245e71 - 6047fcba0001b34e77245e73 isCompleted: true dateStarted: '2025-09-26T13:49:53.255Z' timers: - assessment: 64b935448d1d9b54cb9cb5d5 isCompleted: true activeSeconds: 522 inactiveSeconds: 49 dateStarted: '2025-09-26T14:18:01.343Z' dateCompleted: '2025-09-26T14:27:25.489Z' lastUpdated: '2025-09-26T14:27:01.890Z' - assessment: 6047fca80001b34e77245e71 isCompleted: true activeSeconds: 318 inactiveSeconds: 43 dateStarted: '2025-09-26T14:27:28.496Z' dateCompleted: '2025-09-26T14:33:27.569Z' lastUpdated: '2025-09-26T14:32:59.021Z' - assessment: 6047fcba0001b34e77245e73 isCompleted: true activeSeconds: 210 inactiveSeconds: 0 dateStarted: '2025-09-26T14:33:30.446Z' dateCompleted: '2025-09-26T14:37:27.650Z' lastUpdated: '2025-09-26T14:37:00.940Z' dateCompleted: '2025-09-26T14:37:29.157Z' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: schemas: Success: type: object description: > Standard response object for successful single-resource requests in the Profile Behavior API. Contains an HTTP status code, the returned resource data, and a status indicator. required: - code properties: code: type: integer format: int32 description: HTTP status code of the successful response. status: type: string description: Always "success" for successful responses. enum: - success Profile: allOf: - $ref: '#/components/schemas/BaseModel' - type: object description: Represents a behavioral assessment report for an individual. required: - email properties: firstName: type: string description: The individual's given name. lastName: type: string description: The individual's surname. email: type: string description: The email associated with the individual's profile. avatar: type: string description: The URL of the uploaded avatar image of the profile. availableAssessments: type: array items: type: string description: >- A list of assessment ids that are available for the profile to take. completedAssessments: type: array items: type: string description: A list of assessment ids that the profile has completed. focus: $ref: '#/components/schemas/Focus' type: object description: | The results of the Focus assessment for the profile. disc: $ref: '#/components/schemas/DISC' type: object description: | The results of the DISC assessment for the profile. core: $ref: '#/components/schemas/Core' type: object description: | The results of the Core assessment for the profile. isCompleted: type: boolean description: Whether the profile has been flagged as completed. dateStarted: type: string format: date-time description: When the individual started taking the assessments. dateCompleted: type: string format: date-time description: When the individual completed the available assessments. timers: type: array description: >- An array of timers used for measuring time spent engaging with each assessment. items: $ref: '#/components/schemas/Timer' type: object BaseModel: type: object description: > Base schema that provides unique identification and timestamp metadata for resources in the Profile Behavior API. required: - id - createdAt - updatedAt properties: id: type: string description: Globally unique identifier for this resource. createdAt: type: string format: date-time description: ISO 8601 timestamp indicating when the resource was created. updatedAt: type: string format: date-time description: ISO 8601 timestamp indicating when the resource was last updated. Focus: allOf: - type: object description: Represents a record of Focus assessment results. properties: flexibility: type: object description: Results for the Flexibility Focus domain. properties: score: type: integer format: int32 description: The score for the Flexibility domain ranging between 0-100. level: type: string description: A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh facets: type: object description: The facets of the Flexibility domain. properties: creativity: type: object properties: score: type: integer format: int32 description: >- The score for the Creativity facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh aestheticAppreciation: type: object properties: score: type: integer format: int32 description: >- The score for the Aesthetic Appreciation facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh emotionalAwareness: type: object properties: score: type: integer format: int32 description: >- The score for the Emotional Awareness facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh innovativeness: type: object properties: score: type: integer format: int32 description: >- The score for the Innovativeness facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh intellectualCuriosity: type: object properties: score: type: integer format: int32 description: >- The score for the Intellectual Curiosity facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh openMindedness: type: object properties: score: type: integer format: int32 description: >- The score for the Open-Mindedness facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh organization: type: object description: Results for the Organization Focus domain. properties: score: type: integer format: int32 description: The score for the Organization domain ranging between 0-100. level: type: string description: A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh facets: type: object description: The facets of the Organization domain. properties: selfBelief: type: object properties: score: type: integer format: int32 description: >- The score for the Self-Belief facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh systemization: type: object properties: score: type: integer format: int32 description: >- The score for the Systemization facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh responsibility: type: object properties: score: type: integer format: int32 description: >- The score for the Responsibility facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh goalOriented: type: object properties: score: type: integer format: int32 description: >- The score for the Goal-Oriented facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh discipline: type: object properties: score: type: integer format: int32 description: >- The score for the Discipline facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh prudence: type: object properties: score: type: integer format: int32 description: >- The score for the Prudence facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh communication: type: object description: Results for the Communication Focus domain. properties: score: type: integer format: int32 description: >- The score for the Communication domain ranging between 0-100. level: type: string description: A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh facets: type: object description: The facets of the Communication domain. properties: friendliness: type: object properties: score: type: integer format: int32 description: >- The score for the Friendliness facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh sociability: type: object properties: score: type: integer format: int32 description: >- The score for the Sociability facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh leadership: type: object properties: score: type: integer format: int32 description: >- The score for the Leadership facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh vigor: type: object properties: score: type: integer format: int32 description: The score for the Vigor facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh adventureSeeking: type: object properties: score: type: integer format: int32 description: >- The score for the Adventure-Seeking facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh cheerfulness: type: object properties: score: type: integer format: int32 description: >- The score for the Cheerfulness facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh understanding: type: object description: Results for the Understanding Focus domain. properties: score: type: integer format: int32 description: >- The score for the Understanding domain ranging between 0-100. level: type: string description: A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh facets: type: object description: The facets of the Understanding domain. properties: trust: type: object properties: score: type: integer format: int32 description: The score for the Trust facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh integrity: type: object properties: score: type: integer format: int32 description: >- The score for the Integrity facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh generosity: type: object properties: score: type: integer format: int32 description: >- The score for the Generosity facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh teamwork: type: object properties: score: type: integer format: int32 description: >- The score for the Teamwork facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh humility: type: object properties: score: type: integer format: int32 description: >- The score for the Humility facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh compassion: type: object properties: score: type: integer format: int32 description: >- The score for the Compassion facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh stability: type: object description: Results for the Stability Focus domain. properties: score: type: integer format: int32 description: The score for the Stability domain ranging between 0-100. level: type: string description: A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh facets: type: object description: The facets of the Stability domain. properties: composure: type: object properties: score: type: integer format: int32 description: >- The score for the Composure facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh temperance: type: object properties: score: type: integer format: int32 description: >- The score for the Temperance facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh optimism: type: object properties: score: type: integer format: int32 description: >- The score for the Optimism facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh confidence: type: object properties: score: type: integer format: int32 description: >- The score for the Confidence facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh selfControl: type: object properties: score: type: integer format: int32 description: >- The score for the Self-Control facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh resilience: type: object properties: score: type: integer format: int32 description: >- The score for the Resilience facet ranging between 0-100. level: type: string description: >- A value which describes which quintile the score falls into. enum: - veryLow - low - baseline - high - veryHigh DISC: allOf: - type: object description: Represents a record of DISC assessment results. properties: style: type: string description: > A letter style which represents which of the DISC behavioral styles used to understand individual preferences and tendencies are scored over 50 and ordered by intensity. d: type: integer format: float64 description: >- A score for the Dominance DISC behavioral trait ranging between 0-100. i: type: integer format: float64 description: >- A score for the Influence DISC behavioral trait ranging between 0-100. s: type: integer format: float64 description: >- A score for the Steadiness DISC behavioral trait ranging between 0-100. c: type: integer format: float64 description: >- A score for the Correctness DISC behavioral trait ranging between 0-100. Core: allOf: - type: object description: Represents a record of Core assessment results. properties: first: type: string description: The name of the value ranked first for a scored Core assessment. second: type: string description: >- The name of the value ranked second for a scored Core assessment. third: type: string description: The name of the value ranked third for a scored Core assessment. fourth: type: string description: >- The name of the value ranked fourth for a scored Core assessment. fifth: type: string description: The name of the value ranked fifth for a scored Core assessment. Timer: allOf: - type: object description: > A timer object which indicates the active and inactive time for a profile while taking a specific assessment. properties: assessment: type: string description: The ID of the assessment associated with the timer. isCompleted: type: boolean description: Whether the assessment has been finished and scored. activeSeconds: type: integer format: int32 description: > Seconds spent actively taking the assessment, meaning seconds the individual spent engaged with the assessment while accounting for time for thinking. inactiveSeconds: type: integer format: int32 description: > Seconds spent inactive while taking the assessment, meaning seconds the individual spent idling and not actively engaging with the assessment. dateStarted: type: string format: date-time description: When the individual started taking the associated assessment. dateCompleted: type: string format: date-time description: >- When the individual submitted their answers for scoring for the associated assessment. lastUpdated: type: string format: date-time description: > The last the timer was updated which can indicate ongoing participation for an in-progress assessment. Error: type: object description: > Standard error response object returned by the Profile Behavior API. Contains a machine-readable error code, a human-readable message, and detailed technical information for debugging or support purposes. required: - code - error - status properties: code: type: integer format: int32 description: HTTP status code associated with the error. error: type: object required: - details - timestamp properties: message: type: string description: A human-readable summary describing the error. timestamp: type: string format: date-time description: ISO 8601 timestamp when the error occurred. status: type: string description: Always "error" for error responses. enum: - error responses: BadRequest: description: Invalid request body content: application/json: schema: $ref: '#/components/schemas/Error' example: code: 400 error: message: Invalid request body timestamp: '2025-01-01T09:42:52.329056-05:00' status: error Unauthorized: description: Unauthorized - authentication required. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: 401 error: message: Invalid token timestamp: '2025-01-01T09:42:52.329056-05:00' status: error NotFound: description: Not Found - resource requested could not be located in the database. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: 404 error: message: (resource) not found timestamp: '2025-01-01T09:42:52.329056-05:00' status: error securitySchemes: M2M: type: http scheme: bearer OAuth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://login.profilebehavior.com/oauth/authorize tokenUrl: https://login.profilebehavior.com/oauth/token scopes: profiles:read: Read profiles and behavioral summaries (scores, AI debriefs) profiles:write: Create, update, delete profiles and send assessment invites tags:manage: Create, update, delete, and assign tags account:read: Read account details, assessments, and resource aliases account:write: Update account settings and resource aliases description: > OAuth 2.1 authorization code flow with PKCE. Use this whenever your integration acts on behalf of a specific Profile user: third-party apps, AI agents and MCP servers, and any browser-based or CLI tool a user signs in to. Tokens issued under this scheme are scoped to one Profile account (the one the user consented from) and carry OAuth scopes that narrow what the integration can do. Discovery is served at [/.well-known/oauth-protected-resource](/.well-known/oauth-protected-resource). The authorization server is Stytch Connected Apps, which supports Dynamic Client Registration for on-the-fly clients (e.g. MCP agents) in addition to pre-registered integrations. ````