List Tags

Returns all link tags for the authenticated organization. Tags can be assigned to tracking links and trial links. Requires permission api_tags_list.

https://public-api.fansmetric.com

GET/v1/tags

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Response Fields

data.tags[].idinteger
Tag ID.
data.tags[].namestring
Tag name (unique per org).
data.tags[].colorstring
Hex color (e.g. #93c5fd).
data.tags[].created_atstring
RFC 3339 timestamp.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.tags[].id	integer	Tag ID.
data.tags[].name	string	Tag name (unique per org).
data.tags[].color	string	Hex color (e.g. `#93c5fd`).
data.tags[].created_at	string	RFC 3339 timestamp.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/tags" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"tags":[0:{"id":1
"name":"Reddit"
"color":"#93c5fd"
"created_at":"2026-04-20T10:30:00Z"
}
1:{"id":4
"name":"Twitter"
"color":"#fca5a5"
"created_at":"2026-04-21T14:00:00Z"
}
]
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Shared Trial Links

Create Tag