API reference

GET resources, parameters and responses. Generated from the service’s OpenAPI contract.

GET/v1/currencies

Parameters

NameType / valuesDefault
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/rates/history/series

Parameters

NameType / valuesDefault
institutionOptional · querystring—
channelOptional · queryunspecified | branch | digital | cash | transfer—
currencyRequired · querystring—
kindOptional · querycommercial | reference"commercial"
fromOptional · querystring—
toOptional · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/institutions

Parameters

NameType / valuesDefault
currencyOptional · querystring—
limitOptional · queryinteger100
cursorOptional · queryinteger0
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/rates

Parameters

NameType / valuesDefault
currencyOptional · querystring—
institutionOptional · querystring—
channelOptional · queryunspecified | branch | digital | cash | transfer—
kindOptional · querycommercial | reference—
limitOptional · queryinteger100
cursorOptional · queryinteger0
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/rates/best

Parameters

NameType / valuesDefault
currencyRequired · querystring—
institutionOptional · querystring—
channelOptional · queryunspecified | branch | digital | cash | transfer—
kindOptional · querycommercial | reference—
limitOptional · queryinteger100
cursorOptional · queryinteger0
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
operationRequired · querybuy | sell—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/rates/history

Parameters

NameType / valuesDefault
currencyOptional · querystring—
institutionOptional · querystring—
channelOptional · queryunspecified | branch | digital | cash | transfer—
kindOptional · querycommercial | reference—
limitOptional · queryinteger100
cursorOptional · queryinteger0
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
fromOptional · querystring—
toOptional · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/convert

Parameters

NameType / valuesDefault
currencyRequired · querystring—
institutionOptional · querystring—
channelOptional · queryunspecified | branch | digital | cash | transfer—
kindOptional · querycommercial | reference—
limitOptional · queryinteger100
cursorOptional · queryinteger0
qOptional · querystring—
sortOptional · querystring—
fieldsOptional · querystring—
operationRequired · querybuy | sell—
amountRequired · querystring—
AcceptOptional · headerstring"application/json"
Download OpenAPI
GET/v1/institutions/{id}

Parameters

NameType / valuesDefault
idRequired · pathstring—
AcceptOptional · headerstring"application/json"
Download OpenAPI

JSON and XML

JSON is the default format. Request UTF-8 XML with Accept: application/xml. Both preserve explicit nulls and decimal strings; Vary: Accept distinguishes cached representations.

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

Errors and limits

Check response.ok before using data. On 429 or 503, respect Retry-After and avoid continuous retries. Use X-Request-Id when reporting errors. Sources are checked at 08:00, 12:00 and 17:00 Dominican time.

400
Invalid parameters
404
Unknown institution
406
Unsupported representation
429
Temporary rate limit
500
Internal error
503
Data unavailable