---
title: "Get Zaps [v2]"
method: GET
path: "/v2/zaps"
tags: ["Zaps"]
---

# Get Zaps [v2]

`GET /v2/zaps`

This endpoint returns a list of Zaps for the authenticated Zapier user.

The `expand` array can be used to expand selected fields into full objects in the response.  Inputs with keys can
also be passed to filter Zaps by certain criteria.

**Scope Selection:**
- Use `zap` if you have a Zapier integration and wish to get only Zaps using your integration.
- Use `zap:all` to get all of the user's Zaps.
- Use `zap:account:all` to get all of the Zaps the user has access to in their account.

#### When using OAuth

This endpoint requires the `zap`, `zap:all`, or `zap:account:all` OAuth scopes.

## Query parameters

- `expand` string
- `include_shared` boolean
- `inputs` string
- `limit` integer
- `offset` integer

## Response `200`

- ExpandedZapsResponse[]
  - `links` object, required — Links related to the response data
  - `meta` object, required — Metadata about the response
  - `data` ExpandedZap[], required — The (potentially) expanded data for Zaps that matched the request
    - `type` string, required — The type of this object.
    - `id` string, required — A unique identifier of the Zap.
    - `is_enabled` boolean — Whether the Zap is enabled (running) or not.
    - `last_successful_run_date` string, nullable, required — The date/time at which this Zap last ran successfully. A null value indicates that a Zap has never run successfully.
    - `updated_at` string, required — The last time this Zap was updated
    - `title` string, required — The human readable name of the Zap.
    - `links` object, required — Link to open this Zap in the Zapier Editor
    - `steps` union[], required — A list of the steps this Zap consists of
      - union
        - ExpandedZapStep — An ordered list of steps that define the logic of the Zap.
          - `action` union, required — Action
            - Action — An Action is an operation that can be performed against a third-party API; either a read or a write. A Zap is composed of a read, followed by one or more writes.
              - …
            - string
          - `authentication` Authentication, required — An Authentication contains various fields, often credentials such as API tokens, used to access Partner APIs on behalf of a user. The actual fields are held securely by Zapier
            - `type` 'authentication', required — * `authentication` - authentication
            - `id` string, required — The unique UUID identifier for this specific Authentication. Legacy hashids are still accepted on input for backwards compatibility.
            - `app` union, required — An app that integrates with Zapier.
              - …
            - `is_expired` boolean, required — If `true`, this Authentication has expired. It will not be usable, and the user needs to be directed to reconnect it.
            - `title` string, required — The title of this specific Authentication
          - `inputs` unknown, required
          - `title` string, nullable, required — The custom title of a Zap Step. If a step has not been given a custom title by the user, then the value will be null.
        - string

## Other responses

- `400` — This schema can be expected for 4xx 'Malformed request.' errors
- `401` — 401 Response
- `403` — 403 Response
- `409` — 409 Response
- `429` — 429 Response
- `500` — This schema can be expected for 5xx 'A server error occurred.' errors
- `503` — 503 Response
- `504` — 504 Response

---

[API](https://skmtc.dev/zapier/apis/trigger-inbox-api.md) · [All operations](https://skmtc.dev/zapier/apis/trigger-inbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zapier/trigger-inbox-api/revisions/3fc4c2846ba1/schema)