access-groups11

ai-gateway20

aliases6

artifacts7

authentication5

billing3

bulk-redirects7

certs5

checks5

checks-v210

connect14

daemons3

deployments10

dns4

domains9

domains-registrar19

drains6

edge-cache4

environment11

feature-flags24

global-config18

integrations9

kms13

logDrains7

logs1

marketplace25

microfrontends5

networking11

observability2

organizations7

project-routes8

projectMembers3

projects33

rolling-release8

sandboxes33

security17

storage3

teams16

user4

vcr27

vercel-ci23

web-analytics4

webhooks4

drains

Find a Drain by id

Changed on Oct 22, 2026

Get the information for a specific Drain by passing the drain id in the URL.

get/v1/drains/{id}

Request

Base URL: https://api.vercel.com
URL: https://api.vercel.com/v1/drains/{id}
Auth: HTTP bearer

Path parameters

idstring required

Query parameters

includeDeliveryStatsboolean

Include deliveryStats with the delivery health of the drain over the last 24 hours.

teamIdstring

Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring

Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

createdAtnumber required

disabledAtnumber

disabledBystring

disabledReason'account-plan-downgrade' | 'disabled-by-admin' | 'disabled-by-owner' | 'feature-not-available' | 'limits-exceeded'

firstErrorTimestampnumber

idstring required

namestring required

ownerIdstring required

projectIdsstring[]

status'disabled' | 'enabled' | 'errored'

teamIdstring nullable

updatedAtnumber required

Changes

Oct 22, 2026e93418e871dc Revision changes
- info
  added the non-success response with the status
Oct 22, 20264686ebfcdc1e Revision changes
- breaking
  the response's body type changed from no type to object for status
- info
  added the new optional query request parameter includeDeliveryStats
- info
  removed subschema #1 subschema #2 from the response body oneOf list for the response status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (10 revisions)