> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gladia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom metadata

> Attach metadata to transcription jobs for filtering and retrieval

<Badge color="blue" size="lg" icon="file-audio">
  Pre-recorded
</Badge>

<Badge color="green" icon="tower-broadcast" size="lg">
  Live
</Badge>

You can add metadata to your transcription using the `custom_metadata` property. This helps recognize your transcription when fetching results, and enables filtering via the list endpoints.

* **Pre-recorded**: add `custom_metadata` to your POST request to `/v2/pre-recorded`, then filter via GET `/v2/pre-recorded` or fetch via GET `/v2/pre-recorded/:id`.
* **Live**: add `custom_metadata` to your session configuration, then filter via the [GET `/v2/live` list endpoint](/api-reference/v2/live/list) or fetch via the [GET `/v2/live/:id` endpoint](/api-reference/v2/live/get).

For example:

```json theme={"system"}
"custom_metadata": {
  "internalUserId": 2348739875894375,
  "paymentMethod": { "last4Digits": 4576 },
  "internalUserName": "Spencer"
}
```

Now, you'll be able to filter transcription jobs based on their metadata:

<CodeGroup>
  ```bash Pre-recorded theme={"system"}
  https://api.gladia.io/v2/pre-recorded?custom_metadata={"internalUserId": "2348739875894375"}
  ```

  ```bash Live theme={"system"}
  https://api.gladia.io/v2/live?custom_metadata={"internalUserId": "2348739875894375"}
  ```
</CodeGroup>

or:

<CodeGroup>
  ```bash Pre-recorded theme={"system"}
  https://api.gladia.io/v2/pre-recorded?custom_metadata={"paymentMethod": {"last4Digits": 4576}, "internalUserName": "Spencer"}
  ```

  ```bash Live theme={"system"}
  https://api.gladia.io/v2/live?custom_metadata={"paymentMethod": {"last4Digits": 4576}, "internalUserName": "Spencer"}
  ```
</CodeGroup>

<Warning>
  `custom_metadata` cannot be longer than 2000 characters when stringified.
</Warning>