# Retrieve locale values

Source: https://developers.swell.is/backend-api/localization/retrieve-locale-values

To retrieve records with `$locale` values in order to review localized content or build custom localization interfaces, pass an array of locale codes using the parameter `$locale: [<code>, ...]` with any `GET` request. All objects with `$locale` values will be returned matching the specific locale codes requested.

## Example request

**Example retrieving locale values**

**cURL**

```bash
$ curl https://api.swell.store/products?$locale=en,fr,es \
  -u store-id:secret-key
```

**Node**

```javascript
const { swell } = require('swell-node');
swell.init('store-id', 'secret-key');

await swell.get('/products', {
  $locale: ['en', 'fr', 'es']
});
```

**PHP**

```php
<?php $swell = new \\Swell\\Client('store-id', 'secret-key');

$swell->get('/products', [
  '$locale' => ['en', 'fr', 'es']
]);
```

## Example response

```json
{
  "count": 36,
  "results": [
    {
      "id": "5cad15bc9b14d1990724663a",
      "name": "Test product",
      "$locale": {
        "en": {
          "name": "Test product",
          "tags": ["tag1", "tag2"]
        },
        "fr": {
          "name": "Test produit",
          "tags": ["étiqueter1", "étiqueter2"]
        },
        "es": {
          "name": "Producto de prueba",
          "tags": ["etiqueta1", "etiqueta2"]
        }
      },
      ...
    }
  ],
  "page": 1,
  "page_count": 3,
  "limit": 15,
  ...
}
```