List Lead Tags

Retrieve all lead tags in the workspace, sorted by name, with lead counts.

GEThttps://api.foxreach.io/api/v1/leads/tags

Returns every tag that has been applied to at least one lead in the workspace, plus tags that exist but have no leads yet. Tags are sorted alphabetically.

Response#

dataarray

Array of tag objects.

Show Tag object

namestring

Tag name.

leadCountinteger

Number of leads in this workspace that carry this tag.

Rate Limit#

100 requests per minute, per API key. Fixed 60-second window.
Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Request

curl -X GET "https://api.foxreach.io/api/v1/leads/tags" \
  -H "X-API-Key: otr_your_key"

from foxreach import FoxReach

client = FoxReach(api_key="otr_your_key")
tags = client.leads.list_tags()

import { FoxReach } from "foxreach";

const client = new FoxReach({ apiKey: "otr_your_key" });
const tags = await client.leads.listTags();

Response

{
  "data": [
    { "name": "hot-lead", "leadCount": 42 },
    { "name": "q4-prospect", "leadCount": 17 },
    { "name": "unresponsive", "leadCount": 5 }
  ]
}

Was this page helpful?

View as MarkdownLast updated November 2, 2026