Cobre

Cobre Platform API

Cobre's REST API (v1) for local and cross-border money movements, accounts and balances, counterparties, Bre-B keys, FX quotes, stablecoin payouts, reports/reconciliation and webhook subscriptions.

GitHub

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/authentication/cobre-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/rate-limits/cobre-rate-limits.yml

Specifications

⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/asyncapi/cobre-events-asyncapi.yml

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/conventions/cobre-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/conventions/cobre-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/errors/cobre-problem-types.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/asyncapi/cobre-events-webhooks.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/data-model/cobre-data-model.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/sandbox/cobre-sandbox.yml
🔗
APIsJSON
https://raw.githubusercontent.com/api-evangelist/cobre/refs/heads/main/apis.yml

AsyncAPI Specification

cobre-events-asyncapi.yml Raw ↑ 
# generated: '2026-07-18'
# method: generated
# source: https://docs.cobre.com/notifications-subscriptions-1886572m0
asyncapi: 2.6.0
info:
  title: Cobre Notifications & Subscriptions
  version: 1.0.0
  description: 'AsyncAPI generated by the API Evangelist enrichment pipeline from Cobre''s published webhook
    event catalog (Notifications & Subscriptions). Cobre delivers signed HTTP POST webhooks to a subscriber
    URL registered via POST /v1/subscriptions. Signature: HMAC-SHA256 over event-timestamp + "." + raw_body,
    verified against the event-signature header.'
  x-generated-from: https://docs.cobre.com/notifications-subscriptions-1886572m0
  x-method: generated
defaultContentType: application/json
channels:
  accounts.balance.credit:
    description: Webhook delivered when the "accounts.balance.credit" event occurs.
    subscribe:
      operationId: on_accounts_balance_credit
      summary: Receive accounts.balance.credit notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  accounts.balance.debit:
    description: Webhook delivered when the "accounts.balance.debit" event occurs.
    subscribe:
      operationId: on_accounts_balance_debit
      summary: Receive accounts.balance.debit notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  accounts.linked_wallets.created:
    description: Webhook delivered when the "accounts.linked_wallets.created" event occurs.
    subscribe:
      operationId: on_accounts_linked_wallets_created
      summary: Receive accounts.linked_wallets.created notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cobre_keys.status.processing:
    description: Webhook delivered when the "cobre_keys.status.processing" event occurs.
    subscribe:
      operationId: on_cobre_keys_status_processing
      summary: Receive cobre_keys.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cobre_keys.status.registered:
    description: Webhook delivered when the "cobre_keys.status.registered" event occurs.
    subscribe:
      operationId: on_cobre_keys_status_registered
      summary: Receive cobre_keys.status.registered notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cobre_keys.status.unregistered:
    description: Webhook delivered when the "cobre_keys.status.unregistered" event occurs.
    subscribe:
      operationId: on_cobre_keys_status_unregistered
      summary: Receive cobre_keys.status.unregistered notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cobre_keys.status.disabled:
    description: Webhook delivered when the "cobre_keys.status.disabled" event occurs.
    subscribe:
      operationId: on_cobre_keys_status_disabled
      summary: Receive cobre_keys.status.disabled notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cobre_keys.status.failed:
    description: Webhook delivered when the "cobre_keys.status.failed" event occurs.
    subscribe:
      operationId: on_cobre_keys_status_failed
      summary: Receive cobre_keys.status.failed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  counterparty.status.processing:
    description: Webhook delivered when the "counterparty.status.processing" event occurs.
    subscribe:
      operationId: on_counterparty_status_processing
      summary: Receive counterparty.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  counterparty.status.verified:
    description: Webhook delivered when the "counterparty.status.verified" event occurs.
    subscribe:
      operationId: on_counterparty_status_verified
      summary: Receive counterparty.status.verified notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  counterparty.status.failed:
    description: Webhook delivered when the "counterparty.status.failed" event occurs.
    subscribe:
      operationId: on_counterparty_status_failed
      summary: Receive counterparty.status.failed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.initiated:
    description: Webhook delivered when the "money_movements.status.initiated" event occurs.
    subscribe:
      operationId: on_money_movements_status_initiated
      summary: Receive money_movements.status.initiated notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.processing:
    description: Webhook delivered when the "money_movements.status.processing" event occurs.
    subscribe:
      operationId: on_money_movements_status_processing
      summary: Receive money_movements.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.pending_approval:
    description: Webhook delivered when the "money_movements.status.pending_approval" event occurs.
    subscribe:
      operationId: on_money_movements_status_pending_approval
      summary: Receive money_movements.status.pending_approval notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.completed:
    description: Webhook delivered when the "money_movements.status.completed" event occurs.
    subscribe:
      operationId: on_money_movements_status_completed
      summary: Receive money_movements.status.completed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.canceled:
    description: Webhook delivered when the "money_movements.status.canceled" event occurs.
    subscribe:
      operationId: on_money_movements_status_canceled
      summary: Receive money_movements.status.canceled notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.returned:
    description: Webhook delivered when the "money_movements.status.returned" event occurs.
    subscribe:
      operationId: on_money_movements_status_returned
      summary: Receive money_movements.status.returned notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.rejected:
    description: Webhook delivered when the "money_movements.status.rejected" event occurs.
    subscribe:
      operationId: on_money_movements_status_rejected
      summary: Receive money_movements.status.rejected notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  money_movements.status.failed:
    description: Webhook delivered when the "money_movements.status.failed" event occurs.
    subscribe:
      operationId: on_money_movements_status_failed
      summary: Receive money_movements.status.failed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.validating:
    description: Webhook delivered when the "bulk_money_movements.status.validating" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_validating
      summary: Receive bulk_money_movements.status.validating notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.processing:
    description: Webhook delivered when the "bulk_money_movements.status.processing" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_processing
      summary: Receive bulk_money_movements.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.pending_approval:
    description: Webhook delivered when the "bulk_money_movements.status.pending_approval" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_pending_approval
      summary: Receive bulk_money_movements.status.pending_approval notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.completed:
    description: Webhook delivered when the "bulk_money_movements.status.completed" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_completed
      summary: Receive bulk_money_movements.status.completed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.canceled:
    description: Webhook delivered when the "bulk_money_movements.status.canceled" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_canceled
      summary: Receive bulk_money_movements.status.canceled notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  bulk_money_movements.status.failed:
    description: Webhook delivered when the "bulk_money_movements.status.failed" event occurs.
    subscribe:
      operationId: on_bulk_money_movements_status_failed
      summary: Receive bulk_money_movements.status.failed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cross_border_money_movements.status.initiated:
    description: Webhook delivered when the "cross_border_money_movements.status.initiated" event occurs.
    subscribe:
      operationId: on_cross_border_money_movements_status_initiated
      summary: Receive cross_border_money_movements.status.initiated notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cross_border_money_movements.status.processing:
    description: Webhook delivered when the "cross_border_money_movements.status.processing" event occurs.
    subscribe:
      operationId: on_cross_border_money_movements_status_processing
      summary: Receive cross_border_money_movements.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cross_border_money_movements.status.completed:
    description: Webhook delivered when the "cross_border_money_movements.status.completed" event occurs.
    subscribe:
      operationId: on_cross_border_money_movements_status_completed
      summary: Receive cross_border_money_movements.status.completed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  cross_border_money_movements.status.rejected:
    description: Webhook delivered when the "cross_border_money_movements.status.rejected" event occurs.
    subscribe:
      operationId: on_cross_border_money_movements_status_rejected
      summary: Receive cross_border_money_movements.status.rejected notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  evidence-request.ask:
    description: Webhook delivered when the "evidence-request.ask" event occurs.
    subscribe:
      operationId: on_evidence_request_ask
      summary: Receive evidence-request.ask notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  alerts.fx_rate.triggered:
    description: Webhook delivered when the "alerts.fx_rate.triggered" event occurs.
    subscribe:
      operationId: on_alerts_fx_rate_triggered
      summary: Receive alerts.fx_rate.triggered notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  reports.created:
    description: Webhook delivered when the "reports.created" event occurs.
    subscribe:
      operationId: on_reports_created
      summary: Receive reports.created notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  transfer_acc.status.enabled:
    description: Webhook delivered when the "transfer_acc.status.enabled" event occurs.
    subscribe:
      operationId: on_transfer_acc_status_enabled
      summary: Receive transfer_acc.status.enabled notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  transfer_acc.status.processing:
    description: Webhook delivered when the "transfer_acc.status.processing" event occurs.
    subscribe:
      operationId: on_transfer_acc_status_processing
      summary: Receive transfer_acc.status.processing notifications
      message:
        $ref: '#/components/messages/CobreEvent'
  transfer_acc.status.failed:
    description: Webhook delivered when the "transfer_acc.status.failed" event occurs.
    subscribe:
      operationId: on_transfer_acc_status_failed
      summary: Receive transfer_acc.status.failed notifications
      message:
        $ref: '#/components/messages/CobreEvent'
components:
  messages:
    CobreEvent:
      name: CobreEvent
      title: Cobre event notification
      contentType: application/json
      headers:
        type: object
        properties:
          event-timestamp:
            type: string
            description: UTC event creation time
          event-signature:
            type: string
            description: HMAC-SHA256 signature of event-timestamp + "." + raw_body
      payload:
        $ref: '#/components/schemas/EventEnvelope'
  schemas:
    EventEnvelope:
      type: object
      properties:
        id:
          type: string
          example: ev_xxxxx
        event_key:
          type: string
          example: accounts.balance.credit
          enum:
          - accounts.balance.credit
          - accounts.balance.debit
          - accounts.linked_wallets.created
          - cobre_keys.status.processing
          - cobre_keys.status.registered
          - cobre_keys.status.unregistered
          - cobre_keys.status.disabled
          - cobre_keys.status.failed
          - counterparty.status.processing
          - counterparty.status.verified
          - counterparty.status.failed
          - money_movements.status.initiated
          - money_movements.status.processing
          - money_movements.status.pending_approval
          - money_movements.status.completed
          - money_movements.status.canceled
          - money_movements.status.returned
          - money_movements.status.rejected
          - money_movements.status.failed
          - bulk_money_movements.status.validating
          - bulk_money_movements.status.processing
          - bulk_money_movements.status.pending_approval
          - bulk_money_movements.status.completed
          - bulk_money_movements.status.canceled
          - bulk_money_movements.status.failed
          - cross_border_money_movements.status.initiated
          - cross_border_money_movements.status.processing
          - cross_border_money_movements.status.completed
          - cross_border_money_movements.status.rejected
          - evidence-request.ask
          - alerts.fx_rate.triggered
          - reports.created
          - transfer_acc.status.enabled
          - transfer_acc.status.processing
          - transfer_acc.status.failed
        created_at:
          type: string
          format: date-time
        content:
          type: object
          description: Event-specific payload
      required:
      - id
      - event_key
      - created_at
      - content