List events
sequence, highest first), each the very body its webhooks carry: the same id, the same data, byte for byte once parsed. Read it to catch up on what an endpoint missed while it was down or turned off.available_since are not served; every page says available_since.created_at is set when the event's transaction begins, a moment before it is visible here: an event can appear below one you have already read. When you poll for what is new, do not stop at the first id you know: page on until created_at is a minute older than the newest you held, and skip the ids you have seen.Limit: 1,000 calls a minute per API key.Guide: Webhooks.
Headers
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
Query Parameters
Only events of this name.
One ofsubscription.createdsubscription.renewal_upcomingsubscription.renewedsubscription.payment_failedsubscription.stoppedsubscription.cancelledsubscription.resumedsubscription.endedsubscription.expiredsubscription.access_grantedsubscription.access_revokedsubscription.pausedsubscription.unpaused
Example:subscription.payment_failed
Only events about this subscription, by its id. Another project's id finds nothing.
Example:cmg1x0abc0001
How many events to answer.
Default:25
Limits:1 to 100
Example:25
The id of the last event of the previous page. The next page starts after it.
Example:evt_cmg1x0evt0001
Response
application/jsonOne page of events.
Headers
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
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.
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.
Limits:at least 1
What is left of them in the current minute.
Limits:at least 0
Seconds until the count starts again.
Limits:at least 0
Newest first. Maybe empty.
Show child attributesHide child attributes
The event's id, the one its webhook bodies carry.
Always event.
One ofevent
The event's name, as its webhook is named.
One ofsubscription.createdsubscription.renewal_upcomingsubscription.renewedsubscription.payment_failedsubscription.stoppedsubscription.cancelledsubscription.resumedsubscription.endedsubscription.expiredsubscription.access_grantedsubscription.access_revokedsubscription.pausedsubscription.unpaused
When the event happened: the moment data describes, but for an access event or a cancellation reaching its end, written when Mesub wrote the event, whose detail.changed_at is that moment.
The Solana network the subscription is on.
One ofdevnetmainnet-beta
The version of this contract data and detail are written in, as Mesub-Version names them. Set when the body is written, and kept with it.
One of2026-10-02
Its place among the events of this subscription: 1, 2, 3... in the order they happened, two events of one change included. Deliveries may arrive in any order: apply a subscription's events in the order of sequence, and skip one lower than the last you applied for it. Absent on bodies written before Mesub numbered events, and on an event it could not number. An event without sequence cannot be placed: read the subscription's state now, with Retrieve a subscription or Check access, rather than applying its data.
Limits:at least 1
The subscription as it stood right after the change that raised this event, as Retrieve a subscription would have answered it then, however late the delivery. Events raised by the same change share it, and detail says what each event is about: a last retry that fails raises subscription.payment_failed and subscription.stopped, both showing status: stopped, the failure's cause in payment_failed's detail.
Show child attributesHide child attributes
Where it stands. Unlike GET /v1/access, may be expired: a checkout nobody signed. cancelled while the cancellation runs, ended once its end passed. For a few minutes after a plan's end date it can still read active or unpaid with access false, never ended with access true.
One ofpendingactiveunpaidcancelledstoppedendedfailedexpiredsuperseded
True on a seat parked over the project's subscriber limit, its status unchanged. subscription.paused and subscription.unpaused are sent when it changes.
Why it ended. Set only when status is ended. Null on every other status, and on an old subscription that ended with no reason recorded.
One ofcancelledplan_removedplan_replacedplan_endedclosed_elsewhereclosed
Why a payment is late, as the last failed charge found it. Set only when status is unpaid, or stopped for the payment it stopped on. Null on every other status, and when Mesub cannot name the cause.
One ofinsufficient_balanceapproval_revokedauthority_closed
Why it stopped. Set only when status is stopped. Null on every other status, and on a subscription that stopped before Mesub recorded why.
- out_of_retries: every retry of the missed payment failed. The subscription stays open on Solana: the subscriber can come back, or cancel it and close it once the period ends.
- retry_deadline_passed: on the Free tier, the last day to pay the missed payment passed.
- authority_closed: the wallet closed the account that lets Mesub charge it, for good. Nobody can charge this subscription again, and the subscriber cannot come back on it. They can close it now (closable) to get its deposit back.
One ofout_of_retriesretry_deadline_passedauthority_closed
Whether this subscription grants access now, as GET /v1/access answers it. False from the plan's end date on, whatever period was paid for.
late while a charge missed and a retry is pending. none where nothing is being billed.
One ofpaidlatenone
Since when every charge of this subscription is held for a reason that is not the customer's. Null when none is. status and payment_status do not change for it, and Mesub keeps trying. access ends at access_until, and comes back with the first charge that goes through, with nothing for the customer to sign.
Why the charges are held. Null with blocked_since. Nine values name the plan's own setup, yours to fix or, for the last two, the token issuer's to lift: puller_not_allowed (Mesub's puller was taken off the plan on chain), receiver_not_allowed (the receiving wallet is not among the plan's destinations), receiver_account_missing (it has no account for the plan's token, and nobody else can be paid), receiver_account_frozen (its account for the plan's token is frozen), receiver_account_needs_memo (that account requires a memo on every transfer in, which Mesub's charges do not carry), receiver_account_confidential_only (that account takes confidential transfers only), mint_gone (the token no longer exists), mint_paused (the token's issuer paused it: no payment in it moves, and Mesub charges again once the pause is lifted) and mint_transfer_hook (the token's issuer made its transfers run a program of theirs, which Mesub does not support yet: it charges again if the issuer removes it). mesub is any cause on Mesub's side: nothing for you to fix. Mesub may add a value: keep a default branch.
One ofpuller_not_allowedreceiver_not_allowedreceiver_account_missingreceiver_account_frozenreceiver_account_needs_memoreceiver_account_confidential_onlymint_gonemint_pausedmint_transfer_hookmesub
The plan's slug.
The wallet that pays.
Where the customer's notices go, as given at creation.
Your own id for the customer, as given at creation.
The start of the period last paid for. Null before the first.
The end of that period.
The next charge on a running subscription. Null when a retry is pending instead, and when the plan's end date leaves no charge to make: a subscription in its last period has none.
The next retry on a late one. Null when the plan ends before it.
On Free only: when retries by hand close for the missed period, or the plan's end date when that comes first.
Which retry comes at next_retry_at: 1 is the first after the missed charge. Null unless Mesub retries on its own, and when next_retry_at is null.
How many retries the missed period gets. Null unless Mesub retries on its own.
When access ends unless a charge renews it. Never later than the plan's end date, where access stops for everybody. Null while access is false. On a subscription whose charges are blocked (blocked_since), the date access ends if nothing is collected by then: the end of the period after the one paid for, or sooner when the cause is the plan's setup, the end of the grace the plan gives a late payment.
Whether the subscriber can close the subscription on Solana now, which returns its deposit to their wallet: a cancellation whose end has passed, a subscription that ended with its plan, or one stopped with stop_reason authority_closed. As Mesub last knew the chain: the close reads the chain again, and may still be refused.
When the subscriber can close it, if not now: the end of the period a cancellation set. Null when closable is true, and when no date is known yet: a running subscription, or one stopped with out_of_retries, must be cancelled first. As Mesub last knew the chain, like closable.
When it was reserved.
When its first payment landed.
The event's own fields, as its webhook describes them under detail.
Whether another page follows.
When Mesub began keeping events in this form. Events before it are not served, whatever the window: their webhooks carried the older shape.
Authorizations
Bearer <API key>. The project's API key, which starts with SUB_. Keep it on your server. Where to get it.
curl "https://api.mesub.io/v1/events" \ -H "Authorization: Bearer $MESUB_API_KEY"
{ "data": [ { "id": "evt_cmg1x0evt0001", "object": "event", "type": "subscription.renewed", "created_at": "2026-01-31T00:01:00.000Z", "network": "mainnet-beta", "api_version": "2026-10-02", "sequence": 3, "data": { "id": "cmg1x0abc0001", "status": "active", "paused": false, "end_reason": null, "late_reason": null, "stop_reason": null, "access": true, "payment_status": "paid", "blocked_since": null, "blocked_reason": null, "plan": "pro", "wallet": "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin", "email": "[email protected]", "external_id": "user_123", "current_period_start": "2026-01-31T00:00:00.000Z", "current_period_end": "2026-03-02T00:00:00.000Z", "next_charge_at": "2026-03-02T00:00:00.000Z", "next_retry_at": null, "retry_deadline": null, "next_retry_number": null, "retries_allowed": null, "access_until": "2026-03-02T00:00:00.000Z", "closable": false, "closable_from": null, "created_at": "2026-01-01T00:00:00.000Z", "confirmed_at": "2026-01-01T00:00:05.000Z" }, "detail": { "amount": "9990000", "amount_received": "9990000", "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "period_start": "2026-01-31T00:00:00.000Z", "period_end": "2026-03-02T00:00:00.000Z", "signature": "5wHu1qwD4kLDLoREEPBpKvGvhbxWFxFFfr5nQq7dxAsRRDXvHRqpNvfsCvC1qzjWQhqmPtBb8LnZjKmvpehJqSWk" } } ], "has_more": false, "available_since": "2026-10-16T09:00:00.000Z" }