---
title: "List custom tags"
method: GET
path: "/tags"
tags: ["Classification"]
---

# List custom tags

`GET /tags`

## Request

- Base URL: `https://frontrun.vc/v1`
- URL: `https://frontrun.vc/v1/tags`
- Auth: API key in header `X-API-Key`

List your custom tag records, optionally filtered by tag or custom sector. Free, costs 0 credits.

## Query parameters

- `tag` string
- `sector` string

## Response `200`

Tag records.

- object
  - `count` integer
  - `tags` TagRecord[]
    - `id` string
    - `twitter_user_id` string
    - `username` string
    - `tags` string[]
    - `custom_sector` string
    - `custom_entity_type` string
    - `notes` string
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing, invalid, inactive, or expired API key.
- `402`: Insufficient credits for this operation. Top up from the developer page or enable auto-refill.
- `429`: Rate limit or daily credit cap reached. Retry after the indicated reset time.

---

[API](https://skmtc.dev/frontrun/apis/frontrun-api.md) · [All operations](https://skmtc.dev/frontrun/apis/frontrun-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frontrun/apis/frontrun-api/revisions/6880b29e94c9?raw)