> ## Documentation Index
> Fetch the complete documentation index at: https://next-developers.opencard.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List card holders

> Paginated list. Each item includes `identity` (`name`, `employee_id`) when linked — no separate identities call needed for display.



## OpenAPI

````yaml /openapi/ems-api.json get /accounts/{accountId}/organizations/{organizationId}/cardholders
openapi: 3.0.3
info:
  title: OpenCard EMS API
  version: '1.0'
  description: >-
    API for Expense Management Systems. Manage TPAs, organizations, card
    holders, and webhooks. Receive transaction data via webhooks — not by
    polling this API.
  contact:
    email: support@opencard.io
servers:
  - url: https://api.opencard.io/api/v1/application
    description: Production
  - url: https://sandbox-api.opencard.io/api/v1/application
    description: Sandbox
security: []
paths:
  /accounts/{accountId}/organizations/{organizationId}/cardholders:
    get:
      tags:
        - Card Holders
      summary: List card holders
      description: >-
        Paginated list. Each item includes `identity` (`name`, `employee_id`)
        when linked — no separate identities call needed for display.
      operationId: listCardHolders
      parameters:
        - $ref: '#/components/parameters/accountId'
        - $ref: '#/components/parameters/organizationId'
      responses:
        '200':
          description: Card holders
          content:
            application/json:
              schema:
                type: object
                properties:
                  current_page:
                    type: integer
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CardHolder'
                  per_page:
                    type: integer
                  total:
                    type: integer
                  last_page:
                    type: integer
              example:
                current_page: 1
                data:
                  - id: 15
                    reference_id: employee_john_42
                    organization_id: 3
                    identity_id: 123
                    email: john@acme.se
                    created_at: '2026-06-08T10:00:00.000000Z'
                    updated_at: '2026-06-08T10:30:00.000000Z'
                    meta:
                      ssn: true
                      signed: true
                      signed_at: '2026-06-08T10:30:00.000000Z'
                      email_status: delivered
                      pdpc_url: >-
                        https://sandbox-api.opencard.io/accounts/1/pdpcs/8/sign/abc...
                      system: Acme EMS
                      organization_number: '5561234567'
                    identity:
                      name: Anna Andersson
                      employee_id: '001'
                per_page: 15
                total: 1
                last_page: 1
      security:
        - opencard_auth:
            - card-holders-read
components:
  parameters:
    accountId:
      name: accountId
      in: path
      required: true
      description: Your account ID
      schema:
        type: integer
    organizationId:
      name: organizationId
      in: path
      required: true
      description: Organization ID
      schema:
        type: integer
  schemas:
    CardHolder:
      type: object
      properties:
        id:
          type: integer
        reference_id:
          type: string
        organization_id:
          type: integer
        identity_id:
          type: integer
          nullable: true
        email:
          type: string
          nullable: true
          format: email
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        meta:
          type: object
          properties:
            ssn:
              type: boolean
            signed:
              type: boolean
            signed_at:
              type: string
              format: date-time
              nullable: true
            email_status:
              type: string
              nullable: true
              enum:
                - delivered
                - failed
            pdpc_url:
              type: string
              nullable: true
            system:
              type: string
              nullable: true
            organization_number:
              type: string
              nullable: true
        identity:
          $ref: '#/components/schemas/CardHolderIdentity'
    CardHolderIdentity:
      type: object
      nullable: true
      description: >-
        Linked identity summary on list responses. Only `name` and `employee_id`
        — nothing else.
      properties:
        name:
          type: string
          nullable: true
          description: Person name from eID
        employee_id:
          type: string
          nullable: true
          description: Employee ID on the TPA client
  securitySchemes:
    opencard_auth:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.opencard.io/oauth/token
          scopes:
            accounts-read: Read your account
            accounts-write: Update your account
            oauth-clients-read: Read OAuth clients
            oauth-clients-write: Create OAuth clients
            public-records-read: Company registry lookup
            account-tpas-read: Read TPAs
            account-tpas-write: Create TPAs
            account-tpas-delete: Delete TPAs
            account-tpa-signatories-read: Read TPA signatories
            account-tpa-signatories-write: Add TPA signatories
            account-tpa-identities-read: List identities on TPA
            billings-write: Create billing profiles
            card-issuers-read: List available card programs (catalog)
            account-card-issuers-read: List enabled issuers
            account-card-issuers-write: Enable issuers
            account-card-issuers-delete: Disable issuers
            organizations-read: Read organizations
            organizations-write: Create organizations
            card-holders-read: Read card holders
            card-holders-write: Create and update card holders
            card-holders-delete: Delete card holders
            webhooks-read: Read webhooks
            webhooks-write: Create webhooks
            webhook-events-read: Read webhook delivery log
            receipts-write: Scan receipts (OCR)

````