# Pagar.me Subscriptions API

**Canonical:** https://apis.io/apis/pagar-me/pagar-me-subscriptions-api/  
**Provider:** Pagar.me — https://apis.io/providers/pagar-me/  
**Base URL:** https://api.pagar.me/core/v5  
**Documentation:** https://docs.pagar.me/reference

Pagar.me Subscriptions API is one of 30 APIs that [Pagar.me](https://apis.io/providers/pagar-me/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include Subscription. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

The Subscriptions API from Pagar.me — 17 operation(s) for subscriptions.

## Operations (27)

| Method | Path | Summary |
|---|---|---|
| POST | `/subscriptions` | Criar assinatura de plano |
| GET | `/subscriptions` | Listar assinaturas |
| GET | `/subscriptions/{subscription_id}` | Obter assinatura com split |
| DELETE | `/subscriptions/{subscription_id}` | Cancelar assinatura |
| POST | `/subscriptions/{subscription_id}/cycles` | Renovar ciclo |
| GET | `/subscriptions/{subscription_id}/cycles` | Listar ciclos |
| GET | `/subscriptions/{subscription_id}/cycles/{cycle_id}` | Obter ciclo |
| POST | `/subscriptions/{subscription_id}/cycles/{cycle_id}/pay` | Criar fatura |
| POST | `/subscriptions/{subscription_id}/discounts` | Incluir desconto |
| GET | `/subscriptions/{subscription_id}/discounts` | Listar descontos |
| GET | `/subscriptions/{subscription_id}/discounts/{discount_id}` | Obter desconto |
| DELETE | `/subscriptions/{subscription_id}/discounts/{discount_id}` | Remover desconto |
| POST | `/subscriptions/{subscription_id}/increments` | Incluir incremento |
| GET | `/subscriptions/{subscription_id}/increments` | Listar incrementos |
| GET | `/subscriptions/{subscription_id}/increments/{increment_id}` | Obter incremento |
| DELETE | `/subscriptions/{subscription_id}/increments/{increment_id}` | Remover incremento |
| POST | `/subscriptions/{subscription_id}/items` | Incluir item |
| PUT | `/subscriptions/{subscription_id}/items/{item_id}` | Editar item |
| DELETE | `/subscriptions/{subscription_id}/items/{item_id}` | Remover item |
| POST | `/subscriptions/{subscription_id}/items/{item_id}/usages` | Incluir uso |
| GET | `/subscriptions/{subscription_id}/items/{item_id}/usages` | Listar uso |
| DELETE | `/subscriptions/{subscription_id}/items/{item_id}/usages/{usage_id}` | Remover uso |
| POST | `/subscriptions/{subscription_id}/manual-billing` | Ativar faturamento manual |
| DELETE | `/subscriptions/{subscription_id}/manual-billing` | Desativar faturamento manual |
| PATCH | `/subscriptions/{subscription_id}/metadata` | Editar metadados da assinatura |
| PATCH | `/subscriptions/{subscription_id}/minimum_price` | Editar preço mínimo da assinatura |
| PATCH | `/subscriptions/{subscription_id}/payment-method` | Editar meio de pagamento da assinatura |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/pagar-me/refs/heads/main/openapi/pagar-me-subscriptions-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/pagar-me/refs/heads/main/json-schema/pagar-me-dispute-schema.json

## Other Pagar.me APIs (12)

- [Pagar.me Orders API](https://apis.io/apis/pagar-me/pagarme-orders-api/)
- [Pagar.me Charges API](https://apis.io/apis/pagar-me/pagarme-charges-api/)
- [Pagar.me Customers API](https://apis.io/apis/pagar-me/pagarme-customers-api/)
- [Pagar.me Cards API](https://apis.io/apis/pagar-me/pagarme-cards-api/)
- [Pagar.me Plans API](https://apis.io/apis/pagar-me/pagarme-plans-api/)
- [Pagar.me Subscriptions API](https://apis.io/apis/pagar-me/pagarme-subscriptions-api/)
- [Pagar.me Recipients API](https://apis.io/apis/pagar-me/pagarme-recipients-api/)
- [Pagar.me Transfers API](https://apis.io/apis/pagar-me/pagarme-transfers-api/)
- [Pagar.me Balance Operations API](https://apis.io/apis/pagar-me/pagarme-balance-operations-api/)
- [Pagar.me Receivables API](https://apis.io/apis/pagar-me/pagarme-receivables-api/)
- [Pagar.me Anticipation API](https://apis.io/apis/pagar-me/pagarme-anticipation-api/)
- [Pagar.me Settlements API](https://apis.io/apis/pagar-me/pagarme-settlements-api/)

## Tags

Subscription

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pagar-me/pagar-me-subscriptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pagar-me/.