# Query Reference
Source: https://docs.chain.link/cre/reference/graphql-api/queries
Last Updated: 2026-08-31

> For the complete documentation index, see [llms.txt](/llms.txt).

This page documents every query on the CRE GraphQL API's root `Query` type that reads workflow, deployment, execution, account, or organization data.

> **NOTE: Other queries in the schema**
>
> The schema also exposes queries for organization member management (`listOrganizationMembers`), API key management
> (`verifyApiKey`, `listApiKeys`), wallet-key linking (`listWorkflowOwners`), billing (`getWorkflowResourceConsumption`,
> `getAggregatedWorkflowResourceConsumption`), and offchain-workflow management (`getOffchainWorkflowById` and related
> queries). Those aren't covered here — this page focuses on reading workflow and execution data.

## `getAccountDetails`

Retrieves the account associated with the current API key or session.

Use this to confirm which account you're authenticated as, or to display account information in your application.

### Arguments

None.

### Returns

```text
OrganizationAccount
```

Nullable. See [`OrganizationAccount`](/cre/reference/graphql-api/objects#organizationaccount).

### Example

```graphql
query {
  getAccountDetails {
    memberId
    displayName
    emailAddress
    organizationId
  }
}
```

### Response

```json
{
  "data": {
    "getAccountDetails": {
      "memberId": "<MEMBER_ID>",
      "displayName": "Jane Doe",
      "emailAddress": "jane.doe@example.com",
      "organizationId": "<ORGANIZATION_ID>"
    }
  }
}
```

### Related

- [Common Queries: Get your account details](/cre/reference/graphql-api/common-queries#get-your-account-details)
- [`OrganizationAccount`](/cre/reference/graphql-api/objects#organizationaccount)

***

## `getOrganization`

Retrieves the organization the current account belongs to.

### Arguments

None.

### Returns

```text
Organization
```

Nullable. See [`Organization`](/cre/reference/graphql-api/objects#organization).

### Example

```graphql
query {
  getOrganization {
    organizationId
    displayName
    restrictionStatus
    activeStatus
  }
}
```

### Response

```json
{
  "data": {
    "getOrganization": {
      "organizationId": "<ORGANIZATION_ID>",
      "displayName": "Acme Corp",
      "restrictionStatus": "FULL_ACCESS",
      "activeStatus": "ACTIVE"
    }
  }
}
```

### Related

- [Common Queries: Get your organization details](/cre/reference/graphql-api/common-queries#get-your-organization-details)
- [`Organization`](/cre/reference/graphql-api/objects#organization)

***

## `getTenantConfig`

Retrieves tenant configuration for the authenticated user: available workflow registries, deployment forwarders, and the vault gateway URL. This is the same data the CRE CLI caches locally as `~/.cre/context.yaml` after login.

Requires an authenticated request (`@isAuthenticated`).

### Arguments

None.

### Returns

```text
TenantConfig!
```

Non-nullable. See [`TenantConfig`](/cre/reference/graphql-api/objects#tenantconfig).

### Example

```graphql
query {
  getTenantConfig {
    tenantId
    defaultDonFamily
    vaultGatewayUrl
    registries {
      id
      label
      type
    }
  }
}
```

### Response

```json
{
  "data": {
    "getTenantConfig": {
      "tenantId": "<TENANT_ID>",
      "defaultDonFamily": "zone-a",
      "vaultGatewayUrl": "https://01.gateway.zone-a.cre.chain.link",
      "registries": [
        { "id": "onchain:ethereum-mainnet", "label": "ethereum-mainnet (0x1234...abcd)", "type": "ON_CHAIN" }
      ]
    }
  }
}
```

### Related

- [`TenantConfig`](/cre/reference/graphql-api/objects#tenantconfig)
- [CLI: Tenant context cache](/cre/reference/cli/authentication#tenant-context-cache)

***

## `workflow`

Retrieves a single workflow by its `uuid`.

Use this to display detailed workflow metadata, or to check a workflow's current deployment status and aggregate execution counts.

### Arguments

| Argument | Type             | Required | Description                                                                                                                 |
| -------- | ---------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `input`  | `WorkflowInput!` | Yes      | Identifies the workflow and the aggregation window. See [`WorkflowInput`](/cre/reference/graphql-api/inputs#workflowinput). |

`WorkflowInput` fields:

| Field  | Type      | Required | Description                                                                                                                          |
| ------ | --------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `uuid` | `String!` | Yes      | The workflow's unique identifier (CRE-generated, distinct from the onchain `workflowId`).                                            |
| `from` | `Time!`   | Yes      | Start of the time window used to compute the workflow's aggregate fields (`executionCount`, `executionCountByStatus`, `creditUsed`). |

### Returns

```text
WorkflowOutput!
```

Non-nullable wrapper. See [`WorkflowOutput`](/cre/reference/graphql-api/objects#workflowoutput) and [`Workflow`](/cre/reference/graphql-api/objects#workflow).

### Example

```graphql
query GetWorkflow($uuid: String!, $from: Time!) {
  workflow(input: { uuid: $uuid, from: $from }) {
    data {
      uuid
      name
      status
      executionCount
    }
  }
}
```

### Variables

```json
{
  "uuid": "<WORKFLOW_UUID>",
  "from": "2026-08-01T00:00:00Z"
}
```

### Response

```json
{
  "data": {
    "workflow": {
      "data": {
        "uuid": "<WORKFLOW_UUID>",
        "name": "price-feed-monitor",
        "status": "ACTIVE",
        "executionCount": 482
      }
    }
  }
}
```

### Related

- [Common Queries: Get a workflow](/cre/reference/graphql-api/common-queries#get-a-workflow)
- [`workflows`](#workflows)
- [`Workflow`](/cre/reference/graphql-api/objects#workflow)

***

## `workflows`

Retrieves a paginated list of workflows for your organization, with optional filtering by owner address, status, and a text search on name.

Use this to display a workflow inventory, or to discover a workflow's `uuid` for use with other queries.

### Arguments

| Argument | Type              | Required | Description                                                                                                    |
| -------- | ----------------- | -------- | -------------------------------------------------------------------------------------------------------------- |
| `input`  | `WorkflowsInput!` | Yes      | Filters, sort order, and pagination. See [`WorkflowsInput`](/cre/reference/graphql-api/inputs#workflowsinput). |

`WorkflowsInput` fields:

| Field                  | Type                          | Required | Description                                                                                                                                                |
| ---------------------- | ----------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workflowOwnerAddress` | `[OnchainAddress!]`           | No       | Restrict results to workflows owned by one or more addresses (max 100).                                                                                    |
| `status`               | `[WorkflowDeploymentStatus!]` | No       | Restrict results to one or more deployment statuses (max 10). See [`WorkflowDeploymentStatus`](/cre/reference/graphql-api/enums#workflowdeploymentstatus). |
| `search`               | `String`                      | No       | Case-insensitive text search on workflow name.                                                                                                             |
| `orderBy`              | `WorkflowOrderBy`             | No       | Sort field and direction. See [`WorkflowOrderBy`](/cre/reference/graphql-api/inputs#workfloworderby).                                                      |
| `page`                 | `Page`                        | No       | Page number and size. Defaults to page `0`, size `10`. See [Pagination](/cre/reference/graphql-api/pagination).                                            |

### Returns

```text
WorkflowsOutput!
```

Non-nullable. See [`WorkflowsOutput`](/cre/reference/graphql-api/objects#workflowsoutput). `data` is the page of results; `count` is the total number of matching workflows across all pages.

### Example

```graphql
query ListWorkflows($status: [WorkflowDeploymentStatus!], $page: Page) {
  workflows(input: { status: $status, page: $page }) {
    data {
      uuid
      name
      status
    }
    count
  }
}
```

### Variables

```json
{
  "status": ["ACTIVE"],
  "page": { "number": 0, "size": 20 }
}
```

### Response

```json
{
  "data": {
    "workflows": {
      "data": [{ "uuid": "<WORKFLOW_UUID>", "name": "price-feed-monitor", "status": "ACTIVE" }],
      "count": 1
    }
  }
}
```

### Related

- [Common Queries: List workflows](/cre/reference/graphql-api/common-queries#list-workflows)
- [`workflow`](#workflow)
- [Pagination](/cre/reference/graphql-api/pagination)

***

## `workflowActivity`

Retrieves success/failure execution counts bucketed over a time range, for one workflow or across your organization.

Use this to build health charts or monitoring dashboards.

### Arguments

| Argument | Type                     | Required | Description                                                                             |
| -------- | ------------------------ | -------- | --------------------------------------------------------------------------------------- |
| `input`  | `WorkflowActivityInput!` | Yes      | See [`WorkflowActivityInput`](/cre/reference/graphql-api/inputs#workflowactivityinput). |

`WorkflowActivityInput` fields:

| Field          | Type     | Required | Description                                                                |
| -------------- | -------- | -------- | -------------------------------------------------------------------------- |
| `workflowUUID` | `String` | No       | Restrict to a single workflow. Omit to aggregate across your organization. |
| `from`         | `Time`   | No       | Start of the time range.                                                   |
| `to`           | `Time`   | No       | End of the time range.                                                     |

### Returns

```text
WorkflowActivityOutput!
```

Non-nullable. See [`WorkflowActivityOutput`](/cre/reference/graphql-api/objects#workflowactivityoutput).

### Example

```graphql
query WorkflowActivity($workflowUUID: String, $from: Time, $to: Time) {
  workflowActivity(input: { workflowUUID: $workflowUUID, from: $from, to: $to }) {
    data {
      from
      to
      successCount
      failureCount
    }
  }
}
```

### Variables

```json
{
  "workflowUUID": "<WORKFLOW_UUID>",
  "from": "2026-08-24T00:00:00Z",
  "to": "2026-08-31T00:00:00Z"
}
```

### Response

```json
{
  "data": {
    "workflowActivity": {
      "data": [{ "from": "2026-08-24T00:00:00Z", "to": "2026-08-25T00:00:00Z", "successCount": 68, "failureCount": 1 }]
    }
  }
}
```

### Related

- [Common Queries: Get workflow activity over time](/cre/reference/graphql-api/common-queries#get-workflow-activity-over-time)
- [`WorkflowActivityRow`](/cre/reference/graphql-api/objects#workflowactivityrow)

***

## `workflowDeployments`

Retrieves a paginated list of deployments for a workflow.

### Arguments

| Argument | Type                        | Required | Description                                                                                   |
| -------- | --------------------------- | -------- | --------------------------------------------------------------------------------------------- |
| `input`  | `WorkflowDeploymentsInput!` | Yes      | See [`WorkflowDeploymentsInput`](/cre/reference/graphql-api/inputs#workflowdeploymentsinput). |

`WorkflowDeploymentsInput` fields:

| Field          | Type                          | Required | Description                                                                                                               |
| -------------- | ----------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `workflowUUID` | `String!`                     | Yes      | The workflow whose deployments should be returned.                                                                        |
| `status`       | `[WorkflowDeploymentStatus!]` | No       | Restrict results to one or more deployment statuses (max 10).                                                             |
| `from`         | `Time`                        | No       | Only include deployments created on or after this time.                                                                   |
| `to`           | `Time`                        | No       | Only include deployments created on or before this time.                                                                  |
| `search`       | `String`                      | No       | Text search filter.                                                                                                       |
| `orderBy`      | `WorkflowDeploymentOrderBy`   | No       | Sort field and direction. See [`WorkflowDeploymentOrderBy`](/cre/reference/graphql-api/inputs#workflowdeploymentorderby). |
| `page`         | `Page`                        | No       | Page number and size.                                                                                                     |

### Returns

```text
WorkflowDeploymentsOutput!
```

Non-nullable. See [`WorkflowDeploymentsOutput`](/cre/reference/graphql-api/objects#workflowdeploymentsoutput).

### Example

```graphql
query WorkflowDeployments($workflowUUID: String!, $page: Page) {
  workflowDeployments(input: { workflowUUID: $workflowUUID, page: $page }) {
    data {
      uuid
      status
      deployedAt
    }
    count
  }
}
```

### Variables

```json
{
  "workflowUUID": "<WORKFLOW_UUID>",
  "page": { "number": 0, "size": 10 }
}
```

### Response

```json
{
  "data": {
    "workflowDeployments": {
      "data": [{ "uuid": "<DEPLOYMENT_UUID>", "status": "ACTIVE", "deployedAt": "2026-06-01T12:00:00Z" }],
      "count": 1
    }
  }
}
```

### Related

- [Common Queries: List deployments for a workflow](/cre/reference/graphql-api/common-queries#list-deployments-for-a-workflow)
- [`workflowDeployment`](#workflowdeployment)

***

## `workflowDeployment`

Retrieves a single deployment by its `uuid`.

### Arguments

| Argument | Type                       | Required | Description                                               |
| -------- | -------------------------- | -------- | --------------------------------------------------------- |
| `input`  | `WorkflowDeploymentInput!` | Yes      | `{ uuid: String! }` — the deployment's unique identifier. |

### Returns

```text
WorkflowDeploymentOutput!
```

Non-nullable. See [`WorkflowDeploymentOutput`](/cre/reference/graphql-api/objects#workflowdeploymentoutput).

### Example

```graphql
query WorkflowDeployment($uuid: String!) {
  workflowDeployment(input: { uuid: $uuid }) {
    data {
      uuid
      status
      binaryURL
      configURL
    }
  }
}
```

### Variables

```json
{
  "uuid": "<DEPLOYMENT_UUID>"
}
```

### Response

```json
{
  "data": {
    "workflowDeployment": {
      "data": {
        "uuid": "<DEPLOYMENT_UUID>",
        "status": "ACTIVE",
        "binaryURL": "https://.../binary.wasm",
        "configURL": "https://.../config.json"
      }
    }
  }
}
```

### Related

- [Common Queries: Get a deployment](/cre/reference/graphql-api/common-queries#get-a-deployment)
- [`workflowDeployments`](#workflowdeployments)

***

## `workflowExecutions`

Retrieves a paginated list of executions, filterable by workflow, status, and time range.

Use this to build execution history views, monitor workflow health, or export execution data incrementally.

### Arguments

| Argument | Type                       | Required | Description                                                                                 |
| -------- | -------------------------- | -------- | ------------------------------------------------------------------------------------------- |
| `input`  | `WorkflowExecutionsInput!` | Yes      | See [`WorkflowExecutionsInput`](/cre/reference/graphql-api/inputs#workflowexecutionsinput). |

`WorkflowExecutionsInput` fields:

| Field          | Type                         | Required | Description                                                                                                                                             |
| -------------- | ---------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `workflowUuid` | `String`                     | No       | Restrict to a single workflow. Omit to list executions across your organization.                                                                        |
| `status`       | `[WorkflowExecutionStatus!]` | No       | Restrict results to one or more execution statuses (max 10). See [`WorkflowExecutionStatus`](/cre/reference/graphql-api/enums#workflowexecutionstatus). |
| `search`       | `String`                     | No       | Text search filter.                                                                                                                                     |
| `from`         | `Time`                       | No       | Only include executions started on or after this time.                                                                                                  |
| `to`           | `Time`                       | No       | Only include executions started on or before this time.                                                                                                 |
| `orderBy`      | `WorkflowExecutionOrderBy`   | No       | Sort field and direction. See [`WorkflowExecutionOrderBy`](/cre/reference/graphql-api/inputs#workflowexecutionorderby).                                 |
| `page`         | `Page`                       | No       | Page number and size.                                                                                                                                   |

### Returns

```text
WorkflowExecutionsOutput!
```

Non-nullable. See [`WorkflowExecutionsOutput`](/cre/reference/graphql-api/objects#workflowexecutionsoutput).

### Example

```graphql
query WorkflowExecutions($workflowUuid: String, $status: [WorkflowExecutionStatus!], $page: Page) {
  workflowExecutions(input: { workflowUuid: $workflowUuid, status: $status, page: $page }) {
    data {
      uuid
      status
      startedAt
      finishedAt
    }
    count
  }
}
```

### Variables

```json
{
  "workflowUuid": "<WORKFLOW_UUID>",
  "status": ["FAILURE"],
  "page": { "number": 0, "size": 10 }
}
```

### Response

```json
{
  "data": {
    "workflowExecutions": {
      "data": [
        {
          "uuid": "<EXECUTION_UUID>",
          "status": "FAILURE",
          "startedAt": "2026-08-31T09:12:00Z",
          "finishedAt": "2026-08-31T09:12:05Z"
        }
      ],
      "count": 1
    }
  }
}
```

### Related

- [Common Queries: List recent workflow executions](/cre/reference/graphql-api/common-queries#list-recent-workflow-executions)
- [Common Queries: Find failed executions](/cre/reference/graphql-api/common-queries#find-failed-executions)
- [`workflowExecution`](#workflowexecution)
- [Pagination](/cre/reference/graphql-api/pagination)

***

## `workflowExecution`

Retrieves a single execution by its `uuid`.

### Arguments

| Argument | Type                      | Required | Description                                              |
| -------- | ------------------------- | -------- | -------------------------------------------------------- |
| `input`  | `WorkflowExecutionInput!` | Yes      | `{ uuid: String! }` — the execution's unique identifier. |

### Returns

```text
WorkflowExecutionOutput!
```

Non-nullable wrapper. `data: WorkflowExecution` is nullable — it's `null` if no execution matches the given `uuid`. See [`WorkflowExecutionOutput`](/cre/reference/graphql-api/objects#workflowexecutionoutput).

### Example

```graphql
query GetExecution($uuid: String!) {
  workflowExecution(input: { uuid: $uuid }) {
    data {
      uuid
      status
      startedAt
      finishedAt
      errors {
        error
        count
      }
    }
  }
}
```

### Variables

```json
{
  "uuid": "<EXECUTION_UUID>"
}
```

### Response

```json
{
  "data": {
    "workflowExecution": {
      "data": {
        "uuid": "<EXECUTION_UUID>",
        "status": "SUCCESS",
        "startedAt": "2026-08-31T11:45:00Z",
        "finishedAt": "2026-08-31T11:45:02Z",
        "errors": null
      }
    }
  }
}
```

### Related

- [Common Queries: Get a single execution](/cre/reference/graphql-api/common-queries#get-a-single-execution)
- [`workflowExecutions`](#workflowexecutions)

***

## `workflowExecutionLogs`

Retrieves the log lines emitted during an execution.

### Arguments

| Argument | Type                          | Required | Description                                                                         |
| -------- | ----------------------------- | -------- | ----------------------------------------------------------------------------------- |
| `input`  | `WorkflowExecutionLogsInput!` | Yes      | `{ workflowExecutionUUID: String! }` — the execution whose logs should be returned. |

### Returns

```text
WorkflowExecutionLogsOutput!
```

Non-nullable wrapper; `data` is a nullable list. See [`WorkflowExecutionLogsOutput`](/cre/reference/graphql-api/objects#workflowexecutionlogsoutput).

### Example

```graphql
query ExecutionLogs($workflowExecutionUUID: String!) {
  workflowExecutionLogs(input: { workflowExecutionUUID: $workflowExecutionUUID }) {
    data {
      nodeID
      message
      timestamp
    }
  }
}
```

### Variables

```json
{
  "workflowExecutionUUID": "<EXECUTION_UUID>"
}
```

### Response

```json
{
  "data": {
    "workflowExecutionLogs": {
      "data": [{ "nodeID": "<NODE_ID>", "message": "execution completed", "timestamp": "2026-08-31T11:45:02Z" }]
    }
  }
}
```

### Related

- [Common Queries: Get execution logs](/cre/reference/graphql-api/common-queries#get-execution-logs)
- [`WorkflowExecutionLog`](/cre/reference/graphql-api/objects#workflowexecutionlog)

***

## `workflowExecutionEvents`

Retrieves the per-capability event timeline for an execution, optionally filtered by capability ID or status.

### Arguments

| Argument | Type                            | Required | Description                                                                                           |
| -------- | ------------------------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| `input`  | `WorkflowExecutionEventsInput!` | Yes      | See [`WorkflowExecutionEventsInput`](/cre/reference/graphql-api/inputs#workflowexecutioneventsinput). |

`WorkflowExecutionEventsInput` fields:

| Field                   | Type      | Required | Description                                       |
| ----------------------- | --------- | -------- | ------------------------------------------------- |
| `workflowExecutionUUID` | `String!` | Yes      | The execution whose events should be returned.    |
| `capabilityID`          | `String`  | No       | Restrict results to a single capability.          |
| `status`                | `String`  | No       | Restrict results to a single event status string. |

### Returns

```text
WorkflowExecutionEventsOutput!
```

Non-nullable wrapper; `data` is a nullable list. See [`WorkflowExecutionEventsOutput`](/cre/reference/graphql-api/objects#workflowexecutioneventsoutput).

### Example

```graphql
query ExecutionEvents($workflowExecutionUUID: String!) {
  workflowExecutionEvents(input: { workflowExecutionUUID: $workflowExecutionUUID }) {
    data {
      capabilityID
      status
      startedAt
      finishedAt
    }
  }
}
```

### Variables

```json
{
  "workflowExecutionUUID": "<EXECUTION_UUID>"
}
```

### Response

```json
{
  "data": {
    "workflowExecutionEvents": {
      "data": [
        {
          "capabilityID": "http-trigger@1.0.0",
          "status": "COMPLETED",
          "startedAt": "2026-08-31T11:45:00Z",
          "finishedAt": "2026-08-31T11:45:01Z"
        }
      ]
    }
  }
}
```

### Related

- [Common Queries: Get the capability event timeline for an execution](/cre/reference/graphql-api/common-queries#get-the-capability-event-timeline-for-an-execution)
- [`WorkflowExecutionEvent`](/cre/reference/graphql-api/objects#workflowexecutionevent)