Detalhes do cliente

GET
https://api.eduzz.com/myeduzz/v1/subscriptions/customers/:email
Required scopes:myeduzz_subscriptions_read

Obtém os detalhes do cliente via email

Path params

email

E-mail do cliente

Response params (200)

name
string

Nome do cliente

email
string

E-mail do cliente

phone
object

Informações de telefone do cliente

phone.countryCode
string

Código do pais

phone.areaCode
string

Código de área

phone.number
string

Número

subscriptions
array of object

Informações de assinaturas

subscriptions[n].id
string

Id da assinatura

subscriptions[n].createdAt
datetime

Data de criação da assinatura

subscriptions[n].updatedAt
datetime

Data de atualização da assinatura

subscriptions[n].status
enum

Status da assinatura

upToDate
awaitingPayment
late
canceled
defaulter
suspended
trial
finished
free
subscriptions[n].firstInvoiceId
string

Id da primeira assinatura

subscriptions[n].isFinite
boolean

Indica se a assinatura é finita

subscriptions[n].isUnlimitedInstallments
boolean

Indica se a assinatura é parcelamento sem limites

subscriptions[n].hasNegotiation
boolean

Indica se a assinatura possui alguma fatura negociada

subscriptions[n].interruption
object

Informações sobre a interrupção (suspensão ou cancelamento) da assinatura

subscriptions[n].interruption.createdAt
datetime

Data da interrupção

subscriptions[n].interruption.type
enum

Tipo da interrupção

cancel
suspend
subscriptions[n].interruption.removeAccessDate
datetime

Data de remoção do acesso

subscriptions[n].interruption.reason
string

Motivo da interrupção

subscriptions[n].interruption.origin
string

Origem da interrupção

subscriptions[n].interruption.previousStatus
enum

Status anterior

upToDate
awaitingPayment
late
canceled
defaulter
suspended
trial
finished
free
subscriptions[n].interruption.responsible
string

Responsável pela interrupção

subscriptions[n].recurrence
object

Informações sobre a recorrência da assinatura

subscriptions[n].recurrence.startsAt
datetime

Data de início da recorrência

subscriptions[n].recurrence.nextDueDate
datetime

Próxima data de vencimento

subscriptions[n].recurrence.currentDueDate
datetime

Data de vencimento atual

subscriptions[n].recurrence.finalDueDate
datetime

Data do último vencimento

subscriptions[n].recurrence.finishesAt
datetime

Data de finalização da recorrência

subscriptions[n].recurrence.frequency
object

Frequência da recorrência

subscriptions[n].recurrence.frequency.type
enum

Tipo da frequência

daily
weekly
monthly
yearly
subscriptions[n].recurrence.frequency.value
number

Período da frequência

subscriptions[n].charges
object

Informações sobre as cobranças da assinatura

subscriptions[n].charges.total
number

Total de cobranças

subscriptions[n].charges.current
number

Em qual cobrança está atualmente

subscriptions[n].charges.paid
number

Cobranças pagas

subscriptions[n].charges.pending
number

Cobranças pendentes

subscriptions[n].charges.negotiated
number

Cobranças negociadas

subscriptions[n].products
array of object

Produtos da assinatura

subscriptions[n].products[n].id
string

Id do produto

subscriptions[n].products[n].title
string

Nome do produto

subscriptions[n].products[n].hasMembershipFee
boolean

Indica se o produto possui taxa de adesão

subscriptions[n].products[n].membershipFee
object

Informações sobre a taxa de adesão

subscriptions[n].products[n].membershipFee.currency
string

Moeda da taxa de adesão

subscriptions[n].products[n].membershipFee.value
number

Valor da taxa de adesão

subscriptions[n].payment
object

Informações sobre o pagamento da assinatura

subscriptions[n].payment.price
object

Informações sobre o preço

subscriptions[n].payment.price.currency
string

Moeda do preço

subscriptions[n].payment.price.value
number

Valor do preço

subscriptions[n].payment.method
enum

Método de pagamento

bankslip
creditcard
pix
unknown
subscriptions[n].payment.installments
number

Número de parcelas

subscriptions[n].client
object

Informações sobre o cliente

subscriptions[n].client.name
string

Nome do cliente

subscriptions[n].client.email
string

E-mail do cliente

subscriptions[n].client.phone
object

Informações sobre o telefone do cliente

subscriptions[n].client.phone.countryCode
string

Código do país (ddi)

subscriptions[n].client.phone.areaCode
string

Código de área (ddd)

subscriptions[n].client.phone.number
string

Número do telefone

Status codes

StatusDescrição
200Success
404Assinatura não encontrada
422Erro de validação

Exemplos

1curl --request GET \
2	--url https://api.eduzz.com/myeduzz/v1/subscriptions/customers/fulanodetal@eduzz.com \
3	--header 'Accept: application/json' \
4	--header 'Content-Type: application/json' \
5	--header 'authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
Response
1{
2  "name": "fulanodetal",
3  "email": "fulanodetal@eduzz.com",
4  "phone": {
5    "countryCode": "55",
6    "areaCode": "15",
7    "number": "999999999"
8  },
9  "subscriptions": [
10    {
11      "id": "2060691",
12      "startDate": "2024-01-15T15:00:00.000Z",
13      "updatedAt": null,
14      "status": "upToDate",
15      "firstInvoiceId": "51128029",
16      "interruption": {
17        "createdAt": "2024-01-15T15:00:00.000Z",
18        "type": "cancel",
19        "removeAccessDate": "2024-01-15T15:00:00.000Z",
20        "reason": "Cliente não está realizando os pagamentos corretamente",
21        "origin": "Myeduzz",
22        "previousStatus": "late",
23        "responsible": "Atendimento Eduzz"
24      },
25      "isUnlimitedInstallments": false,
26      "hasNegotiation": false,
27      "isFinite": false,
28      "recurrence": {
29        "startsAt": "2024-01-15T15:00:00.000Z",
30        "nextDueDate": "2024-02-15T15:00:00.000Z",
31        "currentDueDate": "2024-01-15T15:00:00.000Z",
32        "finalDueDate": "2025-01-09T15:00:00.000Z",
33        "finishesAt": "2025-01-09T15:00:00.000Z",
34        "frequency": {
35          "type": "monthly",
36          "value": 1
37        }
38      },
39      "products": [
40        {
41          "id": "1737509",
42          "name": "Teste Assinatura",
43          "hasMembershipFee": false,
44          "membershipFee": {
45            "currency": "BRL",
46            "value": 0
47          }
48        }
49      ],
50      "payment": {
51        "price": {
52          "currency": "BRL",
53          "value": 1000
54        },
55        "method": "bankslip",
56        "installments": 6
57      },
58      "charges": {
59        "total": 6,
60        "current": 2,
61        "paid": 1,
62        "pending": 3,
63        "negotiated": 0
64      }
65    }
66  ]
67}