---
title: "L01 - List locale codes and labels"
method: GET
path: "/api/locales"
tags: ["Platform Settings"]
---

# L01 - List locale codes and labels

`GET /api/locales`

## Request

- Base URL: `https://your-instance.mirakl.net`
- URL: `https://your-instance.mirakl.net/api/locales`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://auth.mirakl.net/authorize`
    - Token URL: `https://auth.mirakl.net/oauth/token`
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/docs/api/locales/get.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

List locale codes and labels from your platform to automate product format exports (API H01, PM01, VL01) from your PIM system

<div class="api-description-extension">
<div class="extension-title">Call Frequency</div>

<div class="recommended-call-frequency">Recommended usage: Once per day</div>
<div class="max-call-frequency">Maximum usage: Once per day</div>
</div>

## Response `200`

OK

- L01Response200
  - `locales` L01Response200Locales[], required: List of locales
    - `code` string, required: Locale code
    - `label` string, required: Locale label
    - `platform_default` boolean: Default locale of the platform

---

[API](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-catalog-manager-apis/revisions/dd54ccb6550e?raw)