Referencia de la API

Recursos GET, parámetros y respuestas. Generados desde el contrato OpenAPI del servicio.

GET/v1/currencies

Parámetros

NombreTipo / valoresPredeterminado
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/rates/history/series

Parámetros

NombreTipo / valoresPredeterminado
institutionOpcional · querystring—
channelOpcional · queryunspecified | branch | digital | cash | transfer—
currencyRequerido · querystring—
kindOpcional · querycommercial | reference"commercial"
fromOpcional · querystring—
toOpcional · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/institutions

Parámetros

NombreTipo / valoresPredeterminado
currencyOpcional · querystring—
limitOpcional · queryinteger100
cursorOpcional · queryinteger0
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/rates

Parámetros

NombreTipo / valoresPredeterminado
currencyOpcional · querystring—
institutionOpcional · querystring—
channelOpcional · queryunspecified | branch | digital | cash | transfer—
kindOpcional · querycommercial | reference—
limitOpcional · queryinteger100
cursorOpcional · queryinteger0
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/rates/best

Parámetros

NombreTipo / valoresPredeterminado
currencyRequerido · querystring—
institutionOpcional · querystring—
channelOpcional · queryunspecified | branch | digital | cash | transfer—
kindOpcional · querycommercial | reference—
limitOpcional · queryinteger100
cursorOpcional · queryinteger0
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
operationRequerido · querybuy | sell—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/rates/history

Parámetros

NombreTipo / valoresPredeterminado
currencyOpcional · querystring—
institutionOpcional · querystring—
channelOpcional · queryunspecified | branch | digital | cash | transfer—
kindOpcional · querycommercial | reference—
limitOpcional · queryinteger100
cursorOpcional · queryinteger0
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
fromOpcional · querystring—
toOpcional · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/convert

Parámetros

NombreTipo / valoresPredeterminado
currencyRequerido · querystring—
institutionOpcional · querystring—
channelOpcional · queryunspecified | branch | digital | cash | transfer—
kindOpcional · querycommercial | reference—
limitOpcional · queryinteger100
cursorOpcional · queryinteger0
qOpcional · querystring—
sortOpcional · querystring—
fieldsOpcional · querystring—
operationRequerido · querybuy | sell—
amountRequerido · querystring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI
GET/v1/institutions/{id}

Parámetros

NombreTipo / valoresPredeterminado
idRequerido · pathstring—
AcceptOpcional · headerstring"application/json"
Descargar OpenAPI

JSON y XML

JSON es el formato predeterminado. Solicita XML UTF-8 con Accept: application/xml. Ambas representaciones conservan nulos explícitos y decimales como texto; Vary: Accept permite distinguirlas en caché.

cURL
curl --fail-with-body 'https://api.divisa.do/v1/rates?currency=USD' \
  -H 'Accept: application/xml'

Errores y límites

Comprueba response.ok antes de usar data. Ante 429 o 503, respeta Retry-After; evita reintentos continuos. Usa X-Request-Id para reportar errores. Las fuentes se consultan a las 08:00, 12:00 y 17:00, hora dominicana.

400
Parámetros inválidos
404
Entidad desconocida
406
Formato no aceptado
429
Límite temporal alcanzado
500
Error interno
503
Datos no disponibles