You can query the exchange rates from USD to COP agreed whit the bank and the remittance between two dates
- Protocols: HTTPS
Base Gateway API Endpoint
Paths
/exchange-rates
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
Proveedor de OAuth para autenticación con One Time Password(OTP) para Pymes
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"
}
}
}
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"
}
}
}
Respuesta exitosa
The request could not been understood or there are required parameters missing.
Authorization has failed or the user does not have permissions for the requested operation.
The requested resource was not found by the system.
Internal Server Error. Try again later.
The service is temporarily unavailable. Try again later.
Unexpected Error.
Proveedor de OAuth para autenticación con One Time Password(OTP) para Pymes
200 OK
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
}