> ## Documentation Index > Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt > Use this file to discover all available pages before exploring further. # List the individuals your organization has verified > Lists every individual your organization holds a `prn_` reference for, most recent activity first by default: their current verification state, the businesses they operate under your coverage, and when they last saw activity. Filter by verification state, business link and verification date; search by reference, name, email or phone. Scoped to your own population — references issued by other organizations are not listed and are not searchable. ## OpenAPI ````yaml /api-reference/openapi.json get /issuance/identities/individuals openapi: 3.1.0 info: title: baselayer-api-service version: 0.1.0 servers: - url: https://api.baselayer.com/ security: [] paths: /issuance/identities/individuals: get: tags: - Identities summary: List the individuals your organization has verified description: >- Lists every individual your organization holds a `prn_` reference for, most recent activity first by default: their current verification state, the businesses they operate under your coverage, and when they last saw activity. Filter by verification state, business link and verification date; search by reference, name, email or phone. Scoped to your own population — references issued by other organizations are not listed and are not searchable. operationId: issuance_identities_individuals_list parameters: - name: limit in: query required: false schema: type: integer maximum: 1000 minimum: 1 description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. default: 10 title: Limit description: >- Maximum number of records to return in a single page. Must be between 1 and 1000. - name: offset in: query required: false schema: anyOf: - type: integer minimum: 0 - type: 'null' description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. title: Offset description: >- Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. title: Cursor description: >- Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset. - name: sort in: query required: false schema: anyOf: - $ref: '#/components/schemas/IdentityIndividualSortField' - type: 'null' description: >- `last_activity`, `name` (given then family name, ignoring case) or `verified_at`; ties break on when the snapshot was recorded, then its id. Defaults to `last_activity` `desc`. title: Sort description: >- `last_activity`, `name` (given then family name, ignoring case) or `verified_at`; ties break on when the snapshot was recorded, then its id. Defaults to `last_activity` `desc`. - name: sort_direction in: query required: false schema: anyOf: - $ref: '#/components/schemas/SortMethod' - type: 'null' description: >- `asc` or `desc`, for every key of the sort. Defaults to the field's own: `last_activity` `desc`, `name` `asc`, `verified_at` `desc`. title: Sort Direction description: >- `asc` or `desc`, for every key of the sort. Defaults to the field's own: `last_activity` `desc`, `name` `asc`, `verified_at` `desc`. - name: verification_state in: query required: false schema: anyOf: - $ref: '#/components/schemas/IdentityVerificationState' - type: 'null' description: >- Only identities in this derived state: CURRENT or EXPIRED. SUPERSEDED never matches: the list carries one row per person — their current verification — and superseded snapshots are lineage, not population. title: Verification State description: >- Only identities in this derived state: CURRENT or EXPIRED. SUPERSEDED never matches: the list carries one row per person — their current verification — and superseded snapshots are lineage, not population. - name: link in: query required: false schema: anyOf: - $ref: '#/components/schemas/IdentityDirectoryLink' - type: 'null' description: >- `linked` (a verified link to a business), `link_request` (a link awaiting your review) or `none` (no business, or only rejected links). Your organization's own links only. title: Link description: >- `linked` (a verified link to a business), `link_request` (a link awaiting your review) or `none` (no business, or only rejected links). Your organization's own links only. - name: verified_after in: query required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Only people whose current verification was recorded at or after this instant. Must carry a UTC offset. title: Verified After description: >- Only people whose current verification was recorded at or after this instant. Must carry a UTC offset. - name: verified_before in: query required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Only people whose current verification was recorded before this instant (exclusive). Must carry a UTC offset. title: Verified Before description: >- Only people whose current verification was recorded before this instant (exclusive). Must carry a UTC offset. - name: search in: query required: false schema: anyOf: - type: string maxLength: 200 - type: 'null' description: >- A `prn_` reference, or free text matched against name, email and phone. Every whitespace-separated term must match. title: Search description: >- A `prn_` reference, or free text matched against name, email and phone. Every whitespace-separated term must match. responses: '200': description: >- Paginated identities in the requested order, scoped to the calling organization. content: application/json: schema: type: array items: $ref: '#/components/schemas/v1.IdentityListItemResponse' application/vnd.baselayer.v1+json: schema: type: array items: $ref: '#/components/schemas/v1.IdentityListItemResponse' headers: X-Total-Count: description: Total number of records matching the query. schema: type: integer X-Total-Pages: description: Total number of pages available based on the current limit. schema: type: integer X-Next-Cursor: description: >- Cursor for the next page (only present when using the keyset pagination and if `has_more` is true. schema: type: string '422': description: The request is invalid. content: application/json: schema: $ref: '#/components/schemas/Error' title: ValidationFailed description: The request is invalid. examples: - type: validation_failed code: 7112 message: The request is invalid. metadata: {} security: - APIKeyHeader: [] components: schemas: IdentityIndividualSortField: type: string enum: - last_activity - name - verified_at title: IdentityIndividualSortField description: What the people list sorts by. SortMethod: type: string enum: - asc - desc title: SortMethod IdentityVerificationState: description: |- Verification state of an identity, as seen by the referencing organization. CURRENT: an unexpired verification exists and credentials can be minted. EXPIRED: the verification's validity window has lapsed — re-verify before minting. SUPERSEDED: no active verification record remains; a new submission is required. enum: - CURRENT - EXPIRED - SUPERSEDED title: IdentityVerificationState type: string IdentityDirectoryLink: type: string enum: - linked - link_request - none title: IdentityDirectoryLink description: |- The people list's business segments, read off the organization's own operator links. v1.IdentityListItemResponse: description: |- One person in ``GET /issuance/identities/individuals``. The row an operator scans a population by: who the identity is, whether it can still mint, and how much it has been used. Everything is scoped to the calling organization — the reference, the covered links counted, and the credentials counted are all its own. properties: individual_ref: description: This organization's pairwise reference to the individual. title: Individual Ref type: string display_name: description: >- The verified name, as the latest snapshot recorded it. Mask it in shared surfaces; the API returns what the organization itself submitted. title: Display Name type: string verification_state: $ref: '#/components/schemas/v1.IdentityVerificationState' description: >- CURRENT, or EXPIRED (re-verify before minting). Derived from the snapshot's validity window, never stored. verification_level: anyOf: - type: integer - type: 'null' default: null description: >- Verification level derived from active_keys; null when the attested attributes are insufficient for any defined level. title: Verification Level active_keys: description: >- Names of the individual verification checks the identity currently holds (e.g. `phone_possession`, `ssn_identity_match`), from the token-exchange profile's key vocabulary; verification_level is derived from them. A re-verification keeps an earlier `phone_possession` it cannot re-run. items: type: string title: Active Keys type: array linked_business_count: description: >- Businesses this organization covers a live operator link to for the individual; rejected links are not counted. title: Linked Business Count type: integer businesses: description: >- Up to three of the businesses counted by `linked_business_count`: verified links first, then link requests, each oldest first. items: $ref: '#/components/schemas/v1.IdentityListBusinessResponse' title: Businesses type: array last_activity_at: description: >- The latest of: verified or re-verified, a link confirmed or decided, an agent credential issued or revoked. Your organization's own activity only. format: date-time title: Last Activity At type: string credentials_minted_30d: description: >- Credentials this organization minted for the individual in the last 30 days, counting business credentials it acted for. title: Credentials Minted 30D type: integer verified_at: description: When the latest verification was recorded. format: date-time title: Verified At type: string expires_at: description: When the latest verification expires. format: date-time title: Expires At type: string required: - individual_ref - display_name - verification_state - linked_business_count - last_activity_at - credentials_minted_30d - verified_at - expires_at title: IdentityListItemResponse (v1) type: object Error: properties: type: type: string title: Type description: >- Stable snake_case name of the error. Branch on this, never on `message`. code: type: integer title: Code description: Integer catalog code of the error. message: type: string title: Message description: For a human reading a log; not stable and not localized. metadata: additionalProperties: true type: object title: Metadata description: Context documented per `type`. request_id: anyOf: - type: string - type: 'null' title: Request Id description: The `X-Request-ID` of the failed request. type: object required: - type - code - message title: Error description: The one body of every error a KYA route answers. v1.IdentityVerificationState: description: |- Verification state of an identity, as seen by the referencing organization. CURRENT: an unexpired verification exists and credentials can be minted. EXPIRED: the verification's validity window has lapsed — re-verify before minting. SUPERSEDED: no active verification record remains; a new submission is required. enum: - CURRENT - EXPIRED - SUPERSEDED title: IdentityVerificationState type: string v1.IdentityListBusinessResponse: description: One business a person in the list operates, as the row names it. properties: business_ref: description: Pairwise reference to the linked business. title: Business Ref type: string legal_name: description: The linked business's current legal name. title: Legal Name type: string status: $ref: '#/components/schemas/v1.BusinessOperatorLinkStatus' description: >- VERIFIED (linked) or UNDER_REVIEW (a link request); rejected links are never listed. required: - business_ref - legal_name - status title: IdentityListBusinessResponse (v1) type: object v1.BusinessOperatorLinkStatus: description: |- Your organization's status for the link between an individual and a business they operate. VERIFIED is earned by the full evidence recipe (TIN provided + IRS-matched + KYB-verified) on one of your own sessions, or decided by your organization; UNDER_REVIEW is every automatic shortfall; REJECTED is your organization's refusal, which stands until you decide again. Another organization's evidence or decision never changes it. enum: - VERIFIED - UNDER_REVIEW - REJECTED title: BusinessOperatorLinkStatus type: string securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-Key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.