Skip to main content
GET
/
v1
/
subscription-plans
/
{id}
Get subscription plan by ID
curl --request GET \
  --url https://api-global.fastpaybrasil.com/v1/subscription-plans/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "2RhQg9M7ZCg3X3nMb9W1kX8Q",
  "merchantId": "2RhQg9M7ZCg3X3nMb9W1kX8Q",
  "name": "Plano Premium Mensal",
  "price": 99.9,
  "currency": "BRL",
  "recurrenceType": "monthly",
  "recurrenceInterval": null,
  "endDate": null,
  "buyerMessage": "Bem-vindo ao Plano Premium!",
  "paymentMethods": [
    "credit_card"
  ],
  "imageUrl": "https://storage.example.com/plans/image.png",
  "status": "active",
  "activeSubscriptionsCount": 150,
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

Authorizations

​
Authorization
string
header
required

HTTP Basic authentication. Use your secret key as the username and an empty string as password. The API key should be base64 encoded in the format 'username:' when sending the Authorization header.

Path Parameters

​
id
string
required

Unique subscription plan identifier

Response

Successfully retrieved subscription plan

​
id
string

Unique plan identifier

Example:

"2RhQg9M7ZCg3X3nMb9W1kX8Q"

​
merchantId
string

Merchant ID

Example:

"2RhQg9M7ZCg3X3nMb9W1kX8Q"

​
name
string

Plan name

Example:

"Plano Premium Mensal"

​
price
number

Plan price

Example:

99.9

​
currency
string

Currency code

Example:

"BRL"

​
recurrenceType
enum<string>

Recurrence type

Available options:
weekly,
biweekly,
monthly,
custom
Example:

"monthly"

​
recurrenceInterval
integer | null

Custom recurrence interval in months

Example:

null

​
endDate
string<date-time> | null

Plan end date

Example:

null

​
buyerMessage
string | null

Message displayed to buyer

Example:

"Bem-vindo ao Plano Premium!"

​
paymentMethods
string[]

Accepted payment methods

Example:
["credit_card"]
​
imageUrl
string | null

Plan image URL

Example:

"https://storage.example.com/plans/image.png"

​
status
enum<string>

Plan status

Available options:
active,
inactive
Example:

"active"

​
activeSubscriptionsCount
integer

Number of active subscriptions

Example:

150

​
createdAt
string<date-time>

Creation timestamp

Example:

"2024-01-15T10:30:00.000Z"

​
updatedAt
string<date-time>

Last update timestamp

Example:

"2024-01-15T10:30:00.000Z"