# List tracking tags

Returns tracking tags.

```http
GET https://api.pozy.ai/v1/accounts/{accountId}/tracking-tags
```

- Area: Ads / Tracking Tags
- Auth: Authorization: Bearer pz_live_...

## Path parameters

- `accountId` (string, required)

## Query parameters

- `adAccountId` (string)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/tracking-tags" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/tracking-tags", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/accounts/696e0b682d0a31188e7a2ba9/tracking-tags",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `platform`, string: One of `metaads`, `openaiads`, `tiktokads`, `googleads`, `xads`, `linkedinads`, `pinterestads`, `whopads`
- `tags`, array of object
  - `id`, string, required
  - `siteTagId`, string
  - `events`, array of object
    - `id`, string, required
    - `name`, string, required
    - `type`, string
    - `siteEvent`, string: One of `page_view`, `view_content`, `add_to_cart`, `search`, `initiate_checkout`, `add_payment_info`, `purchase`
    - `siteEventId`, string
    - `status`, string
    - `defaultValue`, number
    - `currency`, string
    - `clickWindowDays`, integer
    - `viewWindowDays`, integer
    - `urlContains`, string
    - `alwaysUseDefaultValue`, boolean
    - `primary`, boolean
    - `countingType`, string: One of `one`, `every`
  - `name`, string, required
  - `platform`, string, required: One of `metaads`, `openaiads`, `tiktokads`, `googleads`, `xads`, `linkedinads`, `pinterestads`, `whopads`
  - `kind`, string, required: One of `pixel`, `tag`, `insight_tag`
  - `status`, string, required: One of `active`, `inactive`
  - `code`, string
  - `lastFiredTime`, integer: Can be null
  - `isUnavailable`, boolean
  - `installed`, boolean
  - `creationTime`, integer
  - `automaticMatchingFields`, array of string: Each item: one of `em`, `ph`, `fn`, `ln`, `ge`, `db`, `ct`, `st`, `zp`, `country`, `external_id`
  - `ownerBusinessId`, string: Can be null
  - `ownerAdAccountId`, string
  - `autoTagging`, boolean

```json
{
  "platform": "metaads",
  "tags": [
    {
      "id": "6bfebd43ddc270f6d2c56fc5",
      "siteTagId": "6d5de911d364c53ecd4e8f18",
      "events": [
        {
          "id": "6bfebd43ddc270f6d2c56fc5",
          "name": "Acme",
          "type": "string",
          "siteEvent": "page_view",
          "siteEventId": "6a036e72b4645cc9fc4fed0b",
          "status": "active",
          "defaultValue": 12.5,
          "currency": "USD",
          "clickWindowDays": 1,
          "viewWindowDays": 1,
          "urlContains": "https://pozy.ai/media/example-1.jpg",
          "alwaysUseDefaultValue": true,
          "primary": true,
          "countingType": "one"
        }
      ],
      "name": "Acme",
      "platform": "metaads",
      "kind": "pixel",
      "status": "active",
      "code": "string",
      "lastFiredTime": 1,
      "isUnavailable": true,
      "installed": true,
      "creationTime": 1,
      "automaticMatchingFields": [
        "em"
      ],
      "ownerBusinessId": "6e5a40864fb7bdd4fc381ec9",
      "ownerAdAccountId": "6784ed1a71542b1db5a40c3c",
      "autoTagging": true
    }
  ]
}
```