Quickstart
Make your first successful call to the Colurs API in less than 5 minutes.
⚠️
Before starting, you need your Sandbox credentials. Request them in Colurs Panel in the API Keys section.
Steps
1. Get your access token
Authenticate with your credentials to receive the JWT token pair.
curl -X POST https://dev.backend.colurs.co/token/ \
-H "Content-Type: application/json" \
-H "x-api-key: TU_API_KEY" \
-d '{
"email": "tu@empresa.com",
"password": "tu_password"
}'Successful response:
{
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}⏱️
The access token expires in 5 minutes. Save the refresh token
to renew it without logging in again.
2. Check balance
Use the access token to verify your integration works correctly.
curl -X GET https://dev.backend.colurs.co/balance/ \
-H "Authorization: Bearer TU_ACCESS_TOKEN" \
-H "x-api-key: TU_API_KEY" \
-H "Content-Type: application/json"Successful response:
{
"COP": "0.00",
"USD": "0.00",
"MXN": "0.00"
}3. Refresh token when it expires
Before the access token expires, renew it with the refresh token.
curl -X POST https://dev.backend.colurs.co/token/refresh/ \
-H "Content-Type: application/json" \
-H "x-api-key: TU_API_KEY" \
-d '{
"refresh": "TU_REFRESH_TOKEN"
}'Successful response:
{
"access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}4. Explore the rest of the API
You now have everything needed to integrate any Colurs flow.
Recommended next steps
| If you want to… | Go to… |
|---|---|
| Register a new user | Onboarding -> Registration |
| Fund an account in Colombia | Funding -> Colombia top-ups |
| Make a bank withdrawal | Payments -> Bank withdrawals |
| Convert currencies | Exchange -> Exchange FX |
| Send money between users | Payments -> User-to-user transfer |
All examples use the Sandbox environment (dev.backend.colurs.co).
When moving to production, replace base URL with prod.colurs.co.