# Retrieve an offer

**GET /v1/Offers/{id}**

Retrieves an offer with the specified GUID identifier.


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.

### Path parameters
- **id** (string(uuid))
  GUID Unique identifier for the offer.

### Query parameters
- **providerInstanceId** (string(uuid))
  GUID Unique identifier for the provider instance.
- **customerId** (string(uuid))
  GUID Unique identifier for the customer.
- **resellerId** (string(uuid))
  GUID Unique identifier for the reseller. When this property is set the offer price will have the corresponding margins applied. Only usable for CSPs.
- **segment** (string)
  The string indicating which segment to get the offers for. Possible values: Commercial, Education, Government or NonProfit


## Responses
### 200
OK

#### Body: application/json (object)
- **id** (string(uuid))
  The id of the offer.
- **name** (string | null)
  The name of the offer.
- **description** (string | null)
  The offer description.
- **imageUrl** (string | null)
  The offer image URL.
- **offerType** (object)
  The offer type. Possible values: License, LicenseLegacy, SoftwareSubscription, PerpetualSoftware, AzurePlan, AzureReservation, AzureLegacy or AzureSavingsPlan.
- **billingType** (object)
  The billing type for the offer. Possible values: License, Usage or None
- **prices** (array[object] | null)
  The offer prices.
- **providerName** (string | null)
  The offer provider name.
- **providerInstanceId** (string(uuid) | null)
  The provider's instance identifier.
- **isAddon** (boolean)
  The value indicating whether this offer is addon.
- **minQuantity** (integer(int32))
  The minimum quantity for this offer.
- **maxQuantity** (integer(int32))
  The maximum quantity for this offer.
- **hasPreRequisites** (boolean)
  The value indicating whether this offer has pre requisite offers.
- **preRequisites** (array[string] | null)
  The list of pre requisite offers ids.
- **isTrial** (boolean)
  The value indicating whether this offer is a trial.
- **providerOfferId** (string | null)
  The provider's offer identifier.
- **isDeleted** (boolean)
  A Value indicating whether this offer is deleted and cannot be provisioned.

### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 404
Not Found

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)