---
title: "POST /#X-Amz-Target=DeviceFarm_20150623.RenewOffering"
method: POST
path: "/#X-Amz-Target=DeviceFarm_20150623.RenewOffering"
---

# POST /#X-Amz-Target=DeviceFarm_20150623.RenewOffering

`POST /#X-Amz-Target=DeviceFarm_20150623.RenewOffering`

Explicitly sets the quantity of devices to renew for an offering, starting from the <code>effectiveDate</code> of the next period. The API returns a <code>NotEligible</code> error if the user is not permitted to invoke the operation. If you must be able to invoke this operation, contact <a href="mailto:aws-devicefarm-support@amazon.com">aws-devicefarm-support@amazon.com</a>.

## Headers

- `X-Amz-Target` 'DeviceFarm_20150623.RenewOffering', required

## Request body

- RenewOfferingRequest — A request that represents an offering renewal.
  - `offeringId` string, required — The ID of a request to renew an offering.
  - `quantity` integer, required — The quantity requested in an offering renewal.

## Response `200`

Success

- RenewOfferingResult — The result of a renewal offering.
  - `offeringTransaction` object — Represents the status of the offering transaction for the renewal.
    - `offeringStatus` object — The status of an offering transaction.
      - `type` 'PURCHASE' | 'RENEW' | 'SYSTEM' — The type specified for the offering status.
      - `offering` object — Represents the metadata of an offering status.
        - `id` string — The ID that corresponds to a device offering.
        - `description` string — A string that describes the offering.
        - `type` 'RECURRING' — The type of offering (for example, <code>RECURRING</code>) for a device.
        - `platform` 'ANDROID' | 'IOS' — The platform of the device (for example, <code>ANDROID</code> or <code>IOS</code>).
        - `recurringCharges` RecurringCharge[] — Specifies whether there are recurring charges for the offering.
          - `cost` object — The cost of the recurring charge.
            - `amount` number, double — The numerical amount of an offering or transaction.
            - `currencyCode` 'USD' — The currency code of a monetary amount. For example, <code>USD</code> means U.S. dollars.
          - `frequency` 'MONTHLY' — The frequency in which charges recur.
      - `quantity` integer — The number of available devices in the offering.
      - `effectiveOn` string, date-time — The date on which the offering is effective.
    - `transactionId` string — The transaction ID of the offering transaction.
    - `offeringPromotionId` string — The ID that corresponds to a device offering promotion.
    - `createdOn` string, date-time — The date on which an offering transaction was created.
    - `cost` object — The cost of an offering transaction.
      - `amount` number, double — The numerical amount of an offering or transaction.
      - `currencyCode` 'USD' — The currency code of a monetary amount. For example, <code>USD</code> means U.S. dollars.

## Other responses

- `480` — ArgumentException
- `481` — NotFoundException
- `482` — NotEligibleException
- `483` — LimitExceededException
- `484` — ServiceAccountException

---

[API](https://skmtc.net/aws/apis/devicefarm.md) · [All operations](https://skmtc.net/aws/apis/devicefarm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/devicefarm/revisions/a20834382f29/schema)