> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizconnectpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister les porteurs de carte

> Parcourez les porteurs de carte créés par l'application.

```bash cURL theme={null}
curl --request GET \
  --url 'https://api.bizconnectpay.com/api/v1/cardholders?per_page=25' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <access_token>'
```

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "current_page": 1,
    "data": [
      {
        "id": "f1bdad5d-bb31-410d-869c-44a28e876ded",
        "provider_reference": "BCP-CUS-67804B24CF5D3",
        "environment": "LIVE",
        "created_at": "2026-10-20T14:00:00.000000Z"
      }
    ],
    "per_page": 25,
    "total": 1
  },
  "meta": {
    "correlation_id": "28baf1e7-bdbf-409a-a330-da4641f877ba"
  }
}
```


## OpenAPI

````yaml openapi.json GET /cardholders
openapi: 3.1.0
info:
  title: BizConnectPay API
  version: 1.0.0
  description: >-
    API serveur-à-serveur pour les collectes, décaissements, transactions,
    remboursements, liens de paiement et cartes virtuelles.
servers:
  - url: https://api.bizconnectpay.com/api/v1
    description: Passerelle API BizConnectPay
security:
  - bearerAuth: []
tags:
  - name: Authentification
  - name: Services
  - name: Collectes
  - name: Transactions
  - name: Décaissements
  - name: Remboursements
  - name: Liens de paiement
  - name: Porteurs de carte
  - name: Cartes virtuelles
paths:
  /cardholders:
    get:
      tags:
        - Porteurs de carte
      summary: Lister les porteurs de carte
      operationId: listVirtualCardUsers
      parameters:
        - $ref: '#/components/parameters/PerPage'
      responses:
        '200':
          $ref: '#/components/responses/Success'
components:
  parameters:
    PerPage:
      name: per_page
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
  responses:
    Success:
      description: Requête traitée
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SuccessEnvelope'
  schemas:
    SuccessEnvelope:
      type: object
      properties:
        success:
          type: boolean
          const: true
        data: {}
        meta:
          $ref: '#/components/schemas/Meta'
    Meta:
      type: object
      properties:
        correlation_id:
          type:
            - string
            - 'null'
          format: uuid
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.