> For the complete documentation index, see [llms.txt](https://docs.nected.ai/nected-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nected.ai/nected-docs/management-api/global-variable-api/list-all-global-variables.md).

# List All Global Variables

Get a paginated list of all global variables in your workspace.

The **200** response `data` is an array of variable summary objects. Each item includes `name`, `dataType`, `value` (masked as `***` for secret variables), `isSecret`, `canReset`, `checksum`, `createdAt`, `updatedAt`. Pagination metadata (`pageNo`, `pageSize`, `totalCount`, `totalPages`) is returned at the top level.

## List global variables

> Get a paginated list of all global variables in your workspace.\
> \
> \*\*Response \`data\`\*\* is an array of variable objects. Each item includes \`name\`, \`dataType\`, \`value\` (masked as \`\*\*\*\` for secrets), \`isSecret\`, \`canReset\`, \`checksum\`, \`createdAt\`, \`updatedAt\`.\
> \
> Pagination fields are returned at the top level: \`pageNo\`, \`pageSize\`, \`totalCount\`, \`totalPages\`.\
> \
> \*\*Canonical response file:\*\* \`Get/GET\_ALL.json\`

```json
{"openapi":"3.0.3","info":{"title":"Nected Global Variable API","version":"1.0"},"tags":[{"name":"GlobalVariable","description":"Create, read, update, and delete global variables."}],"servers":[{"url":"https://api.nected.ai","description":"Production"}],"security":[{"DevAuth":[]}],"components":{"securitySchemes":{"DevAuth":{"type":"apiKey","in":"header","name":"Nected-API-Key","description":"Your Nected API key. Obtain from workspace settings."}},"schemas":{"ListVariablesResponse":{"type":"object","description":"Response wrapper for the list endpoint","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/GlobalVariable"}},"code":{"type":"string"},"message":{"type":"string"},"pageNo":{"type":"integer"},"pageSize":{"type":"integer"},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"}}},"GlobalVariable":{"type":"object","description":"A global variable object as returned by get and list endpoints","properties":{"name":{"type":"string","description":"Unique variable name within the workspace"},"dataType":{"type":"string","description":"Data type — one of `string`, `numeric`, `boolean`, `json`","enum":["string","numeric","boolean","json"]},"value":{"description":"Variable value. Masked as `***` in responses when `isSecret` is true."},"isSecret":{"type":"boolean","description":"When true, value is masked in all get/list responses"},"canReset":{"type":"boolean","description":"When true, the variable can be reset to its original value via the UI"},"checksum":{"type":"string","description":"Current checksum — required for update and delete operations"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","description":"Error response wrapper","properties":{"code":{"type":"string"},"message":{"type":"string","description":"Human-readable error description"},"data":{"nullable":true}}}}},"paths":{"/dev/variable":{"get":{"operationId":"listGlobalVariables","tags":["GlobalVariable"],"summary":"List global variables","description":"Get a paginated list of all global variables in your workspace.\n\n**Response `data`** is an array of variable objects. Each item includes `name`, `dataType`, `value` (masked as `***` for secrets), `isSecret`, `canReset`, `checksum`, `createdAt`, `updatedAt`.\n\nPagination fields are returned at the top level: `pageNo`, `pageSize`, `totalCount`, `totalPages`.\n\n**Canonical response file:** `Get/GET_ALL.json`","parameters":[{"name":"Nected-Branch","in":"header","required":false,"description":"Branch name (optional)","schema":{"type":"string"}},{"name":"pageNo","in":"query","description":"Page number (1-based)","schema":{"type":"integer","default":1}},{"name":"pageSize","in":"query","description":"Items per page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"OK — paginated list of global variables","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListVariablesResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

### Example response (full JSON)

```
{
  "data": [
    {
      "name": "tax_rate_gst",
      "dataType": "numeric",
      "value": 18,
      "isSecret": false,
      "canReset": true,
      "checksum": "a3f1b2c4d5e6f7a8b9c0d1e2f3a4b5c6",
      "createdAt": "2026-01-10T10:00:00.000Z",
      "updatedAt": "2026-04-22T08:30:00.000Z"
    },
    {
      "name": "payment_gateway_url",
      "dataType": "string",
      "value": "https://gateway.example.com/v2/charge",
      "isSecret": false,
      "canReset": false,
      "checksum": "b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e6",
      "createdAt": "2026-02-05T14:20:00.000Z",
      "updatedAt": "2026-02-05T14:20:00.000Z"
    },
    {
      "name": "smtp_api_key",
      "dataType": "string",
      "value": "***",
      "isSecret": true,
      "canReset": false,
      "checksum": "c9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4",
      "createdAt": "2026-03-18T09:15:00.000Z",
      "updatedAt": "2026-05-01T11:00:00.000Z"
    },
    {
      "name": "feature_flag_kyc",
      "dataType": "boolean",
      "value": true,
      "isSecret": false,
      "canReset": true,
      "checksum": "d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7",
      "createdAt": "2026-04-01T07:45:00.000Z",
      "updatedAt": "2026-05-20T16:00:00.000Z"
    }
  ],
  "code": "success",
  "message": "Success.",
  "pageNo": 1,
  "pageSize": 10,
  "totalCount": 4,
  "totalPages": 1
}

```

Use the API reference below to try the endpoint.