---
title: "Projects | Grafana Cloud documentation"
description: "Projects Legacy API Warning The Grafana Cloud k6 endpoints under this section are deprecated and planned for removal in the near future. Migrate to the latest Projects API endpoints to avoid disruptions."
---

# Projects Legacy API

> Warning
> 
> The Grafana Cloud k6 endpoints under this section are deprecated and planned for removal in the near future. Migrate to the latest [Projects API endpoints](../../projects) to avoid disruptions.

Use these endpoints to access Projects data in Grafana Cloud k6.

To learn more about Projects, refer to the [Projects documentation](../../../projects-and-users/projects/).

## List projects

Returns all projects a user is member of in the specified organization.

**GET** `https://api.k6.io/v3/organizations/{organization_id}/projects`

Expand table

| Path Parameter    | Type    | Description                                           |
|-------------------|---------|-------------------------------------------------------|
| `organization_id` | integer | A unique integer value identifying this organization. |

JSON ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```json
{
  "projects": [
    {
      "id": 47,
      "name": "my Project",
      "description": "project for load testing of my site",
      "organization_id": 1013,
      "created": "2020-08-13T18:28:45Z",
      "updated": "2020-08-13T18:28:45Z",
      "is_default": true
    }
  ]
}
```

## List projects Cloud v5

`GET https://api.k6.io/cloud/v5/projects`

Example URL with optional parameters:

`GET /cloud/v5/projects?$top=10&$skip=20&$count=true&$select=id,name,created&$orderby=created desc&$filter=contains(name,'tests')`

### Parameters

All parameters are optional.

Expand table

| Parameter  | Description                                                                                                                                                                |
|------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `$select`  | Specifies a comma-separated list of properties to include in the response.                                                                                                 |
| `$orderby` | Specifies the sorting order for the returned results. It accepts one or more comma-separated properties with an optional `asc` (ascending) or `desc` (descending) keyword. |
| `$top`     | Limits the number of items to return in the response.                                                                                                                      |
| `$skip`    | Specifies the number of items to skip in the result set before returning the remaining items. It is used for paging through a large result set.                            |
| `$count`   | Includes a count of the total number of items in the result set in the response.                                                                                           |
| `$filter`  | Filters the result set based on specified conditions.                                                                                                                      |

**Example request**:

http ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```http
GET https://api.k6.io/cloud/v5/projects?$count=true
Accept: application/json
Authorization: Token 56c166885f9a7fc1e588a1b3cb66f6dd
```

**Example response**

http ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```http
HTTP/1.1 200
Content-Type: application/json

{
  "@count": "2",
  "value": [
    {
      "created": "2023-02-21T20:29:21.741391Z",
      "description": "Default project",
      "id": 5175,
      "name": "My first project",
      "organization_id": 499,
      "updated": "2023-02-28T08:22:36.362574Z"
    },
    {
      "created": "2023-02-28T08:22:10.253310Z",
      "description": "Load tests to simulate heavy traffic",
      "id": 5276,
      "name": "Heavy tests",
      "organization_id": 499,
      "updated": "2023-02-28T08:22:47.550033Z"
    },
}
```

## Get single project by Id Cloud v5

`GET /cloud/v5/projects/:id`

### Parameters

Expand table

| Parameter | Description                                                                           |
|-----------|---------------------------------------------------------------------------------------|
| `$select` | (optional) Specifies a comma-separated list of properties to include in the response. |

**Example Request**:

http ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```http
GET https://api.k6.io/cloud/v5/projects/5175?$select=id,name,description
Accept: application/json
Authorization: Token 56c166885f9a7fc1e588a1b3cb66f6dd
```

**Example Response**:

http ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```http
HTTP/1.1 200
Content-Type: application/json

{
  "description": "Default project",
  "id": 5175,
  "name": "My first project",
}
```