> 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 the global variables in your workspace, with optional filtering by name.\
> \
> \*\*Response \`data\`\*\* is an array of variable objects. Each item includes \`id\`, \`name\`, \`dataType\`, \`value\` (masked as \`\*\*\*\` for secrets), \`isSecret\`, \`canReset\`, \`checksum\`, \`createdAt\` and \`updatedAt\`.\
> \
> Pagination fields are returned at the top level: \`pageNo\`, \`pageSize\`, \`totalCount\`, \`totalPages\`.

```json
{"openapi":"3.0.3","info":{"title":"Nected Global Variable API (Dev V1)","version":"1.0"},"tags":[{"name":"Global Variable API","description":"The Global Variable API lets you list, create, read and update **global variables** in your workspace. Global variables are reusable, named values referenced across rules and workflows, useful for configuration values, feature flags, rate constants and secrets.\n\nAll endpoints follow the generic `/dev/v1/{entity-type}` path, with `entity-type` set to `variable`.\n\n**Supported operations:** list, create, get and update. Delete is not available in the `/dev/v1` API.\n\n**Supported `dataType` values:** `string`, `numeric`, `boolean`, `json`.\n\n**`checksum` and optimistic locking:** updating a variable requires its current `checksum` in the request body. Get it from the create response or from a get response. If it doesn't match the server's current checksum, the update is rejected.\n\n**Secret variables:** when `isSecret` is `true`, the `value` is masked as `***` in all get and list responses."}],"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":{"id":{"type":"string","description":"The variable's entity ID"},"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 and 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 to update the variable"},"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":{"type":"object","nullable":true}}}}},"paths":{"/dev/v1/variable":{"get":{"operationId":"listGlobalVariables","tags":["Global Variable API"],"summary":"List global variables","description":"Get a paginated list of the global variables in your workspace, with optional filtering by name.\n\n**Response `data`** is an array of variable objects. Each item includes `id`, `name`, `dataType`, `value` (masked as `***` for secrets), `isSecret`, `canReset`, `checksum`, `createdAt` and `updatedAt`.\n\nPagination fields are returned at the top level: `pageNo`, `pageSize`, `totalCount`, `totalPages`.","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}},{"name":"name","in":"query","description":"Filter variables by name","schema":{"type":"string"}}],"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"}}}}}}}}}
```