---
title: "Retrieve a style profile"
method: GET
path: "/v3/style_profiles/{style_profile_id}"
tags: ["ManageStyleProfiles"]
---

# Retrieve a style profile

`GET /v3/style_profiles/{style_profile_id}`

## Request

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

Retrieve a single style profile by its ID, including the components it links and its timestamps.

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

## Path parameters

- `style_profile_id` string, uuid, required: A unique ID assigned to a style profile.

## Response `200`

Returns the style profile.

- 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`).

## 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.
- `404`: The style profile could not be found. This is also returned for a style profile your account cannot access.
- `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/:style_profile_id/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)
