> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/release-notes/cloudeka-api/deka-claw/list-instances.md).

# List instances

Get a paginated list of instances for a project.

```json
{"openapi":"3.1.1","info":{"title":"Service Portal Cloudeka - API Documentation","version":"1.0.0"},"tags":[{"name":"Deka Claw","description":"API endpoints for Deka Claw (base: /core/dekaclaw)"}],"servers":[{"url":"https://ai.cloudeka.id/"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"description":"Type 'Bearer ' followed by your JWT token. Example: \"Bearer eyJhbGciOi...\"","type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ai_dekaclaw__response.Result":{"type":"object","properties":{"data":{},"message":{"type":"string"},"status":{"type":"boolean"}}},"ai_dekaclaw__response.ResError":{"type":"object","properties":{"errors":{},"message":{"type":"string"},"status":{"type":"boolean"}}}}},"paths":{"/core/dekaclaw/instances":{"get":{"description":"Get a paginated list of instances for a project.","tags":["Deka Claw","Instance"],"summary":"List instances","parameters":[{"schema":{"type":"boolean"},"name":"count_agent","in":"query"},{"schema":{"type":"integer"},"name":"limit","in":"query"},{"schema":{"type":"boolean"},"name":"load_openstack_state","in":"query"},{"schema":{"type":"integer"},"name":"page","in":"query"},{"schema":{"type":"string"},"name":"project_id","in":"query","required":true},{"schema":{"type":"string"},"name":"search","in":"query"}],"responses":{"200":{"description":"Instances retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ai_dekaclaw__response.Result"}}}},"400":{"description":"Invalid request or failed to retrieve instances","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ai_dekaclaw__response.ResError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}}}
```
