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

# Get Zaps [v1]

`GET /v1/zaps`

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

#### When using OAuth

This endpoint requires the `zap` OAuth scope.

## Query parameters

- `get_params` unknown
- `limit` number
- `offset` number
- `params__{{KEY}}` string

## Response `200`

- ZapsResponse[]
  - `next` string, uri, nullable, required — The URL to get the next set of records
  - `previous` string, uri, nullable, required — The URL to get the previous set of records
  - `count` integer, required — The total number of records matching the request
  - `objects` Zap[], required — The returned Zap data
    - `id` integer, required — The numeric identifier of this Zap
    - `title` string, required — The title of this Zap
    - `state` string, required — The current state of this Zap
    - `steps` ZapStep[], required — The steps this Zap consists of
      - `type_of` 'read' | 'write' | 'filter' | 'search' | 'search_or_write', required — * `read` - read * `write` - write * `filter` - filter * `search` - search * `search_or_write` - search_or_write
      - `app` ZapStepApp, required — Data for the App used in a given Zap's step
        - `id` integer, required — The numerical identifier of this Zap step's App
        - `uuid` string, required — UUID identifier for this Zap step's App
        - `title` string, required — The name of this App
        - `slug` string, required — The shortened slug for this App
        - `description` string, required — The description of this App
        - `hex_color` string, required — The primary (hex) color for this App
        - `image` string, required — The image for this App
        - `images` ZapTemplateStepImages, required — Images for a Zap Template at various sizes
          - `url_16x16` string, required — URL to 16x16 image for Zap Template
          - `url_32x32` string, required — URL to 32x32 image for Zap Template
          - `url_64x64` string, required — URL to 64x64 image for Zap Template
          - `url_128x128` string, required — URL to 128x128 image for Zap Template
        - `api` string, required — The name of the API this App references
        - `url` string, uri, required — The URL for this App
      - `params` object, nullable, required — The parameters used by this Step
    - `url` string, uri, required — The URL to this Zap
    - `modified_at` string, required — The last time this Zap was modified

## Other responses

- `401` — 401 Response
- `403` — Invalid authentication
- `409` — 409 Response
- `429` — 429 Response
- `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)