Retrieve Tags

GET

/v1/tags

Retrieve the list of all tags available in the account.
The response contains all tag definitions, including their identifiers, display names, and colors, which can be used to classify or filter companies within the platform.
Credit Note: Retrieving tag data does not consume credits.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api.leadfeeder.com/v1/tags?account_id=123456&page[num]=1&page[size]=20' \
--header 'X-Api-Key: <api-key>'

Response Example

200 - Success Example

{
    "data": [
        {
            "type": "tag",
            "id": "4b7e2c9f",
            "attributes": {
                "name": "Prospects",
                "color": 0,
                "created_at": "2024-12-10T15:57:25Z",
                "updated_at": "2024-11-24T11:50:00Z"
            },
            "relationships": {
                "created_by": {
                    "id": "abc123",
                    "type": "user"
                }
            }
        }
    ],
    "meta": {
        "pagination": {
            "page_num": 1,
            "page_count": 1,
            "total_count": 1
        },
        "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
}

Modified at 2026-05-04 13:48:12

Get Ideal Customer Profile Details

Create Tag