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

# List payouts for this integration



## OpenAPI

````yaml /openapi.yaml get /api/integrations/breb/payouts
openapi: 3.1.0
info:
  title: COP By Integrations API
  version: 0.1.0
  description: |
    Non-custodial Celo API for partners. Prepare swaps and BRE-B COP payouts;
    the user signs from their wallet. Confirm with the transaction hash.
servers:
  - url: http://localhost:3000
    description: Local Next.js app
  - url: https://app.copby.co
    description: Production (replace if your origin differs)
security:
  - bearerAuth: []
tags:
  - name: BRE-B
    description: Quote, KYC, and COP payouts via Bridge Bre-B
  - name: Swaps
    description: Prepare and confirm onchain COPm swaps
  - name: Webhooks
    description: Bridge callbacks. Not authenticated with a partner key.
paths:
  /api/integrations/breb/payouts:
    get:
      tags:
        - BRE-B
      summary: List payouts for this integration
      operationId: listBrebPayouts
      parameters:
        - name: since
          in: query
          schema:
            type: string
            format: date-time
          description: Inclusive ISO timestamp filter on `createdAt`
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 100
      responses:
        '200':
          description: Payouts owned by the API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  integrationId:
                    type: string
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Payout'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    Payout:
      type: object
      properties:
        payoutId:
          type: string
        status:
          type: string
        fromToken:
          type: string
        sourceAmount:
          type: string
        fees:
          type: array
          items:
            $ref: '#/components/schemas/FeeLeg'
        quote:
          type: object
          properties:
            display:
              type:
                - string
                - 'null'
            effectiveUsdCop:
              type:
                - string
                - 'null'
        receipt:
          $ref: '#/components/schemas/PayoutReceipt'
        deposit:
          type: object
          properties:
            chain:
              type: string
            currency:
              type: string
            address:
              type: string
            amount:
              type: string
        transaction:
          $ref: '#/components/schemas/PreparedTx'
        feeTransaction:
          $ref: '#/components/schemas/PreparedTx'
        destinationPreview:
          type: object
          properties:
            accountOwnerName:
              type: string
            bankName:
              type:
                - string
                - 'null'
            documentLast4:
              type:
                - string
                - 'null'
    FeeLeg:
      type: object
      properties:
        code:
          type: string
          enum:
            - swap
            - bridge_fx
            - bridge
            - copby
        amountUsd:
          type: string
        to:
          type:
            - string
            - 'null'
        status:
          type: string
          enum:
            - quoted
            - verified
            - pending
    PayoutReceipt:
      type: object
      description: >
        Consumer receipt (REQ-INT-RCPT-01). Fees are included in
        `exchangeRate.effectiveUsdCop`.

        Use `feesItemized` only for partner backoffice / disputes.
      properties:
        title:
          type: string
          example: Retiro Bre-B
        status:
          type: string
        completedAt:
          type:
            - string
            - 'null'
        transactionType:
          type: string
          enum:
            - withdrawal
        payoutId:
          type: string
        breBKey:
          type:
            - string
            - 'null'
          description: Masked key (last4), e.g. ···3143
        breBKeyLast4:
          type:
            - string
            - 'null'
        beneficiaryName:
          type:
            - string
            - 'null'
        totalPaid:
          type: object
          properties:
            amount:
              type: string
            currency:
              type: string
              enum:
                - USD
        exchangeRate:
          type: object
          properties:
            display:
              type:
                - string
                - 'null'
              example: 1 USD = 3000 COP
            effectiveUsdCop:
              type:
                - string
                - 'null'
            sellRateUsdCop:
              type:
                - string
                - 'null'
              description: Wholesale Bridge rate (ops); hide on consumer UI
        commission:
          type: object
          properties:
            mode:
              type: string
              enum:
                - included_in_rate
            displayAmount:
              type: string
              example: '0'
            displayCurrency:
              type: string
              enum:
                - COP
                - USD
            note:
              type: string
        totalReceived:
          type: object
          properties:
            amount:
              type: string
            currency:
              type: string
              enum:
                - COP
        feesItemized:
          type: array
          items:
            $ref: '#/components/schemas/FeeLeg'
    PreparedTx:
      type: object
      properties:
        approvalTarget:
          type:
            - string
            - 'null'
        to:
          type: string
        data:
          type: string
        value:
          type: string
          example: '0'
  responses:
    Unauthorized:
      description: Missing or invalid integration API key
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Integration API key. Send as `Bearer copby_live_pk_…`.

````