> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/api-reference/akash-akt/rest-api/akash-deployments.md).

# /akash/deployment/v1beta4/deployments/list - Akash

Example code for the akash/deployment/v1beta4/deployments/list REST method. Complete guide on how to use akash/deployment/v1beta4/deployments/list REST method in GetBlock Web3 documentation.

Returns Akash deployments, filterable by owner and state. A deployment is a user's request for cloud compute resources, described by a manifest and funded via escrow.

## Endpoint

```
GET /akash/deployment/v1beta4/deployments/list
```

## Query Parameters

| Parameter        | Type   | Description                       |
| ---------------- | ------ | --------------------------------- |
| filters.owner    | string | Filter by owner address (akash1…) |
| filters.state    | string | active or closed                  |
| pagination.limit | string | Max results                       |

## Example

{% code overflow="wrap" %}

```bash
export AKASH_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

curl "${AKASH_REST}akash/deployment/v1beta4/deployments/list?pagination.limit=1"
```

{% endcode %}

## Response

```json
{
    "deployments": [
        {
            "deployment": {
                "id": {
                    "owner": "akash100dwtg4hqnd240x583spjwnk4kanp559xwtvmg",
                    "dseq": "16122570"
                },
                "state": "active",
                "hash": "bLTCo5xFV2obtovLJ/rUZDHLkzAbB8vlXpF2iJGKpaY=",
                "created_at": "16122572",
                "reclamation": null
            },
            "groups": [
                {
                    "id": {
                        "owner": "akash100dwtg4hqnd240x583spjwnk4kanp559xwtvmg",
                        "dseq": "16122570",
                        "gseq": 1
                    },
                    "state": "open",
                    "group_spec": {
                        "name": "dcloud",
                        "requirements": {
                            "signed_by": {
                                "all_of": [],
                                "any_of": []
                            },
                            "attributes": []
                        },
                        "resources": [
                            {
                                "resource": {
                                    "id": 1,
                                    "cpu": {
                                        "units": {
                                            "val": "500"
                                        },
                                        "attributes": []
                                    },
                                    "memory": {
                                        "quantity": {
                                            "val": "536870912"
                                        },
                                        "attributes": []
                                    },
                                    "storage": [
                                        {
                                            "name": "default",
                                            "quantity": {
                                                "val": "536870912"
                                            },
                                            "attributes": []
                                        }
                                    ],
                                    "gpu": {
                                        "units": {
                                            "val": "0"
                                        },
                                        "attributes": []
                                    },
                                    "endpoints": [
                                        {
                                            "kind": "SHARED_HTTP",
                                            "sequence_number": 0
                                        }
                                    ]
                                },
                                "count": 1,
                                "price": {
                                    "denom": "uact",
                                    "amount": "584.635140000000000000"
                                }
                            }
                        ]
                    },
                    "created_at": "16122572"
                }
            ],
            "escrow_account": {
                "id": {
                    "scope": "deployment",
                    "xid": "akash100dwtg4hqnd240x583spjwnk4kanp559xwtvmg/16122570"
                },
                "state": {
                    "owner": "akash100dwtg4hqnd240x583spjwnk4kanp559xwtvmg",
                    "state": "open",
                    "transferred": [
                        {
                            "denom": "uakt",
                            "amount": "0.000000000000000000"
                        }
                    ],
                    "settled_at": "16122572",
                    "funds": [
                        {
                            "denom": "uact",
                            "amount": "292317.570000000000000000"
                        }
                    ],
                    "deposits": [
                        {
                            "owner": "akash100dwtg4hqnd240x583spjwnk4kanp559xwtvmg",
                            "height": "0",
                            "source": "balance",
                            "balance": {
                                "denom": "uact",
                                "amount": "292317.570000000000000000"
                            }
                        }
                    ]
                }
            }
        }
    ],
    "pagination": {
        "next_key": "AehMrwIBAgEBNWFrYXNoMTAwd3RkMm5yeXVsZjJsZDVyYW1sajRhY2ZhanNubXAybnlha3dyAAAAAAAAZ5mk",
        "total": "1"
    }
}
```

## Response Fields

| Field                                    | Type   | Description                                    |
| ---------------------------------------- | ------ | ---------------------------------------------- |
| deployments                              | array  | Deployments with id, state, and escrow account |
| deployments\[].deployment.deployment\_id | object | Owner + dseq identifying the deployment        |
| deployments\[].escrow\_account           | object | Escrow balance funding the deployment          |

## Use Cases

* **Marketplace UIs**: List a user's deployments
* **Monitoring**: Track active deployments and escrow
* **Indexing**: Ingest deployment state

## Error Handling

| Error                     | Message       | Description                                       |
| ------------------------- | ------------- | ------------------------------------------------- |
| 400 / Bad request         | Bad request   | A parameter was invalid                           |
| 403 / RBAC: access denied | Access denied | The GetBlock access token is missing or incorrect |
