---
title: "Tag abfragen"
description: "Gibt einen Tag per numerischer ID oder publicId zurück, in derselben Form wie ein Eintrag von „Tags auflisten“."
---

`GET /api/tags/{id}`

## Zugriff

Dieselbe Sichtbarkeit wie [Tags auflisten](/de/api/tags/list-tags): Nutzer mit Kundenbeschränkung sehen die Tags ihrer Kunden und selbst angelegte Tags; ein Tag außerhalb davon antwortet `404`.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/tags/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort (Response)

`200 OK`

```json
{
  "id": 1,
  "publicId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "organizationId": 10,
  "customerId": null,
  "name": "Production",
  "color": "red",
  "createdBy": "u_abc123",
  "createdAt": "2026-06-01T08:00:00.000Z",
  "updatedAt": "2026-06-01T08:00:00.000Z",
  "customer": null,
  "owner": {
    "id": "u_abc123",
    "name": "Ada Admin",
    "email": "ada@example.com"
  },
  "customers": []
}
```

## Häufige Fehler

- `400 Bad Request`, wenn die ID weder Zahl noch UUID ist
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden`, wenn dein Konto keiner Organisation angehört
- `404 Not Found` (`tagNotFound`), wenn der Tag nicht existiert oder für dich nicht sichtbar ist