Get logs for a deployment | Vercel REST API

APIs & SDKs

Get logs for a deployment

GEThttps://api.vercel.com/v1/projects/{projectId}/deployments/{deploymentId}/runtime-logs

Returns a stream of logs for a given deployment.

https://api.vercel.com/v1/projects/{projectId}/deployments/{deploymentId}/runtime-logs

const response = await fetch('https://api.vercel.com/v1/projects/projectId/deployments/deploymentId/runtime-logs?teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "domain": "string",
  "level": "debug",
  "message": "string",
  "messageTruncated": "false",
  "requestMethod": "string",
  "requestPath": "string",
  "responseStatusCode": "123",
  "rowId": "example_id",
  "source": "delimiter",
  "timestampInMs": "123"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

projectIdstringRequired

deploymentIdstringRequired

Query parameters

teamIdstringOptional

The Team identifier to perform the request on behalf of.

slugstringOptional

The Team slug to perform the request on behalf of.

Response

200Success

domainstringRequired

levelstringRequired

messagestringRequired

messageTruncatedbooleanRequired

requestMethodstringRequired

requestPathstringRequired

responseStatusCodenumberRequired

rowIdstringRequired

sourcestringRequired

timestampInMsnumberRequired

Errors

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

401The request is not authorized.

403You do not have permission to access this resource.

404Error

410Error

Cross-link map: Get logs for a deployment (/docs/rest-api/logs/get-logs-for-a-deployment)

From the Vercel docs graph (built 2026-10-07T05:48:34.144Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Get deployment events — GET /v3/deployments/{idOrUrl}/events — Get the build logs of a deployment by deployment ID and build ID. It can work as
List Deployment Files — GET /v6/deployments/{id}/files — Allows to retrieve the file structure of the source code of a deployment by supplying t
List deployments — GET /v7/deployments — List deployments under the authenticated user or team. If a deployment hasn't finished uploading \
List check runs for a deployment — GET /v2/deployments/{deploymentId}/check-runs — List all check runs for a deployment.
Get Deployment File Contents — GET /v8/deployments/{id}/files/{fileId} — Allows to retrieve the content of a file by supplying the file identifier and

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v1/projects/{projectId}/deployments/{deploymentId}/runtime-logs

const response = await fetch('https://api.vercel.com/v1/projects/projectId/deployments/deploymentId/runtime-logs?teamId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "domain": "string",
  "level": "debug",
  "message": "string",
  "messageTruncated": "false",
  "requestMethod": "string",
  "requestPath": "string",
  "responseStatusCode": "123",
  "rowId": "example_id",
  "source": "delimiter",
  "timestampInMs": "123"
}

OpenAPI Specification