# Read a draft

Source: https://docs.vlayers.ai/reference/messages/get-draft

`GET /v1/drafts/{id}` · scope `messages:read`

One draft, in any state: waiting, sent or thrown away. A sent or discarded draft says who decided it (`decidedBy`), when, and whether the words were changed.

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

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The draft id. Example: `"0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/drafts/$DRAFT_ID" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { draft } = await voicelayer.messages.getDraft('<draft-id>');
console.log(draft.state);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.messages.get_draft("<draft-id>")
print(result.draft.state)
```

## Response `200`

```json
{
  "draft": {
    "id": "0192f5b0-8d1f-7b62-8c3e-5f9a2b7d4e32",
    "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",
    "mailbox": "support@acme.vlayersmail.com",
    "to": "ada@example.org",
    "subject": "Friday",
    "body": "Friday at 3pm works. Shall I send an invite?",
    "attachments": [],
    "heldFor": "api",
    "origin": "composed",
    "state": "sent",
    "createdAt": "2026-10-20T15:04:05.000Z",
    "expiresAt": "2026-10-27T15:04:05.000Z",
    "decidedBy": "key:0192f5c4-8b9c-7dbe-8f3a-4b5c6d7e8f90",
    "decidedAt": "2026-10-20T15:04:05.000Z",
    "edited": false,
    "reason": null
  }
}
```
