# List DIDs

## Fetch DIDs associated with an account.

> This endpoint returns the list of DIDs controlled by the account.

```json
{"openapi":"3.0.0","info":{"title":"cheqd Studio API for cheqd network","version":"2.0.0"},"tags":[{"name":"Decentralized Identifiers (DIDs)"}],"servers":[{"url":"https://studio-api.cheqd.net","description":"Main (production) server"},{"url":"https://studio-api-staging.cheqd.net","description":"Staging server for testing"},{"url":"http://localhost:3000","description":"Local server for testing"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"ListDidResult":{"type":"object","properties":{"total":{"type":"number"},"dids":{"type":"array","items":{"type":"string"}}}},"InvalidRequest":{"description":"A problem with the input fields has occurred. Additional state information plus metadata may be available in the response body.","type":"object","properties":{"error":{"type":"string"}}},"UnauthorizedError":{"description":"Access token is missing or invalid","type":"object","properties":{"error":{"type":"string"}}},"InternalError":{"description":"An internal error has occurred. Additional state information plus metadata may be available in the response body.","type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/did/list":{"get":{"tags":["Decentralized Identifiers (DIDs)"],"summary":"Fetch DIDs associated with an account.","description":"This endpoint returns the list of DIDs controlled by the account.","parameters":[{"in":"query","name":"network","description":"Filter DID by the network published.","schema":{"type":"string","enum":["mainnet","testnet"]},"required":false},{"in":"query","name":"providerId","description":"Filter DID by the provider.","schema":{"type":"string"},"required":false},{"in":"query","name":"metadata","description":"Include metadata in response.","schema":{"type":"boolean"},"required":false},{"in":"query","name":"createdAt","description":"Filter resource by created date","schema":{"type":"string","format":"date"},"required":false},{"in":"query","name":"page","description":"Page number.","schema":{"type":"number"},"required":false},{"in":"query","name":"limit","description":"Number of items to be listed in a single page.","schema":{"type":"number"},"required":false}],"responses":{"200":{"description":"The request was successful.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListDidResult"}}}},"400":{"$ref":"#/components/schemas/InvalidRequest"},"401":{"$ref":"#/components/schemas/UnauthorizedError"},"500":{"$ref":"#/components/schemas/InternalError"}}}}}}
```