---
title: "Benutzerdefiniertes Feld abfragen"
description: "Gibt eine aktive Felddefinition deiner Organisation zurück, in derselben Form wie ein Eintrag der Feldliste."
---

`GET /api/custom-fields/{id}`

## Zugriff

Jedes Mitglied der Organisation. Zurück kommen nur aktive Definitionen der eigenen Organisation; ein gelöschtes (inaktives) Feld antwortet `404`.

## Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/custom-fields/7" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort (Response)

`200 OK`

```json
{
  "id": 7,
  "organizationId": 10,
  "name": "Contract number",
  "fieldKey": "contract_number",
  "fieldType": "text",
  "isRequired": false,
  "displayOrder": 1,
  "options": null,
  "placeholder": "e.g. C-2026-001",
  "helpText": null,
  "showInTable": true,
  "isActive": true,
  "createdAt": "2026-06-01T08:00:00.000Z",
  "updatedAt": "2026-06-01T08:00:00.000Z"
}
```

## Häufige Fehler

- `400 Bad Request` (`fieldIdRequired`), wenn die ID keine positive Zahl ist
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `404 Not Found` (`customFieldNotFound`), wenn das Feld nicht existiert, inaktiv ist oder zu einer anderen Organisation gehört