---
title: "List all programs"
method: GET
path: "/v2/marketplace/programs"
tags: ["Marketplace"]
---

# List all programs

`GET /v2/marketplace/programs`

Returns a list of all active marketplace-listed programs and their details. The programs are returned sorted by creation date by default, with the most recent programs appearing first.

## Query parameters

- `min_created` integer
- `max_created` integer
- `category` string
- `limit` integer
- `starting_after` string
- `ending_before` string

## Response `200`

Returns a list of all active marketplace-listed programs and their details. The programs are returned sorted by creation date by default, with the most recent programs appearing first.

- object
  - `data` object, required
    - `has_more` boolean
    - `items` object[]
      - `category` unknown[], nullable — The category of this marketplace listing
        - unknown
      - `country` string, nullable — Origin country of this marketplace listing
      - `created_at` integer — Immutable Unix timestamp in milliseconds taken at time of company creation
      - `description` string, nullable — The description of the marketplace listing
      - `has_sub_id` boolean — Indicates whether or not the program uses sub IDs
      - `id` integer — Unique id of this company.
      - `key` string — Key of the marketplace listing
      - `logo` string, nullable — Key of image for this marketplace listing
      - `name` string — The name of the marketplace listing
      - `offers` object[], nullable — Available offers for the program
        - `base_rate` string, nullable
        - `currency` string, nullable
        - `description` string, nullable
        - `type_` string, nullable
      - `promotions` object[], nullable — List of available promotions for the program
        - `availability` string
        - `key` string
        - `type_` string
        - `value` string — A more detailed description of the promotion
      - `website` string, nullable — The website of this marketplace listing
    - `total` integer, nullable
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/partnerstack/apis/partnerstack-api.md) · [All operations](https://skmtc.dev/partnerstack/apis/partnerstack-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/partnerstack/partnerstack-api/revisions/0f35aebe53a9/schema)