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

# Search your account activity

> Search operations, ledger entries and your saved contacts within the authenticated account. Account records and data belonging to other accounts are never returned. Queries are trimmed, must contain 2–128 characters, and are limited to 60 requests per minute per account.



## OpenAPI

````yaml /openapi.yaml get /v1/me/search
openapi: 3.1.0
info:
  title: CBPay API
  version: '2.191'
  description: >
    CBPay is a multi-currency payment platform: fiat payouts and collections

    across Latin America, internal transfers, on-chain funding and

    withdrawals, and KYC screening. Every account holds independent

    virtual balances — USD (the principal currency), USDT, USDC, BTC, GOLD,
    SILVER and PLATINUM (grams of fine metal), plus BOB, MXN, ARS, CLP (local
    fiat; BOB/MXN/ARS use two decimals, CLP uses zero decimals) — convertible on
    demand with swaps.

    Payouts and service fees can be paid from any of the eleven balances

    (`PUT /v1/settlement` or per-payout `settlement_asset`), and payins

    can auto-convert to the asset of your choice (`default_payin_asset`).


    All amounts are decimal strings in each currency's precision (2 decimals

    for USD/BOB/MXN/ARS, 0 for CLP, 6 for USDT/USDC/GOLD/SILVER/PLATINUM, and 8
    for BTC). Errors always return

    `{"error": "<code>", "message": "<detail>"}`.
servers:
  - url: https://api.qbank.cl/platform
    description: Live (production, real money)
  - url: https://cryptobank.qbank.cl/platform
    description: Test (sandbox, simulated money — pk_test_ keys)
security:
  - bearerAuth: []
tags:
  - name: Support
    description: Support tickets and organization queue
  - name: Receipts
    description: >-
      Branded PDF receipt per operation, with a public signed-QR authenticity
      check, receipt_url on final-state responses/webhooks and automatic email
      delivery on final states. A pending payout before debit does not expose
      receipt_url.
  - name: Authentication
    description: Register and log in account members. Sessions last 24 hours.
  - name: Account
    description: Profile, members and API keys of the calling account.
  - name: Balances
    description: Balances, movement history and FX rates.
  - name: Payouts
    description: >-
      Fiat dispersals debited from the settlement balance of your choice (USD is
      the principal balance).
  - name: Payins
    description: >-
      Fiat top-ups (QR, transfers, dedicated accounts, pull collections, cards,
      checkout links) credited automatically — in USD, or auto-converted to the
      settlement asset of your choice.
  - name: Checkout
    description: >-
      Universal checkout links (`POST /v1/payins` with `method: "checkout"`) and
      the public payment-page endpoints — multi-country fiat, crypto with an
      ephemeral wallet per link and direct CBPay payment, settled in the asset
      of your choice.
  - name: Stored cards
    description: >-
      Cards saved with the payer's explicit consent during a 3-D Secure payment
      (COF). List, revoke and charge them on demand (MIT) without asking for the
      card again.
  - name: Subscriptions
    description: >-
      Recurring charges on a stored card managed by the platform scheduler —
      daily, weekly, monthly or yearly, with pause/resume/cancel and automatic
      dunning.
  - name: Transfers
    description: >-
      Free internal transfers between CBPay accounts (person or company, any
      combination).
  - name: Contacts
    description: >-
      Per-account address book of beneficiaries (CBPay, bank and crypto
      destinations) with phone matching and auto-save on every send.
  - name: Swaps
    description: >-
      Instant conversion between the account's USDT, USDC, BTC, GOLD, SILVER and
      PLATINUM balances at the account's quoted rate.
  - name: Crypto
    description: On-chain funding and withdrawals (TRON, Ethereum and Bitcoin).
  - name: Segregated wallets
    description: >-
      On-chain wallets with their own balance (companies unlimited; persons 1
      per network+asset pair) — create, import, send, export the private key and
      auto-forward. The balance lives on-chain, never in the ledger.
  - name: Signature proofs
    description: >-
      Cryptographic message signing with wallets (EIP-191 ETH/EVM, TIP-191 TRON)
      — create, list, get and revoke signature proofs with public verification.
  - name: Wallet links
    description: >-
      Link external wallets (custody=client) to your account by signing a nonce
      challenge — create challenges, verify signatures, list and revoke links.
  - name: QR Crypto POS
    description: >-
      Amount-bearing crypto QR charges for processors with physical POS
      terminals (company accounts): verified merchants, exclusive address + QR
      per charge, early payment detection, per-merchant reconciliation and
      refunds over the crypto withdrawal rail.
  - name: KYC / KYB
    description: >-
      Identity verification: KYC for persons, KYB for companies — your own
      onboarding and third-party verifications for company accounts.
  - name: AML screening
    description: >-
      Standalone AML screening of persons and companies against sanctions, PEP
      and adverse media lists, with rescreening, continuous monitoring and a
      downloadable PDF report.
  - name: Wallet screening
    description: >-
      AML risk assessment of blockchain addresses (sanctions, illicit-fund
      exposure) with a per-scan fee, plus free automatic protection on
      withdrawals and deposits.
  - name: Qscore
    description: >-
      API-first credit bureau. Issues complete credit reports with a 1-999 score
      (bands A-E, or SC when there is no data), reads the latest score of a
      subject and manages ARCO disputes. Chile first, with a country-agnostic
      design. Every issued report carries a public verification code.
  - name: Analytics
  - name: Webhooks
    description: Subscriptions to receive signed event notifications.
  - name: Status
    description: Service availability.
  - name: Banking
    description: >-
      Real bank accounts: receive, hold and send money over international
      banking rails.
  - name: Cards
    description: >-
      Virtual and physical cards that spend Just-In-Time from any of the seven
      spending assets (USD, USDT, USDC, BTC, GOLD, SILVER or PLATINUM), with
      per-card spending limits.
  - name: Security (OTP)
    description: >-
      One-time verification codes over SMS/WhatsApp/email protecting sensitive
      actions, plus self-service 2FA preferences. Applies to user sessions only
      — API keys are exempt.
  - name: Passkeys
    description: >-
      Passwordless sign-in with the device's biometrics (Face ID, Touch ID,
      Windows Hello, security keys) via WebAuthn, authenticator apps (TOTP) with
      backup codes, and session/device management.
  - name: Social login
    description: >-
      Passwordless sign up and sign in with Google, Apple, Microsoft and
      Facebook via token exchange. The front end obtains the provider
      credential; the API verifies it and issues the CBPay session.
  - name: Real-time events
    description: >-
      Server-Sent Events stream with everything that happens in the account (or
      across the organization for admins), replay with `Last-Event-ID`, optional
      initial snapshot and a 90-day queryable history.
  - name: Trust Center
    description: >-
      Public Trust Center metadata and tokenized NDA-gated compliance document
      access.
  - name: Contracts
    description: Pre-filled Grupo CB framework agreements for verified company accounts.
paths:
  /v1/me/search:
    get:
      tags:
        - Account
      summary: Search your account activity
      description: >-
        Search operations, ledger entries and your saved contacts within the
        authenticated account. Account records and data belonging to other
        accounts are never returned. Queries are trimmed, must contain 2–128
        characters, and are limited to 60 requests per minute per account.
      operationId: searchMyAccount
      parameters:
        - name: q
          in: query
          required: true
          description: >-
            Search text, exact operation ID, amount, email/name, partial
            reference, transaction hash or idempotency key. Amount queries match
            the exact numeric value stored: fiat `local_amount` is stored as a
            decimal, while USDT/USDC/BTC `NUMERIC(38,0)` columns use minor/base
            units.
          schema:
            type: string
            minLength: 2
            maxLength: 128
          examples:
            operation_id:
              value: 8f1e2d3c-4b5a-4f6e-8d9c-0a1b2c3d4e5f
            amount:
              value: 1.234,56
            contact:
              value: ana@example.com
            reference:
              value: CB7K2M
            transaction_hash:
              value: >-
                0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
      responses:
        '200':
          description: Matching records in the authenticated account.
          content:
            application/json:
              schema:
                type: object
                required:
                  - query
                  - matches
                properties:
                  query:
                    type: string
                  matches:
                    type: array
                    items:
                      type: object
                      required:
                        - type
                        - matched_by
                        - id
                        - created_at
                      properties:
                        type:
                          type: string
                          enum:
                            - payout
                            - payin
                            - transfer
                            - crypto_withdrawal
                            - swap
                            - payin_refund
                            - ledger_entry
                            - contact
                            - banking_operation
                            - risk_report
                            - risk_fraud_report
                        matched_by:
                          type: string
                          enum:
                            - id
                            - reference
                            - tx_hash
                            - idempotency_key
                            - doc_id
                            - provider_ref
                            - reference_partial
                            - amount
                            - name
                            - email
                            - phone
                            - tax_id
                            - alias
                            - payer
                            - beneficiary
                            - counterparty
                            - address
                            - description
                        id:
                          type: string
                        account_id:
                          type: string
                        status:
                          type: string
                        created_at:
                          type: string
                          format: date-time
                        detail:
                          type: object
                          additionalProperties: true
                        matched_value:
                          type: string
              example:
                query: ana
                matches:
                  - type: transfer
                    matched_by: id
                    id: 8f1e2d3c-4b5a-4f6e-8d9c-0a1b2c3d4e5f
                    account_id: acct_01
                    status: completed
                    created_at: '2026-10-25T18:10:00Z'
                    detail:
                      to_account_id: acct_02
                      asset: USDT
                  - type: payout
                    matched_by: amount
                    id: payout_01
                    account_id: acct_01
                    status: pending
                    created_at: '2026-10-25T18:11:00Z'
                    detail:
                      amount: '1234.56'
                      currency: USD
                    matched_value: '1234.56'
                  - type: contact
                    matched_by: email
                    id: contact_01
                    account_id: acct_01
                    created_at: '2026-10-25T18:12:00Z'
                    detail:
                      display_name: Ana Pérez
                      phone_or_email: ana@example.com
                    matched_value: ana@example.com
                  - type: payin
                    matched_by: reference_partial
                    id: payin_01
                    account_id: acct_01
                    status: completed
                    created_at: '2026-10-25T18:13:00Z'
                    detail:
                      country: CL
                      method: bank_transfer
                    matched_value: CB7K2M
                  - type: crypto_withdrawal
                    matched_by: tx_hash
                    id: withdrawal_01
                    account_id: acct_01
                    status: completed
                    created_at: '2026-10-25T18:14:00Z'
                    detail:
                      chain: ethereum
                      asset: USDT
                    matched_value: >-
                      0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
        '400':
          description: Invalid query length.
          content:
            application/json:
              examples:
                too_short:
                  value:
                    error: query_too_short
                    message: q must be at least 2 characters
                too_long:
                  value:
                    error: query_too_long
                    message: q must be at most 128 characters
        '403':
          description: An account credential is required.
          content:
            application/json:
              example:
                error: account_required
                message: this endpoint requires an account credential
        '429':
          description: Search rate limit exceeded.
          content:
            application/json:
              example:
                error: too_many_attempts
                message: too many requests; wait a moment and retry
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |
        Session JWT (from register/login) or API key (`pk_...`).
        `X-API-Key: <token>` is accepted as an alternative header.

````

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