You can query the exchange rates from USD to COP agreed whit the bank and the remittance between two dates
Bancolombia API Working Group
- Protocols: HTTPS
production
development
https://sbapi.bancolombia.com
Base Gateway API Endpoint
Paths
/exchange-rates
get /exchange-rates
Remittances
Consultar tasas pactadas entre dos fechas
Con esta operación se pueden consultar las tasas de cambio de USD a COP pactadas entre el banco y la remesadora en una rango de fechas dadas
OAuth - Provider from OTP Pymes - Flow Application
OAuth - Provider from OTP Pymes - Flow Application
(oauth2 application)
Proveedor de OAuth para autenticación con One Time Password(OTP) para Pymes
Token URL
https://api.us.apiconnect.ibmcloud.com/bancolombiabluemix-dev/sandbox/v1/security/oauth-otp-pymes/oauth2/token
Scopes
Currency-rate:read:app
Consulta de tasas de cambio
currency_rateStartDate
Required in query
string / date
Fecha inicio del rango de fechas para consultar las tasas de cambios de dolares a pesos para fechas especificas
{
"x-imb-languages": {
"description": {
"en": "Start date used to query the agreed exchange rates"
}
}
}currency_rateEndDate
Required in query
string / date
Fecha fin del rango de fechas para consultar las tasas de cambios de dolares a pesos para fechas especificas
{
"x-imb-languages": {
"description": {
"en": "End date used to query the agreed exchange rates"
}
}
}Accept
Optional in header
string
application/vnd.bancolombia.v1+json
200
Respuesta exitosa
400
The request could not been understood or there are required parameters missing.
401
Authorization has failed or the user does not have permissions for the requested operation.
404
The requested resource was not found by the system.
500
Internal Server Error. Try again later.
503
The service is temporarily unavailable. Try again later.
default
Unexpected Error.
Example Request
Example Response
GET https://sbapi.bancolombia.com/v1/operations/specific-product/consumer-services/currency-exchange/exchange-rates
Try this operation
head /exchange-rates
OAuth - Provider from OTP Pymes - Flow Application
OAuth - Provider from OTP Pymes - Flow Application
(oauth2 application)
Proveedor de OAuth para autenticación con One Time Password(OTP) para Pymes
Token URL
https://api.us.apiconnect.ibmcloud.com/bancolombiabluemix-dev/sandbox/v1/security/oauth-otp-pymes/oauth2/token
Scopes
Currency-rate:read:app
Consulta de tasas de cambio
Accept
Optional in header
string
application/vnd.bancolombia.v1+json
200
200 OK
Example Request
Example Response
HEAD https://sbapi.bancolombia.com/v1/operations/specific-product/consumer-services/currency-exchange/exchange-rates
Try this operation
Definitions
{
"type": "object",
"required": [
"meta",
"data"
],
"properties": {
"meta": {
"$ref": "#\/definitions\/meta"
},
"data": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"required": [
"header",
"agreedRates"
],
"properties": {
"header": {
"$ref": "#\/definitions\/headerData"
},
"agreedRates": {
"$ref": "#\/definitions\/agreedRates"
}
}
}
},
"links": {
"$ref": "#\/definitions\/topLevelLinks"
}
},
"additionalProperties": false
}
{
"type": "array",
"items": {
"type": "object",
"required": [
"currency_rateDate",
"currency_cashPickupRate",
"currency_bankTransferRate"
],
"properties": {
"currency_rateDate": {
"type": "string",
"format": "date",
"description": "fecha en la cual es valida la tasa pactada con la remesadora en formato YYYY-MM-DD",
"example": "2019-03-01"
},
"currency_cashPickupRate": {
"type": "number",
"format": "float",
"description": "Tasa de cambio para pago de una remesa por ventanilla",
"example": "3095.60543"
},
"currency_bankTransferRate": {
"type": "number",
"format": "float",
"description": "Tasa de cambio para pago de una remesa por abono automático a cuenta",
"example": "3095.10543"
}
}
}
}
{
"type": "object",
"required": [
"meta",
"errors"
],
"properties": {
"meta": {
"$ref": "#\/definitions\/meta"
},
"errors": {
"type": "array",
"uniqueItems": true,
"items": {
"$ref": "#\/definitions\/error"
}
}
},
"additionalProperties": false
}
Non-standard meta-information that can not be represented realtion with data
{
"type": "object",
"required": [
"_messageId",
"_version",
"_requestDate"
],
"properties": {
"_messageId": {
"type": "string",
"example": "c4e6bd04-5149-11e7-b114-b2f933d5fe66"
},
"_version": {
"type": "string",
"example": "1.0"
},
"_requestDate": {
"type": "string",
"format": "date-time",
"example": "2017-01-24T05:00:00.000Z"
},
"_responseSize": {
"type": "integer",
"example": 1
},
"_clientRequest": {
"type": "string",
"example": "acxff62e-6f12-42de-9012-3e7304418abd"
}
},
"additionalProperties": true
}
URLs related to the primary data.
{
"type": "object",
"allOf": [
{
"$ref": "#\/definitions\/links"
}
]
}
A resource object MAY contain references to other resource objects
{
"type": "object",
"properties": {
"self": {
"description": "A self member, whose value is a URL for the relationship data",
"type": "string",
"format": "uri"
},
"related": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
The "type" and "id" for each data.
{
"type": "object",
"required": [
"type",
"id"
],
"properties": {
"type": {
"type": "string",
"example": "ExchangeRates"
},
"id": {
"type": "string",
"example": "ExchangeRates-2019-03-1"
}
},
"additionalProperties": false
}
{
"type": "object",
"required": [
"code",
"detail"
],
"properties": {
"id": {
"description": "A unique identifier for this particular occurrence of the problem.",
"type": "string",
"example": "5f2d287a-3a3f-11e7-a919-92ebcb67fe33"
},
"href": {
"description": "A URI that **MAY** yield further details about this particular occurrence of the problem.",
"type": "string",
"example": "https:\/\/tools.ietf.org\/html\/rfc7231#section-6.5.4"
},
"status": {
"description": "The HTTP status code applicable to this problem, expressed as a string value.",
"type": "string",
"example": 404
},
"code": {
"description": "An application-specific error code, expressed as a string value.",
"type": "string",
"example": "BP404"
},
"title": {
"description": "A short, human-readable summary of the problem. It **SHOULD NOT** change from occurrence to occurrence of the problem, except for purposes of localization.",
"type": "string",
"example": "Not Found"
},
"detail": {
"description": "A human-readable explanation specific to this occurrence of the problem.",
"type": "string",
"example": "Requested resource could not be found"
}
},
"additionalProperties": false
}