Get a Currency

Retrieve a currency by its code. You can expand the currency's relations or select the fields that should be returned.

{ "currency": { "code": "usd", "symbol": "string", "symbol_native": "string", "name": "string", "decimal_digits": 0, "rounding": 0, "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "deleted_at": "2019-08-24T14:15:22Z" } }

Request

Path Params

code

string

required

The currency's code.

Query Params

fields

string

fields

optional

Comma-separated fields that should be included in the returned data. if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields. without prefix it will replace the entire default fields.

Header Params

x-publishable-api-key

string

required

Publishable API Key created in the Medusa Admin.

Responses

🟢200OK

application/json

Body

The currency's details.

currency

object (StoreCurrency)

required

The currency's details.

code

string

code

required

The currency's code.

Example:

usd

symbol

string

symbol

required

The currency's symbol.

symbol_native

string

symbol_native

required

The currency's symbol native.

name

string

name

required

The currency's name.

decimal_digits

number

decimal_digits

required

The currency's decimal digits.

rounding

number

rounding

required

The currency's rounding.

created_at

string <date-time>

created_at

required

The date the currency was created.

updated_at

string <date-time>

updated_at

required

The date the currency was updated.

deleted_at

string <date-time>

deleted_at

required

The date the currency was deleted.

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🔴500Server Error