# See the lines an agent says by itself

Source: https://docs.vlayers.ai/reference/agents/get-agent-lines

`GET /v1/agents/{id}/lines` · scope `workspace:read`

The short lines the platform speaks for the agent (the hold line, the filler before a slow answer, re-asks, hand-off notices, the apology), in each language the agent lists, main language first. For each line `text` is what a call would say and `source` says where it came from: `owner` (your own words), `pack` (written for you by the platform from the English line), `main` or `english` (a fallback, because that language has no text for it yet; silence is never the fallback). `packState` is `writing`, `ready` or `failed`; asking for a language the platform has not written yet starts it in the background. Pass `language` to read one.

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

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |
| `language` | query | string | no | Read one language only, for example `gu-IN`. Example: `"gu-IN"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/lines?language=gu-IN" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { languages } = await voicelayer.agents.getLines('<agent-id>', { language: 'gu-IN' });
console.log(languages);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.get_lines("<agent-id>", language="gu-IN")
print(result.languages)
```

## Response `200`

```json
{
  "languages": [
    {
      "language": "gu-IN",
      "packState": "ready",
      "revision": 1,
      "lines": [
        {
          "id": "hold",
          "text": "એક ક્ષણ, કૃપા કરીને.",
          "source": "pack",
          "english": "One moment, please."
        }
      ],
      "words": {
        "yes": [
          "હા"
        ],
        "no": [
          "ના"
        ],
        "goodbye": [
          "આવજો"
        ]
      }
    }
  ]
}
```
