> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Projects

> Retrieves all projects that the authenticated user has access to. Projects are automatically filtered based on user permissions.

## Endpoint

```
GET /apiops/projects/
```

## Authentication

Requires a Personal API Access Token.

### Header

```
Authorization: Bearer YOUR_TOKEN
```

## Request

### Headers

| Header        | Value          | Required |
| ------------- | -------------- | -------- |
| Authorization | Bearer {token} | Yes      |

### Path Parameters

None

### Query Parameters

None

## Response

### Success Response (200 OK)

```json theme={null}
{
  "status": "SUCCESS",
  "resultList": [
    {
      "name": "default",
      "description": "description text"
    },
    {
      "name": "MyProject",
      "description": "My project description"
    }
  ],
  "resultCount": 2
}
```

#### Response Fields

| Field       | Type    | Description                             |
| ----------- | ------- | --------------------------------------- |
| status      | string  | Response status: `SUCCESS` or `FAILURE` |
| resultList  | array   | List of project objects                 |
| resultCount | integer | Total number of projects returned       |

#### Project Object Fields

| Field       | Type   | Description         |
| ----------- | ------ | ------------------- |
| name        | string | Project name        |
| description | string | Project description |

### EnumStatus

* `SUCCESS` - Operation successful
* `FAILURE` - Operation failed

### Error Response (401 Unauthorized)

```json theme={null}
{
  "error": "unauthorized_client",
  "error_description": "Invalid token"
}
```

#### Causes

* Missing or invalid Authorization header
* Token expired or revoked
* Invalid token format

### Error Response (500 Internal Server Error)

```json theme={null}
{
  "error": "internal_error",
  "error_description": "An unexpected error occurred"
}
```

## cURL Example

```bash theme={null}
curl -X GET \
  "https://demo.apinizer.com/apiops/projects/" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Full JSON Body Example

This endpoint does not require a request body.

## Notes and Warnings

* **Filtered Results**: Only projects where the user is a member are returned
* **Permissions**: Project access is based on user membership and roles
* **Empty List**: If the user has no projects, an empty `resultList` is returned
* **Case Sensitivity**: Project names are case-sensitive

## Related Documentation

* [Authentication Guide](/api-reference/getting-started/authentication) - How to obtain and use API tokens
* [Error Handling](/api-reference/getting-started/error-handling) - Error response formats