---
metadata:
  - name: generator
    content: Diplodoc Platform v5.48.2
alternate:
  - https://yandex.com/dev/developer-help/doc/en/api/get-projects.md
  - https://yandex.com/dev/developer-help/doc/ru/api/get-projects.md
  - https://yandex.com/dev/developer-help/doc/tr/api/get-projects.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/developer-help/doc/en/llms.txt

# Project parameters

The request lets you get the names and IDs of all the projects created by the Developer Dashboard user.

## Request format {#request-format}

To view the parameters of all projects, use an HTTP request with the `GET` method:

```text
GET /projects
[Host](*popap): api-developer.tech.yandex.net
[X-Auth-Key](*popap_1): <your API key>
```

{% cut "Request headers" %}

**Host**

The URL of the node providing the API.

**X-Auth-Key**

Authorization key.

{% endcut %}

## Response format {#response-format}

{% list tabs %}

- The request has been completed successfully

  If the request has been completed successfully, the API returns a response with the code 200. The response body contains an object in JSON format:
  
  ```json
  {
      "projects": [
          {
              "id": "68981a83-056f-4a61-9d67-873e4e13fd2f",
              "name": "Project #1"
          },
          ...
      ]
  }
  ```
  
  #### Response properties

  #|
  || **Key** | **Value** ||
  || `projects` | An array with information about projects. ||
  || Properties of the `projects` array ||
  || `id` | Project ID. ||
  || `name` | Project name. ||
  |#

- The request has been executed with an error

  If the request has failed, the response message contains information about errors:

  #|
  || **HTTP error code** | **Error description** ||
  || `400 Bad Request` | One of the request parameters has an invalid value or data format. ||
  || `403 Forbidden` | The user or app does not have rights to access the resource; the request is rejected. ||
  || `404 Not Found` | The requested resource is not found. ||
  || `500 Internal Server Error` | Internal service error. Try resending your request later. ||
  || `503 Service Unavailable` | The API service is temporarily unavailable. ||
  |#

{% endlist %}

[*popap]:
 
The URL of the node providing the API.

[*popap_1]:
 
Authorization key.