---
displayed_sidebar: pricingReference
badge:
variant: orange
text: Beta
slug: /references/pricing/retrieveCurrency
sidebar_label: retrieveCurrency
---
import ParameterTypes from "@site/src/components/ParameterTypes"
# retrieveCurrency - Pricing Module Reference
This documentation provides a reference to the `retrieveCurrency` method. This belongs to the Pricing Module.
This method retrieves a currency by its code and and optionally based on the provided configurations.
## Example
A simple example that retrieves a currency by its code:
```ts
import {
initialize as initializePricingModule,
} from "@medusajs/pricing"
async function retrieveCurrency (code: string) {
const pricingService = await initializePricingModule()
const currency = await pricingService.retrieveCurrency(
code
)
// do something with the currency or return it
}
```
To specify attributes that should be retrieved:
```ts
import {
initialize as initializePricingModule,
} from "@medusajs/pricing"
async function retrieveCurrency (code: string) {
const pricingService = await initializePricingModule()
const currency = await pricingService.retrieveCurrency(
code,
{
select: ["symbol_native"]
}
)
// do something with the currency or return it
}
```
## Parameters
## Returns