Sign in

Active at

GET https://{organization}.myguper.com/api/register/membership/{personId}/active-at

Tells whether a person was an active member of a tier program at a given point in time. Useful when you need to gate a feature, award, or message by the membership state at the date of an event (e.g. order placed at).

A member is "active at date" when: joinedAt <= date AND (leftAt IS NULL OR date < leftAt).

The tierConfig can be provided directly, or resolved indirectly from a tag (the tag must be listed in tag_tier_filter for the organization).

Try-it values populated from environment ACME (Demo)


Authentication

Token

Send your user token in the x-guper-authorization header.

Headers

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Always `application/json` for endpoints that accept a JSON body.

Path parameters

Name Type Description
personId * integer Internal Guper person ID.

Query parameters

Name Type Description
tierConfig integer Tier program id. Either `tierConfig` or `tag` is required.
tag integer Tag id mapped to a tier program via `tag_tier_filter`. Used when you do not know the `tierConfig` directly.
date datetime ISO-8601 timestamp to evaluate membership against. Defaults to now.

Responses

{
    "person":     4131293,
    "tierConfig": 1,
    "date":       "2026-04-28T03:51:13+00:00",
    "active":     false
}
Copied to clipboard