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

# GET /listing-requests

`GET /listing-requests`

## Query parameters

- `limit` integer
- `offset` integer
- `contract__id` string
- `contract__name` string
- `created` string, date-time
- `id` string
- `listing.contract.id` string
- `listing.contract.marketplace.id` string
- `listing.contract.marketplace.name` string
- `listing.contract.name` string
- `listing.id` string
- `listing.marketplace.id` string
- `listing.marketplace.name` string
- `listing.product.id` string
- `listing.product.name` string
- `listing.product.version` integer
- `listing.provider.id` string
- `listing.provider.name` string
- `listing.vendor.id` string
- `listing.vendor.name` string
- `listing__id` string
- `marketplace__id` string
- `marketplace__name` string
- `product.id` string
- `product.name` string
- `product.version` integer
- `product__id` string
- `product__name` string
- `product__version` integer
- `provider__id` string
- `provider__name` string
- `state` 'draft' | 'reviewing' | 'deploying' | 'canceled' | 'completed'
- `status` 'unlisted' | 'listed'
- `type` 'new' | 'remove'
- `updated` string, date-time
- `vendor__id` string
- `vendor__name` string

## Response `200`

- DpListingRequest[]
  - `id` string
  - `type` 'new' | 'remove', required
  - `state` 'draft' | 'reviewing' | 'deploying' | 'canceled' | 'completed'
  - `product` DpProduct — Product References representation.
    - `id` string, required
    - `icon` string, binary
    - `name` string
    - `status` string
    - `category` DpCategoryReference
      - `id` string
      - `name` string, required
    - `description` string
  - `listing` 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
  - `offer` DpOffer
    - `id` string, nullable, required
    - `name` string
    - `plans` DpId[]
      - `id` string, required
    - `type` 'generic' | 'commerce', nullable
  - `pricelist` DpPriceList
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_1` DpPriceList
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `alt_pricelist_2` DpPriceList
    - `id` string, nullable, required
    - `name` string, required
    - `status` 'draft' | 'scheduled' | 'active' | 'terminated', required
  - `creator` DpActorReference
    - `id` string
    - `name` string
    - `icon` string
  - `assignee` DpUserReference
    - `id` string
    - `name` string, nullable
    - `icon` string, nullable
  - `created` string, date-time
  - `updated` string, date-time
  - `product_id` string
  - `contract_id` string
  - `listing_id` string
  - `offer_id` string, nullable
  - `pricelist_id` string, nullable
  - `alt_pricelist_1_id` string, nullable
  - `alt_pricelist_2_id` string, nullable
  - `note` string
  - `events` object
    - `created` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string
    - `updated` object
      - `at` string, datetime
      - `by` object
        - `id` string
        - `name` string
        - `icon` string

---

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