---
title: "Retrieves a list of Integration log drains (deprecated)"
method: GET
path: "/v2/integrations/log-drains"
tags: ["logDrains"]
---

# Retrieves a list of Integration log drains (deprecated)

`GET /v2/integrations/log-drains`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/integrations/log-drains`
- Auth: HTTP bearer

Retrieves a list of all Integration log drains that are defined for the authenticated user or team. When using an OAuth2 token, the list is limited to log drains created by the authenticated integration.

## Query parameters

- `teamId` string
- `slug` string

## Response `200`

A list of log drains

- object[]
  - `branch` string: The branch regexp of log drain
  - `clientId` string: The oauth2 client application id that created this log drain
  - `configurationId` string: The client configuration this log drain was created with
  - `createdAt` number, required: A timestamp that tells you when the log drain was created
  - `createdFrom` 'integration' | 'self-served': Whether the log drain was created by an integration or by a user
  - `deliveryFormat` 'json' | 'ndjson' | 'protobuf': The delivery log format
  - `environments` string[]: The environment of log drain
  - `headers` object: The headers to send with the request
  - `id` string, required: The unique identifier of the log drain. Always prefixed with `ld_`
  - `name` string, required: The name of the log drain
  - `ownerId` string, required: The identifier of the team or user whose events will trigger the log drain
  - `projectId` string, nullable
  - `projectIds` string[]: The identifier of the projects this log drain is associated with
  - `samplingRate` number: The sampling rate of log drain
  - `source` union, required
    - object
      - `defaultFor` 'eve-tracing': Informational marker for a system-owned default drain.
      - `kind` 'self-served', required
    - object
      - `externalResourceId` string
      - `integrationConfigurationId` string, required
      - `integrationId` string, required
      - `kind` 'integration', required
      - `resourceId` string
  - `sources` string[]: The sources from which logs are currently being delivered to this log drain.
  - `url` string, required: The URL to call when logs are generated

## Other responses

- `400`
- `401`: The request is not authorized.
- `403`: You do not have permission to access this resource.
- `404`
- `410`

## Changes

- **2026-09-30** `099fbe1f521c`: 1 info
  - added the non-success response with the status `404`
- **2026-09-22** `0f7ea3d3b39b`: 1 info
  - added the optional property `items/source/oneOf[subschema #1]/defaultFor` to the response with the `200` status
- **2026-07-21** `2ae10ee9d21c`: 1 info
  - added the non-success response with the status `410`
- **2025-11-28** `45991e5c8b6d`: 1 warning, 1 info
  - added the new `redirect` enum value to the `items/sources/items/` response property for the response status `200`
  - removed the `syslog` enum value from the `items/deliveryFormat` response property for the response status `200`
- **2025-10-09** `50caddad4ae7`: 1 breaking, 1 info
  - the response property `items/environments` became optional for the status `200`
  - added the required property `items/source` to the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v2/integrations/log-drains/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)