---
title: "Get an Invocation"
method: GET
path: "/v1/functions/invocations/{id}"
---

# Get an Invocation

`GET /v1/functions/invocations/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

The request has succeeded.

- object
  - `id` string, uuid, required
  - `projectId` string, uuid, required
  - `functionId` string, uuid, required
  - `versionId` string, uuid, required
  - `sessionId` string, uuid, required
  - `region` string
  - `params` object — JSON object that can be stored in a JSONB column
  - `status` 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED', required
  - `results` union — Any JSON-serializable value that can be stored in a JSONB column
    - string
    - number
    - boolean
    - unknown[]
      - unknown
    - object
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `startedAt` string, date-time, required
  - `endedAt` string, date-time
  - `expiresAt` string, date-time, required
  - `cause` object
    - `code` 'TIMED_OUT' | 'INTERNAL_ERROR' | 'WORKLOAD_ERROR', required
    - `message` string

## Changes

- **2026-07-03** `a01add309d79` — 2 breaking
  - the response property `allOf[#/components/schemas/Invocation]/results` became nullable for the status `200`
  - response property `allOf[#/components/schemas/Invocation]/results` list-of-types was widened by adding types `array, boolean, number and string` to media type `application/json` of response `200`
- **2026-04-06** `921d3c61c7aa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/browserbase/apis/browserbase-api/changes/v1/functions/invocations/:id/get.md)

---

[API](https://skmtc.dev/browserbase/apis/browserbase-api.md) · [All operations](https://skmtc.dev/browserbase/apis/browserbase-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/browserbase/browserbase-api/revisions/550634919db9/schema)