Get Membership Tiers

curl --request GET 'https://api.mayar.id/hl/v2/memberships/tiers?productId=7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f&limit=10' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here'

{
    "statusCode": 200,
    "messages": "success",
    "data": [
        {
            "id": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
            "createdAt": "2026-01-15T15:07:33.868Z",
            "description": "<p>Access to all premium content and monthly live sessions.</p>\n",
            "finishMembershipAt": null,
            "gracePeriodInDays": 0,
            "isSoldOut": false,
            "isTrialAvailable": true,
            "limit": null,
            "name": "Paket 1",
            "notes": "Access to all premium content and monthly live sessions.",
            "paymentAtStart": true,
            "paymentLinkId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
            "position": null,
            "redirectUrl": "",
            "status": "ACTIVE",
            "trialCredit": null,
            "trialPeriodInDays": 0,
            "updatedAt": "2026-01-15T15:07:33.868Z",
            "upfrontFee": null,
            "userId": "348e083d-315a-4e5c-96b1-5a2a98c48413"
        }
    ],
    "hasMore": false,
    "nextStartingAfter": "1768489653868"
}

curl --request GET 'https://api.mayar.id/hl/v2/memberships/tiers?productId=7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f&limit=10' \
--header 'Authorization: Bearer Paste-Your-API-Key-Here'

{
    "statusCode": 200,
    "messages": "success",
    "data": [
        {
            "id": "9b2d4f6a-8c1e-4a3b-bd5c-6e7f8a9b0c1d",
            "createdAt": "2026-01-15T15:07:33.868Z",
            "description": "<p>Access to all premium content and monthly live sessions.</p>\n",
            "finishMembershipAt": null,
            "gracePeriodInDays": 0,
            "isSoldOut": false,
            "isTrialAvailable": true,
            "limit": null,
            "name": "Paket 1",
            "notes": "Access to all premium content and monthly live sessions.",
            "paymentAtStart": true,
            "paymentLinkId": "7c9d2e1f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
            "position": null,
            "redirectUrl": "",
            "status": "ACTIVE",
            "trialCredit": null,
            "trialPeriodInDays": 0,
            "updatedAt": "2026-01-15T15:07:33.868Z",
            "upfrontFee": null,
            "userId": "348e083d-315a-4e5c-96b1-5a2a98c48413"
        }
    ],
    "hasMore": false,
    "nextStartingAfter": "1768489653868"
}

Endpoint:

https://api.mayar.id/hl/v2/memberships/tiers?productId=(productId)

https://api.mayar.io/hl/v2/memberships/tiers?productId=(productId)

Authorization

string

required

Example:Authorization | Bearer Paste-Your-API-Key-Here

Query Parameters

string

required

The unique identifier of the membership product whose tiers you want to list. If missing or malformed the endpoint responds 400 "Invalid query parameters".

integer

default:"10"

Number of items to return per page. Defaults to 10, with a maximum of 50.

string

Cursor for forward pagination. Pass the nextStartingAfter value from the previous response (a Unix timestamp in milliseconds, as a string) to fetch the next page.

Response

Successful Response

Main Structure (Root)

integer

Status code form API.

string

Status message that describes the status code.

array of object

List of membership tiers for the product.

boolean

Information on whether there is additional data to be retrieved (true/false).

string | null

Cursor to pass as startingAfter to fetch the next page. null when there is no further data.

data Structure (Array Of Object)

string<uuid>

Unique identifier of the membership tier.

string

ISO 8601 timestamp (UTC) of when the tier was created.

string

HTML description of the tier.

string | null

Date the membership finishes, or null when the tier has no fixed end.

integer

Number of grace-period days after the next payment date.

boolean

Whether the tier has reached its member limit.

boolean

Whether a trial is available for the tier.

integer | null

Maximum number of members allowed on the tier, or null when unlimited.

string

Name of the membership tier.

string | null

Free-text notes for the tier.

boolean

Whether payment is collected at the start of the period.

string<uuid>

The product (payment link) ID the tier belongs to.

integer | null

Display position of the tier.

string

Redirect URL configured for the tier.

string

Current status of the tier (for example ACTIVE).

number | null

Trial credit granted, or null when not applicable.

integer

Number of trial days for the tier.

string

ISO 8601 timestamp (UTC) of the last update.

number | null

Upfront fee for joining the tier, or null when none.

string<uuid>

The user ID of the owner of the product.

Errors

object

Returned with messages: "Invalid query parameters" when productId is missing or the query parameters fail validation.

API documentation

Products & payment links

Invoice

Payments

QR / Payment Channels

Transaction

Customer

Membership

Balances

Installment

Discount & Coupon

Bundling

Webhook

Reviews

Credit (Membership / Usage)

SaaS Subscription License

Software License

Authorization

Query Parameters

Response

Main Structure (Root)

data Structure (Array Of Object)

Errors

​Authorization

​Query Parameters

​Response

​Main Structure (Root)

​data Structure (Array Of Object)

​Errors

Authorization

Query Parameters

Response

Main Structure (Root)

data Structure (Array Of Object)

Errors