
# Get text overrides

`GET /v1/branding/texts/{screen}/{locale}` · permission `branding:read`

Returns the text overrides of one hosted page screen and locale in the environment scope, or in an application or organization scope (`application_id` / `org_id`). Keys without an override use the built-in catalog text. Overrides become live on publish.

## Request

| Field | Type | Required | Description |
|---|---|---|---|
| `screen` | path | yes | Hosted page screen (e.g. `login`, `authorize`). |
| `locale` | path | yes | Supported locale (e.g. `en`, `tr`). |
| `application_id` | query | no | Application scope (`app_…`). Without it and `org_id` the environment scope is used. |
| `org_id` | query | no | Organization scope (`org_…`). Cannot be combined with `application_id`. |

## Response

`200 OK` with every override of the scope, screen and locale.

```json
{"screen": "login", "locale": "tr", "texts": {"title": "Hoş geldiniz"}}
```

## Errors

| HTTP | code | When |
|---|---|---|
| 404 | `not_found` | The `application_id` or `org_id` is malformed, or the application does not exist in this environment. |
| 422 | `validation_failed` | Both `application_id` and `org_id` were given (`mutually_exclusive`), or one was repeated (`repeated`). |
| 401 | `unauthenticated` | The credential is missing, invalid or revoked. |
| 403 | `insufficient_permissions` | The credential lacks the required permission. |
| 429 | `rate_limited` | The rate limit was exceeded; retry after the `Retry-After` period. |
| 503 | `service_unavailable` | A dependency is temporarily unavailable; retry after the `Retry-After` period. |

## Example

```bash
curl "https://api.eu.keenauth.com/v1/branding/texts/login/tr" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```
