# List Tags

`lawmatics_list-tags` · Lawmatics MCP tool · Tags

List tags from Lawmatics with optional pagination and sorting.

## Input

- **page** `integer` (> 0) — Page number (1-based)
- **sortBy** `string` (enum: "id", "created_at", "updated_at", "name") — Column to sort by
- **sortOrder** `string` (enum: "asc", "desc") — Sort direction; ascending or descending

## Output

- **tags** `array` (required) — Tags on this page of results
  - **[]** `object`
    - **id** `string` (required) — Lawmatics tag ID
    - **name** `string` (required) — Tag name
    - **description** `string | null` (required) — Free-text tag description; null when the tag has none
    - **color** `string | null` (required) — Tag color as a CSS color string (e.g. #7997c9); null when the tag has none
    - **createdAt** `string | null` (required) — When the tag was created, as an ISO 8601 timestamp; null if unknown
    - **updatedAt** `string | null` (required) — When the tag was last updated, as an ISO 8601 timestamp; null if unknown
- **pagination** `object | null` (required) — Pagination metadata from the API response; null when the endpoint returns no meta envelope
  - **totalPages** `number | null` (required) — Total number of pages available; null if not reported
  - **limitPerPage** `number | null` (required) — Maximum tags returned per page; null if not reported
  - **totalEntries** `number | null` (required) — Total number of tags across all pages; null if not reported