---
title: "GET /listings"
method: GET
path: "/listings"
tags: ["Listings"]
---

# GET /listings

`GET /listings`

## Query parameters

- `limit` integer
- `offset` integer
- `alt_pricelist_1.id` string
- `alt_pricelist_1.name` string
- `alt_pricelist_2.id` string
- `alt_pricelist_2.name` string
- `contract.id` string
- `contract__id` string
- `contract__marketplace__name` string
- `created` string, date-time
- `id` string
- `marketplace.id` string
- `marketplace.name` string
- `marketplace__id` string
- `marketplace__name` string
- `marketplace__name__icontains` string
- `offer.id` string
- `offer.name` string
- `pending_request.status` string
- `pending_request.type` string
- `pending_request__id` string
- `pending_request__is_null` string
- `pricelist.id` string
- `pricelist.name` string
- `product.id` string
- `product.name` string
- `product__id` string
- `product__name` string
- `product__name__icontains` string
- `provider.id` string
- `provider.name` string
- `provider__id` string
- `status` 'unlisted' | 'listed'
- `updated` string, date-time
- `vendor.id` string
- `vendor.name` string

## Response `200`

- DpListing[]
  - `id` string
  - `status` string
  - `contract` DpContractNameAndMarketplaceReference
    - `id` string
    - `type` string
    - `name` string
  - `product` DpProduct — Product References representation.
    - `id` string, required
    - `icon` string, binary
    - `name` string
    - `status` string
    - `category` DpCategoryReference
      - `id` string
      - `name` string, required
    - `description` string
  - `created` string, date-time
  - `updated` string, date-time
  - `vendor` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `provider` DpAccountReference
    - `id` string, required
    - `name` string
    - `icon` string, nullable
  - `pending_request` DpListingRequestReference
    - `id` string
    - `type` 'new' | 'remove', required
    - `status` string, required
  - `offer` DpOffer, required
    - `id` string, nullable, required
    - `name` string
    - `plans` DpId[]
      - `id` string, required
    - `type` 'generic' | 'commerce', nullable
  - `pricelist` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_1` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_2` DpPriceList, required
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)