Get All Tags

Get all available tags with pagination support.

Endpoint: GET /api/v1/integration/tags

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1)
per_page	integer	No	Number of items per page (default: 20)

Response

Status: 200 OK

Returns a paginated list of tags.

{
  "tags": [
    {
      "id": "f6a7b8c9-d0e1-2345-9012-456789012345",
      "name": {
        "tr": "Özsermaye",
        "en": "Equity"
      },
      "text_color": "#FFFFFF",
      "background_color": "#4CAF50",
      "created_at": "2025-12-11T19:11:47.465065Z",
      "updated_at": "2025-12-11T19:11:47.465065Z"
    },
    {
      "id": "e5f6a7b8-c9d0-1234-8901-345678901234",
      "name": {
        "tr": "Blokzincir",
        "en": "Blockchain"
      },
      "text_color": "#FFFFFF",
      "background_color": "#673AB7",
      "created_at": "2025-12-11T19:11:47.464819Z",
      "updated_at": "2025-12-11T19:11:47.464819Z"
    }
  ],
  "total": 36,
  "page": 1,
  "per_page": 20
}

Example cURL Request

curl -X GET 'https://<base-url>/api/v1/integration/tags?page=1&per_page=20' \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Target-Server: integration"