---
title: "List style profiles"
method: GET
path: "/v3/style_profiles"
tags: ["ManageStyleProfiles"]
---

# List style profiles

`GET /v3/style_profiles`

## Request

- Base URL: `https://api.deepl.com`
- URL: `https://api.deepl.com/v3/style_profiles`
- Auth: API key in header `Authorization`

Retrieve a list of style profiles available to the authenticated account, newest first.

The list includes style profiles that have been shared with the account.

Requires an API key with the `style_profiles:read` scope.

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Returns a list of style profiles.

- object
  - `style_profiles` StyleProfile[]
    - `style_profile_id` string, uuid, required: A unique ID assigned to a style profile.
    - `name` string, required: Name associated with the style profile. At most 255 characters.
    - `description` string: Free-text description of the style profile. At most 1000 characters. Omitted from the response when the style profile has no description.
    - `industry` string: The industry the style profile is written for. At most 255 characters. Omitted from the response when the style profile has no industry.
    - `glossary_ids` string[], required: The IDs of the glossaries linked to the style profile, highest priority first. The order only takes effect with `glossary_priority_order_enabled`.
    - `style_rule_ids` string[], required: The IDs of the style rule lists linked to the style profile. A style profile links at most one style rule list per target language.
    - `translation_memory_ids` string[], required: The IDs of the translation memories linked to the style profile. A style profile links at most one translation memory per source language.
    - `glossary_priority_order_enabled` boolean, required: Whether the order of `glossary_ids` sets priority: when two linked glossaries define the same source term, the one listed first wins. When `false`, the order has no effect.
    - `creation_time` string, date-time, required: The creation time of the style profile in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`).
    - `updated_time` string, date-time, required: The time of the last update to the style profile in the ISO 8601-1:2019 format (e.g.: `2021-08-03T14:16:18.329Z`).
  - `total_count` integer: The total number of style profiles available to the account.

## Other responses

- `400`: Bad request. Please check error message and your parameters.
- `401`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `403`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header. This error is also returned when the API key is scoped but does not include the scope required for this endpoint.
- `429`: Too many requests. Please wait and resend your request.
- `500`: Internal error.
- `503`: Resource currently unavailable. Try again later.

## Changes

- **2026-11-03** `c7c91cfac5c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/deepl/apis/deepl-api-documentation/changes/v3/style_profiles/get.md)

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) - [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/deepl/apis/deepl-api-documentation/revisions/c7c91cfac5c0?raw)