Skip to content

Get Currencies​

GET
/api/v1/shared/currencies

Lists currencies with the latest CBRT exchange rates, with pagination.

Parameters​

Header Parameters

Authorization*

Token returned by the Get Token request, with the Bearer prefix

Typestring
Required
Example"Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.signature"
Accept-Language

Language of country and unit of measure names and validation error messages. English when it starts with en (e.g. en, en-US), Turkish otherwise. Success messages are always in Turkish.

Typestring
Examples
"tr"
"en"
Default"tr"

Query Parameters

page

Page number

Typeinteger
Minimum1
Default1
perPage

Records per page. To get the whole list, use 200 and iterate over meta.pageCount pages.

Typeinteger
Minimum1
Maximum200
Default50
sortBy

Sort field

Typestring
Valid values
"orderNumber""name""code""id""updatedAt""sellingTry""buyingTry"
Default"orderNumber"
sortOrder

Sort direction (case-insensitive)

Typestring
Valid values
"asc""desc"
Default"desc"
codes

Comma-separated currency codes. Each code is at most 3 characters; case-insensitive

Typestring
Example"USD,EUR"
Min Length1
isDefined

true: currencies whose selling and buying rates are both greater than 0, false: both 0. A currency with only one rate at 0 is returned in neither case

Typeboolean

Responses​

Currencies listed

application/json
JSON
{
"success": true,
"message": "Para birimleri listelendi",
"items": [
{
"id": 1,
"code": "USD",
"name": "US dollar",
"flagPath": "string",
"rates": {
"sellingTry": 41.95,
"buyingTry": 41.87,
"updatedAt": "2026-10-10T12:30:00.000Z"
}
}
],
"meta": {
"page": 1,
"perPage": 50,
"total": 233,
"pageCount": 5
}
}

Playground​

Headers
Variables
Key
Value

Samples​

cURL
JavaScript
PHP
Python