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

# GET /requests

`GET /requests`

Requests endpoints allows the creation of different kind of requests to handle the life cycle
of Assets.

## Query parameters

- `limit` integer
- `offset` integer
- `activation_key` string
- `asset.account_id` string
- `asset.configuration` string
- `asset.connection.environment` 'test' | 'production'
- `asset.connection.hub.id` string
- `asset.connection.hub.name` string
- `asset.connection.id` string
- `asset.connection.provider.id` string
- `asset.connection.provider.name` string
- `asset.connection.type` 'test' | 'production'
- `asset.connection.vendor.id` string
- `asset.connection.vendor.name` string
- `asset.contract.id` string
- `asset.external.id` string
- `asset.external_id` string
- `asset.external_uid` string
- `asset.id` string
- `asset.items` string
- `asset.marketplace.id` string
- `asset.marketplace.name` string
- `asset.params.id` string
- `asset.params.value` string
- `asset.product.capabilities` string
- `asset.product.id` string
- `asset.product.name` string
- `asset.status` 'draft' | 'processing' | 'active' | 'terminating' | 'suspended' | 'terminated'
- `asset.tier1_id` string
- `asset.tier2_id` string
- `asset.tiers.customer.id` string
- `asset.tiers.customer.name` string
- `asset.tiers.tier1.id` string
- `asset.tiers.tier2` string
- `asset.tiers.tier2.id` string
- `asset__connection__environment` 'test' | 'production'
- `asset__connection__hub__id` string
- `asset__connection__hub__name` string
- `asset__connection__provider__id` string
- `asset__connection__provider__name` string
- `asset__connection__type` 'test' | 'production'
- `asset__connection__vendor__id` string
- `asset__connection__vendor__name` string
- `asset__id` string
- `asset__product__id` string
- `asset__product__name` string
- `asset__tiers__customer__id` string
- `asset__tiers__tier1__id` string
- `asset__tiers__tier2__id` string
- `asset_id` string
- `assignee` string
- `assignee.email` string
- `assignee__email` string
- `contract.id` string
- `contract__id` string
- `contract__id__exact` string
- `created` string, date-time
- `external_id` string
- `id` string
- `marketplace.id` string
- `marketplace.name` string
- `marketplace__name` string
- `product_id` string
- `sli.days` integer
- `sli.zone` integer
- `status` 'draft' | 'tiers_setup' | 'pending' | 'inquiring' | 'approved' | 'failed' | 'scheduled' | 'revoking' | 'revoked' | 'queued'
- `template` string
- `template.id` string
- `type` 'purchase' | 'cancel' | 'change' | 'suspend' | 'resume' | 'adjustment' | 'renew' | 'transfer'
- `updated` string, date-time

## Response `200`

- object[]
  - `id` string
  - `type` 'purchase' | 'change' | 'suspend' | 'resume' | 'cancel'
  - `note` string
  - `reason` string
  - `created` string, datetime
  - `updated` string, datetime
  - `effective_date` string, datetime
  - `answered` boolean
  - `assignee` string
  - `activation_key` string
  - `marketplace` object
    - `id` string
    - `name` string
    - `icon` string
  - `status` 'draft' | 'tiers_setup' | 'pending' | 'inquiring' | 'approved' | 'failed'
  - `previous_approved_request` object
    - `id` string
  - `asset` object
    - `id` string
    - `status` 'active' | 'new' | 'processing' | 'rejected' | 'suspended' | 'terminated'
    - `external_id` string
    - `external_uid` string
    - `product` object
      - `id` string
      - `icon` string
      - `name` string
      - `status` 'draft' | 'published' | 'endofsale'
    - `connection` object
      - `id` string
      - `provider` object
        - `id` string
        - `name` string
      - `vendor` object
        - `id` string
        - `name` string
      - `type` 'preview' | 'test' | 'production'
      - `hub` object
        - `id` string
        - `name` string
    - `events` object
      - `created` object
        - `at` string, datetime
      - `updated` object
        - `at` string, datetime
    - `items` object[]
      - `id` string
      - `global_id` string
      - `mpn` string
      - `old_quantity` string
      - `quantity` string
      - `type` string
      - `display_name` string
      - `period` string
      - `item_type` string
    - `params` object[]
      - `id` string
      - `name` string
      - `type` string
      - `description` string
      - `value` string
      - `value_error` string
      - `structured_value` union
        - object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string, required
          - `postal_code` string, required
          - `country` string, required
        - object
          - `country_code` string, required
          - `area_code` string, required
          - `phone_number` string, required
          - `extension` string, required
      - `value_choices` string[]
      - `title` string
    - `tiers` object
      - `customer` object
        - `external_id` string
        - `external_uid` string
        - `name` string
        - `tax_id` string
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
      - `tier1` object
        - `external_id` string
        - `external_uid` string
        - `name` string
        - `tax_id` string
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
      - `tier2` object
        - `external_id` string
        - `external_uid` string
        - `name` string
        - `tax_id` string
        - `contact_info` object
          - `address_line1` string, required
          - `address_line2` string
          - `city` string, required
          - `state` string
          - `postal_code` string, required
          - `country` string, required
          - `contact` object, required
            - `first_name` string, required
            - `last_name` string, required
            - `email` string, email, required
            - `phone_number` object, required
              - …
    - `configuration` object
      - `params` object[]
        - `id` string
        - `title` string
        - `description` string
        - `value` string
        - `type` 'text' | 'dropdown' | 'password' | 'email' | 'checkbox' | 'subdomain' | 'domain' | 'phone' | 'url' | 'choice'
        - `scope` 'product' | 'item' | 'marketplace' | 'item_marketplace'
        - `phase` 'configuration'
        - `constraints` object
          - `required` boolean
          - `hidden` boolean
          - `readonly` boolean
          - `unique` boolean
          - `shared` 'view' | 'edit'
        - `events` object
          - `created` object
            - `at` string, datetime
            - `by` object
              - …
          - `updated` object
            - `at` string, datetime
            - `by` object
              - …
    - `marketplace` object
      - `id` string
      - `name` string
      - `icon` string
    - `contract` object
      - `id` string
      - `name` 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)