List subscriptions

curl --request GET \
  --url https://api.fincle.com.br/subscriptions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fincle.com.br/subscriptions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fincle.com.br/subscriptions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fincle.com.br/subscriptions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fincle.com.br/subscriptions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": "cmdh1m4q2000e1yjn7f2z9t5v",
      "status": "active",
      "nextChargeAt": "2026-12-12T14:08:06.000Z"
    }
  ],
  "stats": {
    "activeSubscriptions": 1,
    "monthlyRecurringRevenueInCents": 19900,
    "lifetimeValueInCents": 19900,
    "churnRate": 0,
    "totalSubscriptions": 1,
    "cancelledSubscriptions": 0
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

{
  "success": false,
  "message": "Não autorizado"
}

GET

subscriptions

List subscriptions

curl --request GET \
  --url https://api.fincle.com.br/subscriptions \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.fincle.com.br/subscriptions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fincle.com.br/subscriptions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fincle.com.br/subscriptions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fincle.com.br/subscriptions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": [
    {
      "id": "cmdh1m4q2000e1yjn7f2z9t5v",
      "status": "active",
      "nextChargeAt": "2026-12-12T14:08:06.000Z"
    }
  ],
  "stats": {
    "activeSubscriptions": 1,
    "monthlyRecurringRevenueInCents": 19900,
    "lifetimeValueInCents": 19900,
    "churnRate": 0,
    "totalSubscriptions": 1,
    "cancelledSubscriptions": 0
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1,
    "totalPages": 1
  }
}

{
  "success": false,
  "message": "Não autorizado"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

productId

string

offerId

integer

Required range: x > 0

status

enum<string>

Available options:

active,

overdue,

cancelled,

failed,

completed

string

period

enum<string>

Available options:

all,

last_30_days,

this_month,

last_3_months

dateFrom

string<date-time>

dateTo

string<date-time>

page

integer

default:1

Required range: x > 0

limit

integer

default:20

Required range: 0 < x <= 100

Response

Request processed successfully.

success

enum<boolean>

required

Available options:

true

stats

object

required

Show child attributes

pagination

object

required

Show child attributes

data

any

Authentication

Charges

Subscriptions

Transactions

Refunds

Infractions and MED

Webhooks

Balance and transfers

List subscriptions

Authorizations

Query Parameters

Response