Detalhes de uma lista de assinaturas

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

Obtém os detalhes das assinaturas por intervalo de data

Query params

page

number

Body params

startDate
datetime

data inicial da busca no formato 2024-01-01T00:00:00

endDate
datetime

data final da busca no formato 2024-01-31T23:59:59

filterBy
enum

pesquisa pela criação, ou alteração do registro

creation
update

Response params (200)

id
string

id da assinatura

createdAt
datetime

data de criação da assinatura

updatedAt
datetime

data de atualização da assinatura

status
enum

status da assinatura

upToDate
awaitingPayment
late
canceled
defaulter
suspended
trial
finished
free
firstInvoiceId
string

id da primeira fatura da assinatura

isFinite
boolean

indica se a assinatura é finita

isUnlimitedInstallments
boolean

indica se a assinatura é parcelamento sem limites

hasNegotiation
boolean

indica se a assinatura possui alguma fatura negociada

interruption
object

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

interruption.createdAt
datetime

data da interrupção

interruption.type
enum

tipo da interrupção

cancel
suspend
interruption.removeAccessDate
datetime

data de remoção do acesso

interruption.reason
string

motivo da interrupção

interruption.origin
string

origem da interrupção

interruption.previousStatus
enum

status anterior

upToDate
awaitingPayment
late
canceled
defaulter
suspended
trial
finished
free
interruption.responsible
string

responsável pela interrupção

recurrence
object

informações sobre a recorrência da assinatura

recurrence.startsAt
datetime

data de início da recorrência

recurrence.nextDueDate
datetime

próxima data de vencimento

recurrence.currentDueDate
datetime

data de vencimento atual

recurrence.finalDueDate
datetime

data do último vencimento

recurrence.finishesAt
datetime

data de finalização da recorrência

recurrence.frequency
object

frequência da recorrência

recurrence.frequency.type
enum

tipo da frequência

daily
weekly
monthly
yearly
recurrence.frequency.value
number

período da frequência

charges
object

informações sobre as cobranças da assinatura

charges.total
number

total de cobranças

charges.current
number

em qual cobrança está atualmente

charges.paid
number

cobranças pagas

charges.pending
number

cobranças pendentes

charges.negotiated
number

cobranças negociadas

products
array of object

produtos da assinatura

products[n].id
string

id do produto

products[n].title
string

Nome do produto

products[n].hasMembershipFee
boolean

indica se o produto possui taxa de adesão

products[n].membershipFee
object

informações sobre a taxa de adesão

products[n].membershipFee.currency
string

moeda da taxa de adesão

products[n].membershipFee.value
number

valor da taxa de adesão

products[n].deliveries
array of string

tipos de entrega do produto

payment
object

informações sobre o pagamento da assinatura

payment.price
object

informações sobre o preço

payment.price.currency
string

moeda do preço

payment.price.value
number

valor do preço

payment.method
enum

método de pagamento

bankslip
creditcard
pix
unknown
payment.installments
number

número de parcelas

client
object

informações sobre o cliente

client.name
string

nome do cliente

client.email
string

email do cliente

client.phone
object

informações sobre o telefone do cliente

client.phone.countryCode
string

código do país (ddi)

client.phone.areaCode
string

código de área (ddd)

client.phone.number
string

número do telefone

Status codes

StatusDescrição
200Success
422Erro de validação

Exemplos

1curl --request GET \
2	--url https://api.eduzz.com/myeduzz/v1/subscriptions \
3	--header 'accept: application/json' \
4	--header 'authorization: Bearer qzrUZcm4dISz/ayXgq7g9+GmusYbXHmIpJ7fbLYDIjUPtNwAN1rrsRZbeJ6e6tAlSUSy3w=='
Response
1{
2  "pages": 49,
3  "page": 2,
4  "itemsPerPage": 15,
5  "totalItems": 733,
6  "items": [
7    {
8      "id": "123456",
9      "createdAt": "2024-01-15T15:00:00.000Z",
10      "updatedAt": "2024-01-20T15:00:00.000Z",
11      "status": "canceled",
12      "firstInvoiceId": "654321",
13      "isFinite": true,
14      "isUnlimitedInstallments": false,
15      "hasNegotiation": false,
16      "interruption": {
17        "createdAt": "2024-01-20T15:00:00.000Z",
18        "type": "cancel",
19        "removeAccessDate": "2024-02-30T15: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      "recurrence": {
26        "startsAt": "2024-01-15T15:00:00.000Z",
27        "nextDueDate": "2024-02-15T15:00:00.000Z",
28        "currentDueDate": "2024-01-15T15:00:00.000Z",
29        "finalDueDate": "2025-06-15T15:00:00.000Z",
30        "finishesAt": "2025-07-15T15:00:00.000Z",
31        "frequency": {
32          "type": "monthly",
33          "value": 1
34        }
35      },
36      "charges": {
37        "total": 6,
38        "current": 1,
39        "paid": 1,
40        "pending": 0,
41        "negotiated": 0
42      },
43      "products": [
44        {
45          "id": "123321",
46          "title": "Teste Assinatura",
47          "hasMembershipFee": false,
48          "membershipFee": {
49            "currency": "BRL",
50            "value": 0
51          },
52          "deliveries": [
53            "files",
54            "external",
55            "nutror",
56            "alpaClass"
57          ]
58        }
59      ],
60      "payment": {
61        "price": {
62          "currency": "BRL",
63          "value": 1000
64        },
65        "method": "bankslip",
66        "installments": 6
67      },
68      "client": {
69        "name": "Fulano de tal",
70        "email": "fulanodetal@eduzz.com",
71        "phone": {
72          "countryCode": "55",
73          "areaCode": "15",
74          "number": "999999999"
75        }
76      }
77    }
78  ]
79}