# List strings

`GET https://app.shuttleglobal.com/c/api/instances/{instance_key}/strings`

Returns every string that can be changed, with the wording that currently applies for the
language requested.

Strings that have not been translated into the language return the wording they inherit, so
listing a language you have not used yet returns the full set ready to translate. A string
that has its own wording in this language carries `overriding`, the wording it would
otherwise inherit.

This list does not take `criteria`, `order` or `expand`, and is not paginated: it always
returns the complete set.

## Authentication

- basicAuth: Basic Authentication using secret key
- bearerAuth: OAuth 2.0 Bearer Token Authentication

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `language` | query | string | no | Lowercase two-letter ISO 639-1 language code (e.g. `ar`), or `default` for the base wording. Defaults to `default`. |
| `branding` | query | string | no | Enterprise field, for accounts with more than one branding. Leave out to use your own branding. |

## Responses

### 200: All strings for the language

```json
{
  "strings": [
    {
      "id": "web.payment_form.card_number",
      "text": "رقم البطاقة",
      "branding": "brd_123",
      "language": "ar",
      "overriding": "Card Number"
    },
    {
      "id": "web.payment_processing.error",
      "text": "There was a problem processing the payment.",
      "branding": "brd_123",
      "language": "ar"
    }
  ]
}
```

### 401: Authentication required

```json
{
  "code": "UNAUTHORIZED",
  "message": "Unauthorised"
}
```

## Example request

```sh
curl --request GET \
  --url https://app.shuttleglobal.com/c/api/instances/YOUR_INSTANCE_KEY/strings \
  --header 'Authorization: Basic <base64 of SECRET_KEY:>'
```

Reference page: https://docs.shuttleglobal.com/platforms/reference/operations/liststrings/