---
title: "Program List All"
method: GET
path: "/programs/v1"
tags: ["Partner Support"]
---

# Program List All

`GET /programs/v1`

Returns the entire list of past, current and future advertising programs under a given payment account with info for each program (status, start/end date).

## Query parameters

- `offset` integer
- `limit` integer
- `program_status` 'PAST' | 'PAUSED' | 'CURRENT' | 'FUTURE' | 'ALL'

## Response `200`

Successfully fetched a list of advertising programs.

- object
  - `program_status` string
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `payment_programs` object[]
    - `program_type` string
    - `program_id` string
    - `start_date` string
    - `end_date` string
    - `program_status` string
    - `program_pause_status` string
    - `active_features` string[]
    - `program_metrics` object
      - `currency` string
      - `ad_cost` integer
      - `billed_clicks` integer
      - `is_autobid` boolean
      - `billed_impressions` integer
      - `budget` integer
      - `fee_period` string
      - `max_bid` integer
    - `businesses` object[]
      - `yelp_business_id` string
      - `partner_business_id` string

## Other responses

- `400` — Bad Request.

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)