> For the complete documentation index, see [llms.txt](https://legacy-docs.aragon.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://legacy-docs.aragon.org/developers/products/aragon-govern/aragon-govern-1/developers/graphql-api.md).

# GraphQL API

{% hint style="info" %}
Govern Server is exposing a GraphQL API that lets you fetch data related to your Govern DAOs. Here is the complete list of queries and types that are available.
{% endhint %}

## Queries

### `dao(name: String!): Dao`

Use this query to get a single DAO, using its name. See the `Dao` type to know more information.

### `daos: [Dao]`

Use this query to get the list of DAOs.

## Types

### GovernRegistry

Represents the DAO registry. It contains `entries`, which have a name and contain a `queue` and an `executor`. A DAO is identified by its name.

```graphql
type GovernRegistry {
  id: ID!
  address: String!
  count: Int!
  entries: [RegistryEntry!]!
}
```

### RegistryEntry

A single registry entry. It has a `name`, a `queue` and an `executor`. A DAO is identified by its name.

```graphql
type RegistryEntry {
  id: ID!
  name: String!
  queue: GovernQueue!
  executor: Dao!
}
```

### Dao

A single DAO entry.

```graphql
type Dao {
  id: ID!
  address: String!
  metadata: String
  registryEntries: [RegistryEntry!]!
  containers: [Container]!
  roles: [Role!]!
  queues: [GovernQueue]!
}
```

### GovernQueue

Represents a queue of scheduled actions (`Container`) and a configuration.

```graphql
type GovernQueue {
  id: ID!
  address: String!
  config: Config!
  registryEntries: [RegistryEntry!]!
  queued: [Container!]!
  roles: [Role!]!
}
```

### Config

The configuration of a `GovernQueue`.

```graphql
type Config {
graph  id: ID!
  queue: GovernQueue!
  executionDelay: String!
  scheduleDeposit: Collateral!
  challengeDeposit: Collateral!
  resolver: String!
  rules: String!
}
```

### Container

A `Container` represents an action being scheduled for execution, inside a `GovernQueue`. It also contains the configuration at the time it was scheduled, and a history of past events.

```graphql
type Container {
  id: ID!
  queue: GovernQueue!
  state: ContainerState!
  config: Config!
  payload: ContainerPayload!
  history: [ContainerEvent!]!
}
```

### ContainerState

The different states of a `Container`.

```graphql
enum ContainerState {
  None
  Scheduled
  Approved
  Challenged
  Rejected
  Cancelled
  Executed
}
```

### ContainerPayload

A list of actual actions attached to a `Container`.

```graphql
type ContainerPayload {
  id: ID!
  container: Container!
  nonce: String!
  executionTime: String!
  submitter: String!
  executor: Dao!
  actions: [Action!]!
  allowFailuresMap: String!
  proof: String!
}
```

### Action

Represents an independent action (transaction data) in a `ContainerPayload`.

```graphql
type Action {
  id: ID!
  payload: ContainerPayload!
  to: String!
  value: String!
  data: String!
}
```

### Collateral

Represents a collateral that gets attached to a `Container` when scheduling it and challenging it.

Scenario 1:

* Bob submits an action to be executed, with a collateral attached to it.
* The action passes and doesn’t get challenged.
* The action gets executed and Bob receives its collateral back.

Scenario 2:

* Bob submits an action to be executed, with a collateral attached to it.
* The action passes but gets challenged by Alice, with a collateral attached.
* The arbitrator approves the action. Bob Receives both collaterals.

Scenario 3:

* Bob submits an action to be executed, with a collateral attached to it.
* The action passes but gets challenged by Alice, with a collateral attached.
* The arbitrator rejects the action. Alice Receives both collaterals.

```graphql
type Collateral {
  id: ID!
  token: String!
  amount: String!
}
```

### Role

The roles defined on a given `GovernQueue`.

```graphql
type Role {
  id: ID!
  entity: String!
  selector: String!
  who: String!
  granted: Boolean!
  frozen: Boolean!
}
```

### ContainerEventChallenge

A `Container` event representing an action being challenged.

```
type ContainerEventChallenge {
  id: ID!
  container: Container!
  createdAt: String!
  actor: String!
  collateral: Collateral!
  disputeId: String!
  reason: String!
  resolver: String!
}
```

### ContainerEventExecute

A `Container` event representing an action being executed.

```graphql
type ContainerEventExecute {
  id: ID!
  container: Container!
  createdAt: String!
  execResults: [String!]!
}
```

### ContainerEventResolve

A `Container` event representing an action being resolved.

```graphql
type ContainerEventResolve {
  id: ID!
  container: Container!
  createdAt: String!
  approved: Boolean!
}
```

### ContainerEventRule

A `Container` event representing an action being ruled.

```graphql
type ContainerEventRule {
  id: ID!
  container: Container!
  createdAt: String!
  ruling: String!
}
```

### ContainerEventSchedule

A `Container` event representing an action being scheduled.

```graphql
type ContainerEventSchedule {
  id: ID!
  container: Container!
  createdAt: String!
  collateral: Collateral!
}
```

### ContainerEventSubmitEvidence

A `Container` event representing an evidence being submitted.

```graphql
type ContainerEventSubmitEvidence {
  id: ID!
  container: Container!
  createdAt: String!
  evidence: String!
  submitter: String!
  finished: Boolean!
}
```

### ContainerEventVeto

A `Container` event representing an action being vetoed by the arbitrator.

```graphql
type ContainerEventVeto {
  id: ID!
  container: Container!
  createdAt: String!
  reason: String!
}
```