> ## 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 onboarded

> Lists every individual your organization holds an accepted record of, whether Baselayer verified them or you pushed them as verified yourself, most recent activity first by default: their keys with each one's basis, how many businesses they operate under your coverage, and when they were last updated. Filter by business link and by the day the latest record was accepted (`start_date`/`end_date`, over `updated_at`); 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 onboarded
      description: >-
        Lists every individual your organization holds an accepted record of,
        whether Baselayer verified them or you pushed them as verified yourself,
        most recent activity first by default: their keys with each one's basis,
        how many businesses they operate under your coverage, and when they were
        last updated. Filter by business link and by the day the latest record
        was accepted (`start_date`/`end_date`, over `updated_at`); 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
              `updated_at`; ties break on when the record was created, then its
              id. Defaults to `last_activity` `desc`.
            title: Sort
          description: >-
            `last_activity`, `name` (given then family name, ignoring case) or
            `updated_at`; ties break on when the record was created, 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`, `updated_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`, `updated_at` `desc`.
        - name: link
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/IndividualLinkFilter'
              - 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: 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.
        - name: start_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: 'Filter records created on or after this date (format: YYYY-MM-DD).'
            title: Start Date
          description: 'Filter records created on or after this date (format: YYYY-MM-DD).'
        - name: end_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: >-
              Filter records created on or before this date (format:
              YYYY-MM-DD).
            title: End Date
          description: 'Filter records created on or before this date (format: YYYY-MM-DD).'
        - name: tz
          in: query
          required: false
          schema:
            type: string
            description: >-
              IANA timezone identifier used to interpret start_date and end_date
              (defaults to UTC).
            examples:
              - UTC
              - America/Los_Angeles
              - Europe/London
            default: UTC
            title: Tz
          description: >-
            IANA timezone identifier used to interpret start_date and end_date
            (defaults to UTC).
      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
        - updated_at
      title: IdentityIndividualSortField
      description: What the people list sorts by.
    SortMethod:
      type: string
      enum:
        - asc
        - desc
      title: SortMethod
    IndividualLinkFilter:
      type: string
      enum:
        - linked
        - link_request
        - none
      title: IndividualLinkFilter
      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 name on your organization's latest accepted record of the
            individual. Mask it in shared surfaces; the API returns what the
            organization itself submitted.
          title: Display Name
          type: string
        active_keys:
          $ref: '#/components/schemas/v1.RecordedActiveKeys'
          description: >-
            Each individual verification check the identity currently holds
            (e.g. `phone_possession`, `ssn_identity_match`), from the
            token-exchange profile's key vocabulary, with its `basis`
            (`verified` when Baselayer ran the check, `attested` when a customer
            vouched for it) and `time` (the UTC day, a NumericDate). A key an
            earlier verification proved stays held while the latest one carries
            the same values (the same phone for `phone_possession`).
        linked_business_count:
          description: >-
            Businesses this organization covers a live operator link to for the
            individual; rejected links are not counted. The rows are `GET
            /issuance/identities/operator_links?individual_ref=…&status=verified&status=under_review`.
          title: Linked Business Count
          type: integer
        last_activity_at:
          description: >-
            The latest of: a record of them accepted (a verification or a push),
            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_issued_30d:
          description: >-
            Credentials this organization issued for the individual in the last
            30 days, counting business credentials it acted for:
            `credential_counts.issued_30d` on the individual's read.
          title: Credentials Issued 30D
          type: integer
        reference_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Your `reference_id` for the individual, on the reference they are
            listed under; null when you never sent one.
          title: Reference Id
        created_at:
          description: When your organization first held a reference to the individual.
          format: date-time
          title: Created At
          type: string
        updated_at:
          description: >-
            When your organization's latest record of the individual was
            accepted: a verification or a push.
          format: date-time
          title: Updated At
          type: string
      required:
        - individual_ref
        - display_name
        - linked_business_count
        - last_activity_at
        - credentials_issued_30d
        - created_at
        - updated_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 person 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.RecordedActiveKeys:
      additionalProperties:
        $ref: '#/components/schemas/v1.KeyEvidence'
      description: >-
        A credential's keys as signed, on its record and in API answers: the

        record's credential type names the vocabulary, so the names stay
        strings.

        Read-only, like the model.
      maxProperties: 9
      title: RecordedActiveKeys
      type: object
    v1.KeyEvidence:
      additionalProperties: false
      description: >-
        One key's basis and the UTC day it was established.


        Direct construction, ``KeyEvidence(...)``, raises ``TypeError``. Build

        evidence through the named constructors ``from_proof``, ``from_record``

        and ``proven_at``. ``model_validate`` is for parsing stored JSON that
        one

        of them serialized, never for building new evidence. The day is ours,

        never a customer's own timestamp, so sites cannot correlate on a value a

        customer chose.
      properties:
        basis:
          $ref: '#/components/schemas/v1.KeyBasis'
        time:
          title: Time
          type: integer
      required:
        - basis
        - time
      title: KeyEvidence
      type: object
    v1.KeyBasis:
      description: >-
        Who established a key: Baselayer ran the check, or a customer vouched
        for it.
      enum:
        - verified
        - attested
      title: KeyBasis
      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.