---
title: "Get Custom Field Values"
method: GET
path: "/incidents/{id}/custom_fields/values"
tags: ["Incidents"]
---

# Get Custom Field Values

`GET /incidents/{id}/custom_fields/values`

Get custom field values for an incident.

<!-- theme: warning -->

Scoped OAuth requires: `incidents.read`

## Path parameters

- `id` string, required

## Response `200`

The list of custom field values.

- object
  - `custom_fields` CustomFieldsFieldValue[], required
    - `id` string, required — Id of the field.
    - `name` string, required — The name of the field. May include ASCII characters, specifically lowercase letters, digits, and underescores. The `name` for a Field must be unique and cannot be changed once created.
    - `type` 'field_value', required — Determines the type of the reference.
    - `display_name` string, required — The human-readable name of the field. This must be unique across an account.
    - `field_type` 'single_value' | 'single_value_fixed' | 'multi_value' | 'multi_value_fixed', required — The type of data this field contains. In combination with the `data_type` field.
    - `data_type` 'boolean' | 'integer' | 'float' | 'string' | 'datetime' | 'url', required — The kind of data the custom field is allowed to contain.
    - `description` string, nullable, required — A description of the data this field contains.
    - `value` union, required
      - object
        - `value` boolean, nullable
      - object
        - `value` number, nullable
      - object
        - `value` integer, nullable
      - object
        - `value` union
          - string, nullable
          - string[], nullable
      - object
        - `value` string, date-time, nullable
      - object
        - `value` string, uri, nullable

## Other responses

- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404` — The requested resource was not found.
- `500` — Internal Server Error the PagerDuty server experienced an error.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/versions/b679a8f3f02c/schema)