Explore the APIs with Postman

Use Cobre's official Postman Collections to explore and test the API end to end — from authentication to moving money across our local and cross-border rails — without writing any code first.

The collections live in a public Postman workspace. Import them, plug in your credentials, and send your first request in a couple of minutes.

🔗 Open the Cobre API workspace in Postman

What's included

A General (Getting Started) collection with the building blocks shared across every product — Authentication, Cobre Balance, Counterparties, Webhooks, and Reports — plus one collection per product:

Collection	What it covers
General (Getting Started)	Authentication, Cobre Balance, Counterparties, Webhooks, Reports. Start here.
PayIn — Colombia	Collect payments in Colombia (Nequi, PSE, R2P, Checkout, Direct Debit).
PayIn — Mexico	Collect payments in Mexico (SPEI in, refunds).
PayIn — Global	Collect international payments into your Cobre balances.
PayOut — Colombia	Send payouts in Colombia (ACH / Fast Pay, Bre-B).
PayOut — Mexico	Send payouts in Mexico (SPEI out).
PayOut — Global	Send payouts to international counterparties.
Cross-Border (USD/COP)	FX quotes and cross-border money movements.

Authentication is shared across collections: you authenticate once and every request reuses the token.

Prerequisites

Requirement	Why
A Cobre account with API credentials (`client_id` and `secret`)	Needed to authenticate. Ask your Key Account Manager if you don't have them.
Postman (desktop app or web)	To import and run the collections.

1. Open the workspace

Open the Cobre API workspace in Postman and fork the collections into your own workspace. Forking keeps your copy in sync with future updates from Cobre.

2. Set up your environment

The workspace ships with an environment that holds every variable the requests need.

Select the Cobre environment (top-right selector).

Fill in:

CobreBaseURL

https://api.cobre.co → Production

https://api.qa.cobre.co → QA / Sandbox

client_id → your client ID

secret → your secret

Leave access_token empty — it's set automatically when you authenticate.

Keep your client_id and secret in your own private environment. Never share an environment that contains real credentials.

3. Authenticate

Open General → Authentication and click Send.

Your access token is stored automatically in access_token.

Every other request reuses that token — no need to authenticate per collection.

If a request returns 401 Unauthorized, re-run Authentication and try again.

4. Send your first request

A good first flow:

General → Cobre Balance → Create — creates a balance to operate against.

General → Counterparties → Create — registers who you'll pay or collect from.

Open the product collection you need (e.g. PayIn — Colombia) and send a money movement.

Good to know

Idempotency. POST requests that create resources accept an idempotency header (minimum 9 characters). Send a unique value per operation to safely retry without creating duplicates.

Base URL. All requests point to {{CobreBaseURL}}, so you can switch environments without editing requests.

Webhooks. Use General → Webhooks to subscribe to events and track the lifecycle of your money movements.

How to integrate with Cobre — client journey from pre-sales to go-live

Build with AI — connect the Cobre Docs MCP in your IDE

Generate Code with MCP — scaffold code from the live spec

Explore API Workflow Examples — interactive walkthroughs of Cobre API sequences

Explore the APIs with Postman

What's included#

Prerequisites#

1. Open the workspace#

2. Set up your environment#

3. Authenticate#

4. Send your first request#

Good to know#

Related guides#

What's included

Prerequisites

1. Open the workspace

2. Set up your environment

3. Authenticate

4. Send your first request

Good to know

Related guides