> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Read a profile > Handles, subject kind and links of a profile, masked for the role of the reader. ## OpenAPI ````yaml openapi/en/cell.json GET /v1/profiles/{profile_id} openapi: 3.1.0 info: title: Niadra data API version: '1' description: >- Writing, context, history, objects, identity, privacy and governance of one space. Every space has a stable address, with the space and the region in its name. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: The space, which comes in the source key. region: default: us-east-1 description: The region of the space, which also comes in the key. security: [] paths: /v1/profiles/{profile_id}: get: tags: - identity summary: Read a profile description: >- A profile: subject kind, pseudonym, handles with their status and verification level, and the links to accounts and partners. Contact values are masked unless the role of the reader may see them. **Authentication.** Console person token with the `security`, `integration` role (or admin), or a source key with the `admin` scope. operationId: get_profile_v1_profiles__profile_id__get parameters: - in: path name: profile_id required: true schema: format: uuid title: Profile Id type: string example: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e01 responses: '200': content: application/json: schema: $ref: '#/components/schemas/ProfileOut' example: profile_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e01 pseudonym: p_7f3a91c2 kind: person partial: false handles: - handle_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e02 type: phone_e164 value: +1415555**** scope: '' subject_kind: person status: active level: V1 first_seen: '2021-04-06T13:20:00Z' last_seen: '2026-09-22T17:07:03Z' - handle_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e03 type: system_id value: '48213' scope: crm subject_kind: person status: active level: V4 first_seen: '2021-04-06T13:21:00Z' last_seen: '2026-09-22T17:07:03Z' links: - link_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e08 person_handle_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e02 org_handle_id: 0192f7a1-5b10-7c3a-8e21-4d2f8a4c0e05 role: buyer can_see_contacts: false valid_from: '2026-09-22T17:10:00Z' valid_to: null membership_version: 7 privacy_version: 2 description: The profile. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: The request does not match the contract. security: - sourceKey: [] - personToken: [] components: schemas: ProfileOut: additionalProperties: false properties: handles: items: $ref: '#/components/schemas/HandleOut' title: Handles type: array kind: $ref: '#/components/schemas/SubjectKind' links: items: $ref: '#/components/schemas/LinkOut' title: Links type: array membership_version: title: Membership Version type: integer partial: description: Known only by channel-private ids such as a BSUID. title: Partial type: boolean privacy_version: title: Privacy Version type: integer profile_id: format: uuid title: Profile Id type: string pseudonym: title: Pseudonym type: string required: - profile_id - kind - pseudonym - membership_version - privacy_version - partial - handles - links title: ProfileOut type: object Problem: additionalProperties: false description: RFC 9457 problem details; `code` comes from the versioned error catalog. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object HandleOut: additionalProperties: false properties: first_seen: format: date-time title: First Seen type: string handle_id: format: uuid title: Handle Id type: string last_seen: format: date-time title: Last Seen type: string level: $ref: '#/components/schemas/Verification' scope: title: Scope type: string status: $ref: '#/components/schemas/HandleStatus' subject_kind: $ref: '#/components/schemas/SubjectKind' type: $ref: '#/components/schemas/HandleType' value: description: Masked by the caller's role. title: Value type: string required: - handle_id - type - scope - subject_kind - value - status - level - first_seen - last_seen title: HandleOut type: object SubjectKind: enum: - person - account - partner title: SubjectKind type: string description: >- A person, a customer organization (`account`) or an organization that takes part without being a customer (`partner`). LinkOut: additionalProperties: false properties: can_see_contacts: title: Can See Contacts type: boolean link_id: format: uuid title: Link Id type: string org_handle_id: format: uuid title: Org Handle Id type: string person_handle_id: format: uuid title: Person Handle Id type: string role: title: Role type: string valid_from: format: date-time title: Valid From type: string valid_to: anyOf: - format: date-time type: string - type: 'null' title: Valid To required: - link_id - person_handle_id - org_handle_id - role - can_see_contacts - valid_from title: LinkOut type: object Verification: description: Session verification levels. `no_customer` sits outside the V0-V4 scale. enum: - V0 - V1 - V2 - V3 - V4 - no_customer title: Verification type: string HandleStatus: enum: - active - ambiguous - blocked - suspected_recycled title: HandleStatus type: string HandleType: enum: - phone_e164 - wa_id - wa_jid - wa_lid - wa_bsuid - email - gov_id_hmac - app_user_id - system_id - org_registry_hmac - email_domain - anon_id title: HandleType type: string description: >- The kind of identifier. The value is classified by its format, never by the field it came from. securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... personToken: type: http scheme: bearer bearerFormat: JWT ````