> ## 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 counterparties ## OpenAPI ````yaml /openapi.json get /v1/counterparties/ 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__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/counterparties/: get: tags: - counterparties summary: List counterparties parameters: - schema: type: integer minimum: 1 maximum: 100 default: 25 in: query name: limit required: false - schema: type: string in: query name: cursor required: false 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 fullName: type: string type: type: string country: type: string tradeName: type: string nullable: true legalForm: type: string nullable: true registrationNumber: type: string nullable: true taxId: type: string nullable: true address: type: string nullable: true contactName: type: string nullable: true contactRole: type: string nullable: true contactPhone: type: string nullable: true bankName: type: string nullable: true msisdn: type: string nullable: true email: type: string nullable: true iban: type: string nullable: true swiftBic: type: string nullable: true bankAccount: type: string nullable: true walletAddress: type: string nullable: true walletChain: 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 documents: type: array items: type: object properties: kind: type: string filename: type: string storageKey: type: string required: - kind - filename - storageKey additionalProperties: false nullable: true methodDetails: type: object additionalProperties: type: string nullable: true isVerified: type: boolean isBlacklisted: type: boolean approvalStatus: type: string enum: - PENDING - APPROVED - REJECTED approvedAt: type: string nullable: true rejectionReason: type: string nullable: true docsRequiredAt: type: string nullable: true accounts: type: array items: type: object properties: id: type: string kind: type: string enum: - BANK - MOMO - CRYPTO currency: type: string enum: - XOF - XAF - NGN - GHS - CDF - EUR - USD - USDC - USDT label: type: string nullable: true bankName: type: string nullable: true bankAddress: type: string nullable: true bankCountry: type: string nullable: true accountHolder: type: string nullable: true iban: type: string nullable: true bankAccount: type: string nullable: true swiftBic: type: string nullable: true network: 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 msisdn: type: string nullable: true momoCountry: type: string nullable: true momoHolderName: type: string nullable: true momoHolderId: type: string nullable: true walletChain: 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 walletAddress: type: string nullable: true cryptoAsset: type: string nullable: true createdAt: type: string required: - id - kind - currency - label - bankName - bankAddress - bankCountry - accountHolder - iban - bankAccount - swiftBic - network - msisdn - momoCountry - momoHolderName - momoHolderId - walletChain - walletAddress - cryptoAsset - createdAt additionalProperties: false default: [] createdAt: type: string required: - id - fullName - type - country - tradeName - legalForm - registrationNumber - taxId - address - contactName - contactRole - contactPhone - bankName - msisdn - email - iban - swiftBic - bankAccount - walletAddress - walletChain - documents - methodDetails - isVerified - isBlacklisted - approvalStatus - approvedAt - rejectionReason - docsRequiredAt - createdAt additionalProperties: false nextCursor: type: string nullable: true required: - items - nextCursor 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__xxx` cookieAuth: type: apiKey in: cookie name: kp_token description: Session signée (front Next.js) ````