---
title: "Get all global variables"
method: GET
path: "/api/v1/synthetics/variables"
tags: ["Synthetics"]
---

# Get all global variables

`GET /api/v1/synthetics/variables`

Get the list of all Synthetic global variables.

## Response `200`

OK

- SyntheticsListGlobalVariablesResponse — Object containing an array of Synthetic global variables.
  - `variables` SyntheticsGlobalVariable[] — Array of Synthetic global variables.
    - `attributes` SyntheticsGlobalVariableAttributes — Attributes of the global variable.
      - `restricted_roles` string[] — A list of role identifiers that can be pulled from the Roles API, for restricting read and write access. This field is deprecated. Use the restriction policies API to manage permissions.
    - `description` string, required — Description of the global variable.
    - `id` string — Unique identifier of the global variable.
    - `is_fido` boolean — Determines if the global variable is a FIDO variable.
    - `is_totp` boolean — Determines if the global variable is a TOTP/MFA variable.
    - `name` string, required — Name of the global variable. Unique across Synthetic global variables.
    - `parse_test_options` SyntheticsGlobalVariableParseTestOptions — Parser options to use for retrieving a Synthetic global variable from a Synthetic test. Used in conjunction with `parse_test_public_id`.
      - `field` string — When type is `http_header`, name of the header to use to extract the value.
      - `localVariableName` string — When type is `local_variable`, name of the local variable to use to extract the value.
      - `parser` SyntheticsVariableParser — Details of the parser to use for the global variable.
        - `type` 'raw' | 'json_path' | 'regex' | 'x_path', required — Type of parser for a Synthetic global variable from a synthetics test.
        - `value` string — Regex or JSON path used for the parser. Not used with type `raw`.
      - `type` 'http_body' | 'http_header' | 'http_status_code' | 'local_variable', required — Type of value to extract from a test for a Synthetic global variable.
    - `parse_test_public_id` string — A Synthetic test ID to use as a test to generate the variable value.
    - `tags` string[], required — Tags of the global variable.
    - `value` SyntheticsGlobalVariableValue, required — Value of the global variable.
      - `options` SyntheticsGlobalVariableOptions — Options for the Global Variable for MFA.
        - `totp_parameters` SyntheticsGlobalVariableTOTPParameters — Parameters for the TOTP/MFA variable
          - `digits` integer — Number of digits for the OTP code.
          - `refresh_interval` integer — Interval for which to refresh the token (in seconds).
      - `secure` boolean — Determines if the value of the variable is hidden.
      - `value` string — Value of the global variable. When reading a global variable, the value will not be present if the variable is hidden with the `secure` property.

## Other responses

- `403` — Forbidden
- `429` — Too many requests

---

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