Currency

Currency

List foreign currencies

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/currencies

List foreign currencies.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/currencies

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/currencies HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "currencyUid": "text",
      "currencyCode": "text",
      "exchangeRate": 1,
      "createdAt": "2025-10-28T21:38:54.940Z",
      "createdBy": "text",
      "lastModifiedAt": "2025-10-28T21:38:54.940Z",
      "lastModifiedBy": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Add currency

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/currencies

Add a currency with exchange rate. Currency codes follow the ISO 4217 standard. Exchange rates are entered as integers in cents (2 decimals).

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

currencyUidstringOptionalPattern: ^[A-Za-z0-9-_]*

currencyCodestringRequired

ISO 4217 standard

exchangeRateintegerRequired

in cents (2 decimals)

Responses

201

Example response

application/json

post

/tenants/{tenantUid}/currencies

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/currencies HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "currencyUid": "text",
  "currencyCode": "text",
  "exchangeRate": 1
}

201

Example response

{
  "currencyUid": "text",
  "currencyCode": "text",
  "exchangeRate": 1,
  "createdAt": "2025-10-28T21:38:54.940Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-28T21:38:54.940Z",
  "lastModifiedBy": "text"
}

Get currency

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/currencies/{currencyUid}

Get a currency.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

currencyUidstringRequired

Key to currency

Responses

200

Example response

application/json

get

/tenants/{tenantUid}/currencies/{currencyUid}

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/currencies/{currencyUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "currencyUid": "text",
  "currencyCode": "text",
  "exchangeRate": 1,
  "createdAt": "2025-10-28T21:38:54.940Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-28T21:38:54.940Z",
  "lastModifiedBy": "text"
}

Update currency

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/currencies/{currencyUid}

Update a currency.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

currencyUidstringRequired

Key to currency

Body

application/json

currencyCodestringOptional

ISO 4217 standard

exchangeRateintegerOptional

in cents (2 decimals)

Responses

200

Example response

application/json

put

/tenants/{tenantUid}/currencies/{currencyUid}

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/currencies/{currencyUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "currencyCode": "text",
  "exchangeRate": 1
}

200

Example response

{
  "currencyUid": "text",
  "currencyCode": "text",
  "exchangeRate": 1,
  "createdAt": "2025-10-28T21:38:54.940Z",
  "createdBy": "text",
  "lastModifiedAt": "2025-10-28T21:38:54.940Z",
  "lastModifiedBy": "text"
}

Delete currency

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/currencies/{currencyUid}

Delete a currency.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

currencyUidstringRequired

Key to currency

Responses

204

No Content

No content

delete

/tenants/{tenantUid}/currencies/{currencyUid}

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/currencies/{currencyUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content