---
title: "Get Zap Runs"
method: GET
path: "/v2/zap-runs"
tags: ["Experimental", "Zaps"]
---

# Get Zap Runs

`GET /v2/zap-runs`

This endpoint returns runs for the specified Zaps and provides basic yet essential details about their execution. As the initial version, it serves foundational information, with plans for continuous enhancement to expand its capabilities and improve data output over time.

#### When using OAuth

This endpoint requires the `zap:runs` OAuth scope.

## Query parameters

- `from_date` string
- `limit` integer
- `offset` integer
- `search` string
- `statuses` string[]
- `to_date` string
- `zap_id` integer

## Response `200`

- ZapRunsResponse[]
  - `links` Links, required — The links object returned in paginated response bodies.
    - `next` string, nullable — The URL of the next page of paginated results.
    - `prev` string, nullable — The URL of the previous page of paginated results.
  - `meta` BaseMeta, required — The meta object returned in paginated response bodies.
    - `count` integer, required — The total number of objects in the collection represented by the endpoint.
    - `limit` integer, nullable, required — The limit value used in the request.
    - `offset` integer — The offset value used in the request.
  - `data` ZapRun[] — The returned data after a successful Zap run
    - `id` string, uuid, required — Zap Run ID
    - `zap_id` integer, required — Associated Zap ID
    - `start_time` string, date-time, nullable — Datetime when the Zap Run started
    - `end_time` string, date-time, nullable — Datetime when the Zap Run ended
    - `status` string, required — Execution status of the Zap Run
    - `zap_title` string, nullable, required — The title of the Zap at the time it ran
    - `steps` ZapRunStep[], nullable, required — Contains the execution details of each step
      - `status` string, nullable, required — Execution status of the step
      - `start_time` string, date-time, nullable — Datetime when the step was executed
    - `data_in` unknown
    - `data_out` unknown

## 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)