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

# List wallets for the current org



## OpenAPI

````yaml /openapi.json get /v1/wallets/
openapi: 3.1.0
info:
  title: KryptaPay API
  description: >-
    API B2B de paiements numériques pour l'Afrique francophone.


    ## Authentification

    Deux méthodes sont supportées :

    - **Session utilisateur** : JWT signé dans un cookie `kp_token` (HttpOnly,
    SameSite=Lax) — utilisé par le tableau de bord.

    - **Clé API** : header `Authorization: Bearer kp_<env>_xxx` — utilisé par
    les intégrations serveur.


    Les endpoints sensibles exigent l'une ou l'autre. Les écritures monétaires
    acceptent un header `Idempotency-Key` pour la dé-duplication.


    ## Enveloppe de réponse

    Toutes les réponses suivent le format `{ ok: boolean, data?: T, error?: {
    code, message, details? } }`.


    ## Webhooks sortants

    Signature HMAC SHA-256 dans le header `X-KryptaPay-Signature`. Le secret est
    défini à la création de l'endpoint.
  version: 1.0.0
  contact:
    name: KryptaPay Support
    email: support@kryptapay.test
    url: https://kryptapay.test
  license:
    name: Proprietary
servers:
  - url: http://localhost
    description: Local dev
security:
  - bearerAuth: []
  - cookieAuth: []
tags:
  - name: wallets
    description: Portefeuilles fiat / stablecoin / IBAN virtuels
  - name: transactions
    description: Historique unifié des mouvements
  - name: payouts
    description: Versements Mobile Money / banque / stablecoin
  - name: payins
    description: Encaissements et liens de paiement
  - name: fx
    description: Cotations et conversions multi-devises
  - name: counterparties
    description: Bénéficiaires et tiers
  - name: invoices
    description: Factures + paiement public + reçus
  - name: status
    description: Statut public des services
paths:
  /v1/wallets/:
    get:
      tags:
        - wallets
      summary: List wallets for the current org
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - true
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            kind:
                              type: string
                              enum:
                                - FIAT
                                - STABLECOIN
                                - VIRTUAL_IBAN
                                - VIRTUAL_ACH
                            currency:
                              type: string
                              enum:
                                - XOF
                                - XAF
                                - NGN
                                - GHS
                                - CDF
                                - EUR
                                - USD
                                - USDC
                                - USDT
                            label:
                              type: string
                              nullable: true
                            balance:
                              type: string
                              pattern: ^\d+(\.\d{1,8})?$
                              description: >-
                                Decimal amount with up to 8 fractional digits,
                                e.g. "1500" or "1500.75"
                            reserved:
                              type: string
                              pattern: ^\d+(\.\d{1,8})?$
                              description: >-
                                Decimal amount with up to 8 fractional digits,
                                e.g. "1500" or "1500.75"
                            available:
                              type: string
                              pattern: ^\d+(\.\d{1,8})?$
                              description: >-
                                Decimal amount with up to 8 fractional digits,
                                e.g. "1500" or "1500.75"
                            chain:
                              type: string
                              enum:
                                - MTN_BJ
                                - MTN_CI
                                - MTN_CM
                                - ORANGE_CI
                                - ORANGE_SN
                                - ORANGE_ML
                                - ORANGE_BF
                                - ORANGE_CM
                                - MOOV_BJ
                                - MOOV_TG
                                - MOOV_CI
                                - MOOV_BF
                                - WAVE_CI
                                - WAVE_SN
                                - FREE_SN
                                - TMONEY_TG
                                - MOBICASH_ML
                                - MOBICASH_BF
                                - DJAMO_CI
                                - MIXX_SN
                                - MTN_CG
                                - AIRTEL_CG
                                - ORANGE_CD
                                - AIRTEL_CD
                                - VODACOM_CD
                                - AFRICELL_CD
                                - AIRTEL_GA
                                - MOMO_NG
                                - AIRTEL_NG
                                - MTN_GH
                                - VODAFONE_GH
                                - AIRTELTIGO_GH
                                - BANK_XOF
                                - BANK_XAF
                                - BANK_NGN
                                - BANK_GHS
                                - BANK_CDF
                                - BANK_EUR
                                - BANK_USD
                                - ETH
                                - POLYGON
                                - TRON
                              nullable: true
                            address:
                              type: string
                              nullable: true
                          required:
                            - id
                            - kind
                            - currency
                            - label
                            - balance
                            - reserved
                            - available
                            - chain
                            - address
                          additionalProperties: false
                    required:
                      - items
                    additionalProperties: false
                required:
                  - ok
                  - data
                additionalProperties: false
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
                description: Authentication required
        '403':
          description: Forbidden — no org / role / KYB
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
                description: Forbidden — no org / role / KYB
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT utilisateur ou clé API `kp_<env>_xxx`
    cookieAuth:
      type: apiKey
      in: cookie
      name: kp_token
      description: Session signée (front Next.js)

````