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

# List Tags

> Retrieve all tags available to you

```
GET /v1/me/tags.list
```

Returns all tags (labels) that you own or that have been shared with you. Only available with a **personal** API key. No parameters required.

## Example Request

```bash theme={null}
curl -H "x-api-key: jk_your_personal_key" \
  "https://beta-api.meetjamie.ai/v1/me/tags.list"
```

## Example Response

```json theme={null}
{
  "result": {
    "data": {
      "json": {
        "tags": [
          {
            "id": "tag-001",
            "name": "Product",
            "shared": false
          },
          {
            "id": "tag-002",
            "name": "Engineering",
            "shared": true
          }
        ]
      }
    }
  }
}
```

## Response Fields

| Field           | Type    | Description                                                                   |
| --------------- | ------- | ----------------------------------------------------------------------------- |
| `tags`          | array   | List of tag objects                                                           |
| `tags[].id`     | string  | Unique tag ID                                                                 |
| `tags[].name`   | string  | Tag name                                                                      |
| `tags[].shared` | boolean | `true` if this tag was shared with you by another user, `false` if you own it |

<Tip>
  Use the tag name with the `tag` parameter on [`/v1/me/meetings.list`](/pages/api/meetings/list_meetings) to filter meetings by tag.
</Tip>