Skip to main content
GET
/
v2
/
tags
Get Tags
curl --request GET \
  --url https://gateway.polymarket.us/v2/tags
{
  "tags": [
    {
      "id": "<string>",
      "label": "<string>",
      "slug": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "image": "<string>",
      "tradable": true,
      "league": {
        "id": 123,
        "name": "<string>",
        "sportId": 123,
        "tagId": 123,
        "image": "<string>",
        "resolution": "<string>",
        "ordering": "<string>",
        "activeSeriesId": 123,
        "isOperational": true,
        "automaticResolution": true,
        "createdAt": "<string>",
        "slug": "<string>",
        "abbreviation": "<string>"
      },
      "sport": {
        "id": 123,
        "name": "<string>",
        "tagId": 123,
        "createdAt": "<string>",
        "slug": "<string>",
        "image": "<string>"
      },
      "parentId": 123,
      "subtags": [
        {}
      ]
    }
  ]
}

Query Parameters

limit
integer<int32>

Pagination limit

offset
integer<int32>

Pagination offset

orderBy
string[]

Pagination order

orderDirection
string

Pagination order direction

slug
string[]

Tag slug to filter by

ids
integer<int32>[]

List of tag IDs to filter by

parentId
integer<int32>

Filter by parent tag ID. Ignored if parent_slug is provided.

parentSlug
string

Filter by parent tag slug. Takes priority over parent_id if both are provided.

Response

List of tags

tags
object[]

List of tags