---
title: "Retrieve a marketplace program"
method: GET
path: "/v2/marketplace/programs/{company_key}"
tags: ["Marketplace"]
---

# Retrieve a marketplace program

`GET /v2/marketplace/programs/{company_key}`

Retrieves a marketplace program given its program key.

## Path parameters

- `company_key` string, required

## Response `200`

Retrieves a marketplace program given its program key.

- object
  - `data` object, required — Returns a list of all marketplace-listed programs and their details
    - `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
  - `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)