---
title: "Gets all seller subscriptions"
method: GET
path: "/v1/subscriptions"
tags: ["Subscriptions"]
---

# Gets all seller subscriptions

`GET /v1/subscriptions`

Returns all subscription data corresponding to the seller of the request

## Query parameters

- `page` string, required
- `limit` string, required
- `sort` 'ASC' | 'DESC', required
- `reference_id` string

## Response `200`

The record has been successfully getted

- GetAllSubscriptionsDto
  - `page` number, required — Selected page
  - `limit` number, required — Selected limit per page
  - `sort` 'ASC' | 'DESC', required — Selected sort list
  - `last_page` number, required — Last page
  - `max_items` number, required — Total items for the defined filter
  - `items` EdubankSubscription[], required — Subscriptions found by the defined filter
    - `created_at` string — When the subscription was created. YYYY-MM-DDTHH:mm:ssZ
    - `updated_at` string — Last time subscription was updated. YYYY-MM-DDTHH:mm:ssZ
    - `seller_id` string, required — Edubank seller id
    - `subscription_id` string, required — Edubank subscription id
    - `description` string, required — Brief description of what the signature refers to
    - `reference_id` string, required — Reference ID of your application VARCHAR(500)
    - `buyer_id` string, required — Buyer id
    - `status` 'PROPOSAL' | 'ACTIVE' | 'EXPIRED' | 'CANCELED' | 'SUSPENDED' | 'REACTIVATED', required — Subscription status: PROPOSAL - ACTIVE - CANCELED - SUSPENDED - REACTIVATED
    - `expires_in` string, required — Deadline for signature authorization by the buyer
    - `charge` EdubankSubscriptionCharge, required
      - `start_date` string, required — Date the first invoice will be paid
      - `frequency` 'DAILY' | 'MONTHLY', required — Frequency with which the subscription will be charged. DAILY - MONTHLY
      - `duration` number, required — Subscription duration in relation to the chosen frequency
      - `amount` number, required — Gross amount to be paid. Ex: 2010 = 20.10
    - `notification_url` string, required — URL that will receive a POST call when the transaction changes
    - `subscription_permission` EdubankSubscriptionPermission, required
      - `authorized` boolean, required — Confirmation of buyer authorization to activate subscription
      - `authorized_in` string, required — Card update date/time. YYYY-MM-DDTHH:mm:ssZ
      - `card_id` string, required — Card authorized and registered for signature
    - `references` EdubankSubscriptionReferences[] — References for payment notification that will be sent when payment is received for the subscription
      - `due_date` string, required — Due date that must be considered to consider the respective reference paid. YYYY-MM-DD
      - `reference_id` string, required — Reference ID of your application VARCHAR(500)

## Other responses

- `400` — Client specified an invalid argument, request body or query param
- `401` — The user is unauthorized
- `403` — Authenticated user is not allowed to access this resource
- `404` — The resource was not found
- `408` — Request timeout
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.dev/edubank/apis/api-edubank.md) · [All operations](https://skmtc.dev/edubank/apis/api-edubank/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/edubank/api-edubank/revisions/dce4008191d4/schema)