---
title: "GET /v1/partners/{partnersId}/promotions"
method: GET
path: "/v1/partners/{partnersId}/promotions"
tags: ["partners"]
---

# GET /v1/partners/{partnersId}/promotions

`GET /v1/partners/{partnersId}/promotions`

## Request

- Base URL: `https://paymentsresellersubscription.googleapis.com`
- URL: `https://paymentsresellersubscription.googleapis.com/v1/partners/{partnersId}/promotions`
- Auth: OAuth 2 and OAuth 2
  - Implicit: `https://accounts.google.com/o/oauth2/auth`
  - Scopes: `https://www.googleapis.com/auth/sdm.service`
  - Authorization code: `https://accounts.google.com/o/oauth2/auth`
  - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/sdm.service`
- TypeScript: <https://skmtc.dev/google/apis/paymentsresellersubscription/docs/v1/partners/:partnersId/promotions/get.ts> (a function with typed inputs; its response is checked against the schema)

Currently, it doesn't support **YouTube** promotions. Retrieves the promotions, such as free trial, that can be used by the partner. It should be authenticated with a service account.

## Path parameters

- `partnersId` string, required

## Query parameters

- `filter` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListPromotionsResponse: Response that contains the promotions.
  - `nextPageToken` string: A token, which can be sent as `page_token` to retrieve the next page. If this field is empty, there are no subsequent pages.
  - `promotions` Promotion[]: The promotions for the specified partner.
    - `applicableProducts` string[]: Output only. The product ids this promotion can be applied to.
    - `endTime` string, google-datetime: Optional. Specifies the end time (exclusive) of the period that the promotion is available in. If unset, the promotion is available indefinitely.
    - `freeTrialDuration` Duration: Describes the length of a period of a time.
      - `count` integer: number of duration units to be included.
      - `unit` 'UNIT_UNSPECIFIED' | 'MONTH' | 'DAY' | 'HOUR': The unit used for the duration
    - `introductoryPricingDetails` PromotionIntroductoryPricingDetails: The details of a introductory pricing promotion.
      - `introductoryPricingSpecs` PromotionIntroductoryPricingDetailsIntroductoryPricingSpec[]: Output only. Specifies the introductory pricing periods.
        - `discountAmount` Amount: Describes the amount unit including the currency code.
          - `amountMicros` string, int64: Required. Amount in micros (1_000_000 micros = 1 currency unit)
          - `currencyCode` string: Required. Currency codes in accordance with [ISO-4217 Currency Codes] (https://en.wikipedia.org/wiki/ISO_4217). For example, USD.
        - `discountRatioMicros` string, int64: Output only. The discount percentage in micros. For example, 50,000 represents 5%.
        - `recurrenceCount` integer: Output only. The duration of an introductory offer in billing cycles.
        - `regionCode` string: Output only. 2-letter ISO region code where the product is available in. Ex. "US".
    - `name` string: Identifier. Response only. Resource name of the subscription promotion. It will have the format of "partners/{partner_id}/promotion/{promotion_id}"
    - `promotionType` 'PROMOTION_TYPE_UNSPECIFIED' | 'PROMOTION_TYPE_FREE_TRIAL' | 'PROMOTION_TYPE_INTRODUCTORY_PRICING': Output only. Specifies the type of the promotion.
    - `regionCodes` string[]: Output only. 2-letter ISO region code where the promotion is available in. Ex. "US" Please refer to: https://en.wikipedia.org/wiki/ISO_3166-1
    - `startTime` string, google-datetime: Optional. Specifies the start time (inclusive) of the period that the promotion is available in.
    - `titles` GoogleTypeLocalizedText[]: Output only. Localized human readable name of the promotion.
      - `languageCode` string: The text's BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
      - `text` string: Localized string in the language corresponding to language_code below.

---

[API](https://skmtc.dev/google/apis/paymentsresellersubscription.md) - [All operations](https://skmtc.dev/google/apis/paymentsresellersubscription/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/paymentsresellersubscription/revisions/88dd477f884b?raw)