Skip to Content

APIs & SDKs

Get deployment events

Vercel SDK

GEThttps://api.vercel.com/v3/deployments/{idOrUrl}/events

Get deployment events

Get the build logs of a deployment by deployment ID and build ID. It can work as an infinite stream of logs or as a JSON endpoint depending on the input parameters.

Path parameters

idOrUrl

Default authentication mechanism

string

AuthorizationbearerToken

Required

direction

Order of the returned events based on the timestamp.

The unique identifier or hostname of the deployment.

Optional

follow

When enabled, this endpoint will return live events as they happen.

Timestamp for when build logs should be pulled from.

limit

number
Optional
Optional
number

name

Maximum number of events to return. Provide -1 to return all available logs.

string
Optional
number
Deployment build ID.

Timestamp for when the build logs should be pulled up until.

until

Optional
since
Optional
number

statusCode

HTTP status code range to filter events by.

Digital Marketing

delimiter

Optional
number
Optional
number

builds

The Team identifier to perform the request on behalf of.

any
Optional
teamId
string

Software Delivery

The Team slug to perform the request on behalf of.

Optional
slug
Optional
string

Response

200Success


Errors

410Error

401The request is not authorized.

500Error

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

403You do not have permission to access this resource.

This page is not in the current cross-link map.