Plans

Retrieve a plan

One plan: its name, its price in the smallest unit and as a person counts it, its period, its token, its status, its end date, and whether it takes new subscribers now.

A plan past its end date takes no new subscriber: available is false, and Create a subscription answers plan_ended.

GEThttps://api.mesub.io/v1/plans/{slug}

GETRetrieve a plan

https://api.mesub.io/v1/plans/{slug}

Calls are real. They go to https://api.mesub.io and act on the project the key belongs to.

Authorization

API keyBearerrequired

The key stays in this browser and is sent only to the API. It is not stored or logged by the docs.

Keep it until this tab closes

Path

slugstringrequired

Fill slug to send.

cURL

curl "https://api.mesub.io/v1/plans/{slug}" \
  -H "Authorization: Bearer $MESUB_API_KEY"

Response

Send the request to see the status, the headers and the body.

Limit: 1,000 calls a minute per API key.

Headers

Mesub-Versionenum<string>

The version of this contract the call is written against. Without it, the call is served as the first version, 2026-10-02. Any other value is refused with 400 unsupported_version.

One of2026-10-02

Path Parameters

slugstringrequired

The plan's slug: lowercase letters, digits and single hyphens.

Response

application/json

The plan.

Headers

Mesub-Versionenum<string>

The version the answer is written in: the one asked for, or 2026-10-02 when the call named none, or one this API does not serve.

One of2026-10-02

Mesub-Request-Idstring

The id Mesub gave this request, on every answer, errors included, and in request_id on an error body. Quote it to Mesub support to find the request in our logs. Written by Mesub on each request: one sent with the request is ignored.

X-RateLimit-Limitintegernot always present

The calls this route allows the API key in a minute, or the IP of a call without a valid key. Sent on every answer the rate limit counted.

X-RateLimit-Remainingintegernot always present

What is left of them in the current minute.

X-RateLimit-Resetintegernot always present

Seconds until the count starts again.

slugstring

How your code names the plan.

namestring

The plan's name as you filled it, or its slug when you filled none.

descriptionstring | null

project_namestring

The project's name.

logo_urlstring | null

The project's logo.

amountstring

The price per period, in the token's smallest unit, as a string.

amount_displaystring

The price as a person counts it: 9.99.

amount_usdstring | null

The price in US dollars, as a decimal string: 9.99. An estimate, counted at the latest price Mesub knows for the token. Null when Mesub has no price for it.

decimalsinteger

The token's decimals.

symbolstring | null

The token's symbol, for a token Mesub vouches for: USDC, USDT or PYUSD. Null for any other token, whose symbol is under token.

mintstring

The token's mint address.

tokenobject

What Mesub found for the token, by its exact mint. Nothing in it comes from you. A symbol is free text on chain, and a token that copies a known one is a common scam: show a token that is not verified as unverified, and keep its mint in view.

Show child attributesHide child attributes

symbolstring | null

The token's symbol. Null when none was found, and on an unverified token whose symbol is that of a stablecoin Mesub vouches for.

namestring | null

The token's name. Null when none was found, and on an unverified token whose name is that of a stablecoin Mesub vouches for.

logo_urlstring | null

The token's logo. Null when none was found.

verifiedboolean

True for a token Mesub vouches for, and for one Jupiter marks as verified.

period_hoursinteger

The length of a period, in hours. 720 is thirty days.

networkenum<string>

The Solana cluster the plan is on.

One ofdevnetmainnet-beta

statusenum<string>

sunset: closed to new subscribers, its subscribers still paying until ends_at.

One ofactivesunset

availableboolean

Whether it takes new subscribers now: active, before its end date, and the project not full.

ends_atstring<date-time> | null

The plan's end date: when it stops charging, and when access stops for every subscriber, whatever period they paid for. Set on every sunset plan. Null when it has no end.

Authorizations

Authorizationstring · headerrequired

Bearer <API key>. The project's API key, which starts with SUB_. Keep it on your server. Where to get it.

Ask AI about this page

Request example

curl "https://api.mesub.io/v1/plans/pro" \
  -H "Authorization: Bearer $MESUB_API_KEY"

Response example

{
    "slug": "pro",
    "name": "Pro",
    "description": "Everything in Free, plus analytics.",
    "project_name": "Fraise",
    "logo_url": "https://cdn.mesub.io/logos/3f9c2a7e5b1d4c68.webp",
    "amount": "9990000",
    "amount_display": "9.99",
    "amount_usd": "9.99",
    "decimals": 6,
    "symbol": "USDC",
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "token": {
        "symbol": "USDC",
        "name": "USD Coin",
        "logo_url": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
        "verified": true
    },
    "period_hours": 720,
    "network": "mainnet-beta",
    "status": "active",
    "available": true,
    "ends_at": null
}