Sign in

v1

latestOpenAPI 3.0.12026-07-242073551.1 MB
Reference Data

Get Currencies

Retrieves a list of currencies available on the system along with their relevant details. <br />With this endpoint, you can search for specific currencies, paginate results, and sort the data as needed.

get/v4/currencies

Query parameters

searchTermstring

A string representing the term or keywords used to filter the list of currencies, <br /> helping users to narrow down the list based on the their input.

pageSizeinteger

An integer that defines the maximum number of currencies (records) returned per page in the response. <br /> For instance, if <b>pageSize</b> is set to 20, the API will return up to 20 currencies in each response. <br />
<br /> <b>Note:</b> By default, this value is set to 100.

pageNumberinteger

An integer indicating the specific page of results to retrieve, allowing for pagination of larger datasets. <br /> For example, if <b>pageNumber</b> is set to 3, the API will return the results corresponding to the third page of locations based on the specified <b>pageSize</b>. <br />
<br /> <b>Note:</b> By default, this value is set to 1.

sortBy'CurrencyName' | 'CurrencyCode'

Sort By

A string specifying the field by which to organise the search results. <br />For instance, "CurrencyName" could be used to sort currencies alphabetically, arranging the results in a more user-friendly order. <br /> <br /><b>Note:</b> By default, this value is set to <b>CurrencyName</b>. <br /> <br />Enum [CurrencyName, CurrencyCode]

sortDir'Ascending' | 'Descending'

Order Direction

A string indicating the direction in which to sort the results, typically set to "ascending" or "descending." <br />For example, setting <b>sortDir</b> to "Ascending" while using "CurrencyName" as <b>sortBy</b> would arrange the currencies from A to Z. <br /> <br /><b>Note:</b> By default, this value is set to Ascending. <br /> <br />Enum [Ascending, Descending]

Response

Returns a list of currencies.

TotalCountinteger required

An integer representing the total number of currencies matching the search criteria, regardless of pagination. <br />This information is useful for understanding the full scope of available results.

Example response

{
  "Currencies": [
    {
      "CurrencyName": "Pound Sterling",
      "CurrencyCode": "GBP"
    }
  ],
  "TotalCount": 245
}