# Export a vocabulary list

Download the words of a list the caller can read, with their usage counts, as `.xlsx` or `.csv`. The file can be imported again unchanged. Words of the list the caller may not read are left out. At most 50,000 words are exported.

#### Path Parameters

**`list_id`** string required

The list to export.

#### Query Parameters

**`format`** string optional · Defaults to `xlsx`

`xlsx` or `csv`.

## Returns

The file, as an attachment named `vocabulary-<list name>.<format>`. The columns are `written`, `sounds_like` (separated by `;`), `language`, `kind`, `weight`, `enabled`, `applied_count`, `heard_count` and `corrected_count`.

Example

```bash cURL
curl "https://api.aitronos.com/v1/vocabulary/lists/voclist_8f2a61c4e0b94d7a/export?format=csv" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -o vocabulary.csv
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/vocabulary/lists/voclist_8f2a61c4e0b94d7a/export",
    headers={"X-API-Key": api_key},
    params={"format": "csv"},
)

with open("vocabulary.csv", "wb") as file:
    file.write(response.content)
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/vocabulary/lists/voclist_8f2a61c4e0b94d7a/export?format=csv', {
  headers: {
    'X-API-Key': apiKey
  }
});

const csv = await response.text();
console.log(csv);
```

**Response:**


```text 200 OK
written,sounds_like,language,kind,weight,enabled,applied_count,heard_count,corrected_count
Kubernetes,cube ernetes;kuber netties,,bias,1.0,true,14,9,0
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to perform this action.",
    "system_message": "Caller lacks the rights this operation needs.",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "VOCABULARY_LIST_NOT_FOUND",
    "message": "The vocabulary list was not found.",
    "system_message": "Vocabulary list not found.",
    "type": "client_error",
    "status": 404,
    "details": {},
    "trace_id": "req_7d1e4b9a2c",
    "timestamp": "2026-10-26T09:30:00Z"
  }
}
```

## Related Resources

- [Import words into a vocabulary list](/api-reference/vocabulary/import-words-into-a-vocabulary-list) — Add and update words from a file.
- [Vocabulary API](/api-reference/vocabulary/_index) — Overview of lists, entries and settings.