Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Bitpagos API
version: '2026-09-28'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-09-28: 16 operation(s) read from 14 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Bitpagos has published no machine-readable contract that the pipeline could find. Engine: local.'
x-evidence-tiers:
code-example: 5
documentation: 11
pages-with-code: 4
pages-read: 14
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-09-28'
x-generator: generate-contract-from-docs.py
x-engine: local
x-sources:
- https://apidocs.ripio.com/static/api/overview
- https://docs.ripio.com/ramps-api/kyc/start-kyc.md
- https://docs.ripio.com/ramps-api/kyc/reusable-kyc.md
- https://docs.ripio.com/ramps-api/refunds/overview.md
- https://docs.ripio.com/ramps-api/kyc/kyc-with-ripio.md
- https://docs.ripio.com/ramps-api/kyc/resend-kyc-otp.md
- https://docs.ripio.com/ramps-api/quotes/create-quote.md
- https://docs.ripio.com/ramps-api/kyc/validate-kyc-otp.md
- https://docs.ripio.com/ramps-api/rates/get-market-rates.md
- https://docs.ripio.com/ramps-api/refunds/refund-deposit.md
- https://docs.ripio.com/ramps-api/sandbox/kyc-in-sandbox.md
- https://docs.ripio.com/ramps-api/fiat-accounts/list-banks.md
- https://docs.ripio.com/ramps-api/customers/create-customer.md
- https://docs.ripio.com/ramps-api/customers/update-customer.md
servers:
- url: https://skala-sandbox.ripio.com
security:
- bearer: []
tags:
- name: Bitpagos API
paths:
/api/v1/{v1id}:
get:
operationId: get_api_v1_v1id
tags:
- Bitpagos API
summary: List Bank Codes
description: 'Retrieves a list of available bank codes for creating fiat accounts via bank transfer in Colombia. Each bank includes its code (used as `beneficiary_institution` when creating a fiat account) and the allowed `counterparty_type` values.
**Country availability:** This endpoint is only available for accounts operating in Colombia (CO). Requests from accounts in other countries will return a 400 error.'
x-source: https://docs.ripio.com/ramps-api/fiat-accounts/list-banks.md
parameters:
- name: v1id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
content:
application/json:
schema:
$ref: '#/components/schemas/GetApiV1V1IdResponse'
x-evidence:
kind: documentation
collapsed_from: 2 example path(s) differing only at v1Id
components:
schemas:
GetApiV1V1IdResponse:
type: object
properties:
'200':
type: string
description: A list of available bank codes.
'400':
type: string
description: Bad Request - Account country is not supported.
'401':
type: string
description: Unauthorized - Invalid or missing access token.
securitySchemes:
bearer:
type: http
scheme: bearer