> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List deployments

> List Vercel deployments with project, state, branch, and time filters.

`listVercelDeployments` lists deployments in a personal account or team.

```ts automations/list-vercel-deployments.automation.ts theme={null}
import { automation } from "automate.ax"
import { listVercelDeployments } from "automate.ax/vercel"

export default automation("List failed Vercel deployments", () => {
  const page = listVercelDeployments({
    limit: 50,
    projectId: "prj_123",
    state: "ERROR",
  })
  page.deployments
})
```

`limit` defaults to `20` and accepts 1–100. Filter by `projectId`, `state`, `branch`, `sha`, `target`, or the `until` millisecond timestamp. Optional `teamId` overrides the OAuth installation team. The output contains typed `deployments` and `pagination` data.