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

# Versions

## Retrieve available releases

> Returns a list of accessible releases. Each entry includes the version name, public release date and system model.

```json
{"openapi":"3.1.0","info":{"title":"ecoQuery User API","version":"0.0.1"},"servers":[{"url":"https://api.ecoinvent.org"}],"security":[{"OAuth2ClientCredentials":[]},{"OAuth2PasswordBearer":[]}],"components":{"securitySchemes":{"OAuth2ClientCredentials":{"type":"oauth2","flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://sso.ecoinvent.org/realms/ecoinvent/protocol/openid-connect/token"}}},"OAuth2PasswordBearer":{"type":"oauth2","flows":{"password":{"scopes":{},"tokenUrl":"https://sso.ecoinvent.org/realms/ecoinvent/protocol/openid-connect/token"}}}},"schemas":{"EnrichedVersionsResponse":{"properties":{"total":{"type":"integer","title":"Total","description":"Total number of accessible releases"},"results":{"items":{"$ref":"#/components/schemas/VersionEntry"},"type":"array","title":"Results"}},"type":"object","required":["total"],"title":"EnrichedVersionsResponse"},"VersionEntry":{"properties":{"version":{"type":"string","title":"Version","description":"Version name, e.g. '3.12'"},"release_date":{"type":"string","format":"date","title":"Release Date","description":"Public release date for the version"},"system_model":{"type":"string","title":"System Model","description":"System model shortname, e.g. 'cutoff'"}},"type":"object","required":["version","release_date","system_model"],"title":"VersionEntry"}}},"paths":{"/v3/api1/versions":{"get":{"tags":["api"],"summary":"Retrieve available releases","description":"Returns a list of accessible releases. Each entry includes the version name, public release date and system model.","operationId":"get_versions_v3_v3_api1_versions_get","responses":{"200":{"description":"Successful response with available releases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrichedVersionsResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{}}},"403":{"description":"Forbidden","content":{"application/json":{}}},"404":{"description":"Requested resource not found","content":{"application/json":{}}},"500":{"description":"Internal Server Error","content":{"application/json":{}}}}}}}}
```