---
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}`

## Request

- Base URL: `https://api.partnerstack.com/api`
- URL: `https://api.partnerstack.com/api/v2/marketplace/programs/{company_key}`
- Auth: HTTP bearer

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-partner-api.md) - [All operations](https://skmtc.dev/partnerstack/apis/partnerstack-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/partnerstack/apis/partnerstack-partner-api/revisions/c050e16b8752?raw)