---
title: "Gets subscription data by ID"
method: GET
path: "/v1/subscriptions/{subscription_id}"
tags: ["Subscriptions"]
---

# Gets subscription data by ID

`GET /v1/subscriptions/{subscription_id}`

Returns all subscription data corresponding to the specified id

## Path parameters

- `subscription_id` string, required

## Response `200`

The record has been successfully getted

- EdubankSubscription
  - `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)