curl -X GET 'https://api.wovepay.com/v1/subscriptions/list?page=1&pageSize=50&status=ACTIVE' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Assinaturas listadas",
"data": {
"items": [{
"subscriptionId": "sub_abc123",
"externalId": "sub_ext_xyz",
"status": "ACTIVE",
"method": "BOLETO",
"amount": 99.9,
"cycle": "MONTHLY",
"description": "Plano Premium",
"nextDueDate": "2026-08-01",
"createdAt": "2026-07-01T12:00:00.000Z",
"customer": {
"id": "12345678909",
"name": "Maria Silva",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
Listar assinaturas
Lista assinaturas recorrentes com paginação e filtros.
GET
/
subscriptions
/
list
curl -X GET 'https://api.wovepay.com/v1/subscriptions/list?page=1&pageSize=50&status=ACTIVE' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Assinaturas listadas",
"data": {
"items": [{
"subscriptionId": "sub_abc123",
"externalId": "sub_ext_xyz",
"status": "ACTIVE",
"method": "BOLETO",
"amount": 99.9,
"cycle": "MONTHLY",
"description": "Plano Premium",
"nextDueDate": "2026-08-01",
"createdAt": "2026-07-01T12:00:00.000Z",
"customer": {
"id": "12345678909",
"name": "Maria Silva",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
curl -X GET 'https://api.wovepay.com/v1/subscriptions/list?page=1&pageSize=50&status=ACTIVE' \
-H 'X-API-Key: wp_live_SUA_CHAVE'
{
"success": true,
"message": "Assinaturas listadas",
"data": {
"items": [{
"subscriptionId": "sub_abc123",
"externalId": "sub_ext_xyz",
"status": "ACTIVE",
"method": "BOLETO",
"amount": 99.9,
"cycle": "MONTHLY",
"description": "Plano Premium",
"nextDueDate": "2026-08-01",
"createdAt": "2026-07-01T12:00:00.000Z",
"customer": {
"id": "12345678909",
"name": "Maria Silva",
"taxId": "12345678909"
}
}],
"page": 1,
"pageSize": 50,
"total": 1,
"pages": 1
},
"requestId": "req_abc"
}
Parâmetros de query
number
Página (padrão 1).
number
Itens por página (padrão 50, máx. 100).
string
ACTIVE, CANCELED, INACTIVE ou EXPIRED.string
WEEKLY, MONTHLY, QUARTERLY, etc.string
BOLETO, CARD_CREDIT ou PIX.string
Busca em
subscriptionId, externalId, descrição ou cliente.Authorizations
Chave wp_live_... criada em Integrações → Chaves de API no dashboard.
Query Parameters
Required range:
x >= 1Required range:
1 <= x <= 100Example:
"ACTIVE"
Example:
"MONTHLY"
Example:
"BOLETO"

