---
title: "List a function's recent deployments"
method: GET
path: "/functions/{id}/deployments"
tags: ["Functions"]
---

# List a function's recent deployments

`GET /functions/{id}/deployments`

## Request

- Base URL: `https://api.primitive.dev/v1`
- URL: `https://api.primitive.dev/v1/functions/{id}/deployments`
- Auth: HTTP bearer

The function's most recent deployments, newest first, with build and bundle details: limit of them (default 50, at most 200). This list is not paged; read an older deployment by id with getFunctionDeployment. is_current marks the one serving traffic.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

List a function's recent deployments

- object
  - `success` true, required
  - `data` ListFunctionDeploymentsResult, required
    - `items` object[], required
      - `id` string, uuid, required
      - `status` string, required
      - `deploy_error` string, nullable, required
      - `started_at` string, date-time, required
      - `finished_at` string, date-time, nullable, required
      - `duration_ms` number, nullable, required
      - `is_current` boolean, required
      - `source_kind` 'esm' | 'managed_build', required
      - `entry_point` string, nullable, required
      - `bundle_bytes` number, nullable, required
      - `bundle_gzip_bytes` number, nullable, required
      - `build_ms` number, nullable, required
      - `bundle_sha256` string, nullable, required
      - `source_sha256` string, nullable, required
      - `builder_version` string, nullable, required

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `403`: Authenticated caller lacks permission for the operation
- `404`: Resource not found
- `429`: Rate limit exceeded. The `ratelimit-*` headers describe the limiter that rejected this request, with its own limit and window, not the API budget that successful responses report. A limiter that reports only a wait sends `Retry-After` alone.

---

[API](https://skmtc.dev/primitive/apis/primitive-api.md) - [All operations](https://skmtc.dev/primitive/apis/primitive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primitive/apis/primitive-api/revisions/bce409c97acb?raw)