CorebanqCorebanq Developer Docs
Currenciesv2

List currencies (v2, paginated)

Handler: GetAllCurrenciesV2 → getAllServiceV2.SrvGetAllCurrencies. Returns models.GetAllResponseAPI envelope; data items are transform.CurrencyResponse. Supports standard get_all query (search.*, limit, offset, sort, stack). When includecrypto=true, joins crypto accounts and validates projectid (int64) and optional customerid (UUID). icon_url rewritten like v1.

GET
/v2/currencies

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

limit?integer

Page size. Defaults to 10 and is capped at 100 by the shared query parser. -1 skips data fetching and returns only the count (total/total_unfiltered); any other value <= 0 falls back to the default limit.

offset?integer
sort?string

Comma-separated; prefix '-' for descending

stack?string
search.code?string
search.numeric_code?string
search.name?string
search.name.like?string
search.symbol?string
search.is_fiat?boolean
search.is_base?boolean
search.active?boolean
search.decimal_places?integer
search.precision?integer
search.rounding?string
search.format?string
search.display_priority?integer
search.icon_url?string
search.description?string
search.id?string
search.created_at?string
search.modified_at?string
includecrypto?boolean

When true, include cryptocurrencies linked via crp accounts join

projectid?integer

When includecrypto=true, validated as int64; invalid value → 400

customerid?string

Optional customer scope when includecrypto=true; invalid UUID → 400

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/currencies"
{
  "data": [
    {
      "id": "40a9cd1e-918b-45ca-bf39-efdb3b0024dd",
      "code": "SAR",
      "numeric_code": "682",
      "name": "SAR",
      "description": "SAR",
      "symbol": "SAR",
      "decimal_places": 2,
      "precision": 4,
      "rounding": "half_up",
      "is_fiat": true,
      "is_base": false,
      "format": "%s %v",
      "display_priority": 100,
      "icon_url": "/icons/sa.svg",
      "active": false,
      "metadata": null,
      "created_at": "2025-09-24T15:38:47.821485+02:00",
      "created_by": "00000000-0000-0000-0000-000000000000",
      "modified_at": "2025-09-24T15:38:47.821485+02:00",
      "modified_by": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "total": 169,
  "total_unfiltered": 169,
  "has_more": true
}
{
  "status": 400,
  "message": "Invalid input"
}
{
  "status": 401,
  "message": "Unauthorized"
}
{
  "status": 500,
  "message": "server_error"
}