---
title: "Program List"
method: GET
path: "/v1/programs/list/{business_ids}"
tags: ["Partner Support"]
---

# Program List

`GET /v1/programs/list/{business_ids}`

Given a list of business ids, this API returns the list of past, current and future advertising programs with info for each program (status, start/end date) for every business id.

## Path parameters

- `business_ids` string, required

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Successfully fetched the advertising program information for the given businesses.

- object
  - `errors` Items[], required — List of errors — unresolved $ref
  - `businesses` object[], required
    - `yelp_business_id` string
    - `destination_yelp_business_id` string
    - `advertiser_status` string
    - `partner_business_id` string
    - `programs` Items[] — unresolved $ref

## Other responses

- `400` — unresolved $ref

---

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