Entrar

Memberships do cliente (associado / membro do programa)

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

Se um cliente é associado / membro de um programa de fidelidade e desde quando. Retorna todas as memberships de UMA pessoa na organização — ativas (sem leftAt) e históricas (com leftAt). Uma pessoa pode pertencer a mais de um programa tier; uma linha por tierConfig.

É por-cliente (a membership é a fonte da verdade de "essa pessoa é associada"; a tag de membership é só espelho). Não agrega: pra números org-wide (quantos associados, faturamento vindo de associados, conversão de membro em comprador) não há endpoint de relatório ainda — precisa de consulta direta. Use active-at pra saber se a pessoa era membro numa data.

Try-it values populated from environment ACME (Demo)


Autenticação

Token

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

Cabeçalhos

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.

Parâmetros do caminho

Name Type Description
personId * integer Internal Guper person ID.

Respostas

[
    {
        "tierConfig": 1,
        "joinedAt":   "2026-04-28 01:14:27",
        "leftAt":     null,
        "isActive":   true,
        "source":     "tag_hook",
        "sourceRef":  "546"
    },
    {
        "tierConfig": 2,
        "joinedAt":   "2025-09-10 17:02:00",
        "leftAt":     "2026-03-15 09:30:00",
        "isActive":   false,
        "source":     "manual",
        "sourceRef":  "admin:42"
    }
]
Copied to clipboard