---
title: retrieves-a-list-of-all-the-log-drains-deprecated
product: vercel
url: /docs/rest-api/logdrains/retrieves-a-list-of-all-the-log-drains-deprecated
canonical_url: "https://vercel.com/docs/rest-api/logdrains/retrieves-a-list-of-all-the-log-drains-deprecated"
last_updated: 2026-08-18
type: reference
prerequisites:
  []
related:
  - /docs/rest-api
summary: Learn about retrieves-a-list-of-all-the-log-drains-deprecated on Vercel.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# Retrieves a list of all the Log Drains (deprecated)

```http
GET /v1/log-drains
```

Retrieves a list of all the Log Drains owned by the account. This endpoint must be called with an account AccessToken (integration OAuth2 clients are not allowed). Only log drains owned by the authenticated account can be accessed.

## Authentication

**bearerToken**: HTTP bearer

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `projectId` | string. pattern: `^[a-zA-z0-9_]+$` | No |  |
| `projectIdOrName` | string | No |  |
| `includeMetadata` | boolean. default: false | No |  |
| `teamId` | string | No | The Team identifier to perform the request on behalf of. |
| `slug` | string | No | The Team slug to perform the request on behalf of. |


## Responses

### 200: No description

Content-Type: `application/json`

```json
{
  "oneOf": [
    {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "createdFrom"
        ],
        "properties": {
          "createdFrom": {
            "type": "string"
          },
          "clientId": {
            "type": "string"
          },
          "configurationId": {
            "type": "string"
          },
          "projectsMetadata": {
            "type": "array",
            "nullable": true
          },
          "integrationIcon": {
            "type": "string"
          },
          "integrationConfigurationUri": {
            "type": "string"
          },
          "integrationWebsite": {
            "type": "string"
          }
        }
      }
    },
    {
      "type": "object",
      "required": [
        "drains"
      ],
      "properties": {
        "drains": {
          "oneOf": [
            {
              "type": "array"
            },
            {
              "type": "array"
            }
          ]
        }
      }
    }
  ]
}
```

### 400: One of the provided values in the request query is invalid.

### 401: The request is not authorized.

### 403: You do not have permission to access this resource.

### 404: No description

### 410: No description

---

## Related

- [logDrains endpoints](/docs/rest-api#logdrains)

- [REST API overview](/docs/rest-api)

- [OpenAPI spec](https://openapi.vercel.sh/) (machine-readable, all endpoints)

---

[View full sitemap](/docs/sitemap)