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.

INFO

Requires the tags:read OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

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

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/json

Success

Bodyapplication/json

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"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Server Error

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-08-31 12:06:53

Retrieve Company ICP Matches

Create Tag