---
title: "Get user subscription offers"
method: GET
path: "/subscription/offers"
tags: ["Subscription"]
---

# Get user subscription offers

`GET /subscription/offers`

Retrieves a paginated list of subscription offers for the authenticated user

## Query parameters

- `currency` 'EUR' | 'GBP' | 'USD'
- `interval` 'day' | 'week' | 'month' | 'year'
- `isArchived` boolean
- `search` string
- `merchantId` string
- `page` number
- `limit` number

## Response `200`

- object
  - `data` SubscriptionOfferDto[]
    - `id` string, required — The unique identifier of the subscription offer
    - `name` string, required — The name of the subscription offer
    - `description` string, required — The description of the subscription offer
    - `amountInCents` number, required — The amount in cents for the subscription offer
    - `entryFeesInCents` number, nullable — Optional entry fees in cents for the first payment. If set, the first payment will be entryFeesInCents, and subsequent recurring payments will be amountInCents.
    - `currency` string, required — The currency of the subscription offer
    - `interval` 'day' | 'week' | 'month' | 'year', required — The billing interval
    - `intervalCount` number, required — The billing interval count
    - `cycleCount` number — The cycle count
    - `trialPeriodDays` number, nullable — Trial period length in days for subscriptions created from this offer. If present and >0, subscriptions will have a free trial period.
    - `isArchived` boolean, required — Whether the offer is archived
    - `sessionCustomizationBgColor` string, nullable — The background color for the checkout session
    - `sessionCustomizationFontColor` string, nullable — The font color for the checkout session
    - `sessionCustomizationLogoUrl` string, nullable — The logo URL for the checkout session
    - `sessionCustomizationMerchantName` string, nullable — The merchant name for the checkout session
    - `merchantName` string, nullable — The merchant name from the user account
    - `statementDescriptor` string, nullable — Optional statement descriptor (max 11 characters) shown on the customer's bank statement
    - `successUrl` string, nullable — The success URL for subscription first payment
    - `cancelUrl` string, nullable — The cancel URL for subscription first payment
    - `discordGuildId` string, nullable — Discord server (guild) ID where the role should be assigned
    - `discordRoleId` string, nullable — Discord role ID to assign to subscribers
    - `userId` string, required — The user ID who owns the subscription offer
    - `createdAt` string, date-time, required — The creation date
    - `updatedAt` string, date-time, required — The last update date
  - `meta` object
    - `total` number
    - `lastPage` number
    - `currentPage` number
    - `perPage` number
    - `prev` number
    - `next` number

## Other responses

- `401` — Unauthorized - Invalid API key

---

[API](https://skmtc.dev/inflowpay/apis/inflow-api.md) · [All operations](https://skmtc.dev/inflowpay/apis/inflow-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inflowpay/inflow-api/revisions/3012dd3dd14a/schema)