---
title: "Get a command"
method: GET
path: "/v2/sandboxes/sessions/{sessionId}/cmd/{cmdId}"
tags: ["sandboxes"]
---

# Get a command

`GET /v2/sandboxes/sessions/{sessionId}/cmd/{cmdId}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v2/sandboxes/sessions/{sessionId}/cmd/{cmdId}`
- Auth: HTTP bearer

Retrieves the current status and details of a command executed in a session. Use the `wait` parameter to block until the command finishes execution.

## Path parameters

- `sessionId` string, required: The unique identifier of the session containing the command.
- `cmdId` string, required: The unique identifier of the command to retrieve.

## Query parameters

- `wait` 'true' | 'false': If set to "true", the request will block until the command finishes execution. Useful for synchronously waiting for command completion.
- `teamId` string
- `slug` string

## Response `200`

The command data along with the exit code if the command did finish.

- object
  - `command` SessionCommand, required: This object represents a command run in a Vercel Sandbox session (v2 API).
    - `args` string[], required: The arguments of the command.
    - `cwd` string, required: The current working directory of the command.
    - `durationMs` number: Duration of the command execution in milliseconds.
    - `exitCode` number, nullable, required: If the command did finish, the exit code.
    - `id` string, required: The ID of the command.
    - `name` string, required: The name of the command.
    - `sessionId` string, required: The ID of the session associated with the command.
    - `startedAt` number, required: When the command was started, in milliseconds since the epoch.

## Other responses

- `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`
- `410`
- `422`
- `429`

## Changes

- **2026-10-23** `0ab54ee1bd2e`: 1 info
  - removed the non-success response with the status `500`
- **2026-07-08** `3ff660568354`: 1 info
  - added the optional property `command/durationMs` to the response with the `200` status
- **2026-06-11** `14b4658f819e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v2/sandboxes/sessions/:sessionId/cmd/:cmdId/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)