---
title: "List all tags"
method: GET
path: "/tags"
tags: ["Tags"]
---

# List all tags

`GET /tags`

## Request

- Base URL: `https://api.copper.com/developer_api/v1`
- URL: `https://api.copper.com/developer_api/v1/tags`
- Auth: HTTP bearer

Retrieve a list of all tags and their entity usage counts. When tag_names_only=true, returns an array of strings instead of tag objects.

## Query parameters

- `sort_by` 'name' | 'count'
- `tag_names_only` boolean
- `last_tag_value` string

## Response `200`

Tags retrieved successfully. Response format depends on tag_names_only parameter: array of Tag objects (default) or array of strings (when tag_names_only=true).

- union
  - Tag[]: Array of tag objects with usage counts (default when tag_names_only=false or omitted)
    - `name` string, required: The name of the tag
    - `count` integer: The total number of entities the tag is associated to
    - `count_people` integer: The number of people the tag is associated to
    - `count_leads` integer: The number of leads the tag is associated to
    - `count_companies` integer: The number of companies the tag is associated to
    - `count_opportunities` integer: The number of opportunities the tag is associated to
    - `count_projects` integer: The number of projects the tag is associated to
    - `count_tasks` integer: The number of tasks the tag is associated to
  - string[]: Array of tag name strings (when tag_names_only=true)

## Other responses

- `400`: Bad Request - The request was invalid or cannot be served
- `401`: Unauthorized - Authentication credentials were missing or incorrect
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/copper/apis/copper-crm-read-only-api.md) - [All operations](https://skmtc.dev/copper/apis/copper-crm-read-only-api/llms.txt) - [OpenAPI document](https://skmtc.dev/copper/apis/copper-crm-read-only-api/revisions/96adc8557a40?raw)