Recuperar detalhes de assinatura

curl --request GET \
  --url https://api.malga.io/v1/subscriptions/{id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>'

const options = {method: 'GET', headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}};

fetch('https://api.malga.io/v1/subscriptions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.malga.io/v1/subscriptions/{id}"

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

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "019860b2-feb8-7edf-b5ba-0c48a7a8bd3f",
  "name": "Assinatura Premium com Eventos",
  "clientId": "e234eeb3-483d-4df2-87eb-1e2be5cdaccd",
  "merchantId": "225d39bc-1fbb-480a-90bd-f0caad05d2d0",
  "customerId": "2a8b64ce-904c-4256-b79a-49525808609c",
  "referenceKey": "SUB-PREMIUM-001",
  "currency": "BRL",
  "items": [
    {
      "name": "Ingresso VIP Mensal",
      "amount": 29900,
      "quantity": 1,
      "description": "Acesso VIP premium a eventos mensais",
      "sku": "VIP-EVENT-001",
      "risk": "Low",
      "categoryId": "entertainment",
      "locality": "São Paulo",
      "date": "2025-12-01",
      "type": 1,
      "genre": "Shows e Eventos",
      "tickets": {
        "quantityTicketSale": 1,
        "quantityEventHouse": 0,
        "convenienceFeeValue": 15.5,
        "quantityFull": 1,
        "quantityHalf": 0,
        "batch": 1
      },
      "location": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Centro de Convenções",
        "zipCode": "01310-100",
        "city": "São Paulo",
        "state": "SP",
        "country": "Brasil",
        "district": "Bela Vista",
        "reference": "Próximo ao MASP"
      }
    }
  ],
  "recurrence": {
    "interval": "monthly",
    "cycles": 12,
    "startAt": "2025-08-10",
    "endAt": "2026-08-10",
    "nextDueDate": "2025-07-30"
  },
  "paymentMethod": {
    "type": "credit",
    "card": {
      "cardId": "ebef4e7e-b5d3-49d8-ac8f-b973faaa3ac5"
    },
    "installments": 1
  },
  "trial": {
    "endDate": "2025-08-15"
  },
  "splitRules": [
    {
      "sellerId": "5323ece6-816d-11ed-a1eb-0242ac120002",
      "percentage": 70,
      "processingFee": false,
      "chargeEntireFee": false,
      "chargeRemainderFee": false,
      "liable": true,
      "fares": {
        "mdr": 2.5,
        "fee": 0.3
      }
    }
  ],
  "status": "created",
  "amount": 29900,
  "liveMode": true,
  "lastCycle": {
    "id": "01985cf8-9877-7c09-bbf6-2cceb3384a61",
    "customerId": "2a8b64ce-904c-4256-b79a-49525808609c",
    "merchantId": "225d39bc-1fbb-480a-90bd-f0caad05d2d0",
    "cycle": 1,
    "attempts": 1,
    "status": "authorized",
    "amount": 29900,
    "items": [
      {
        "name": "Ingresso VIP Mensal",
        "amount": 29900,
        "quantity": 1,
        "description": "Acesso VIP premium a eventos mensais",
        "sku": "VIP-EVENT-001",
        "risk": "Low",
        "categoryId": "entertainment",
        "locality": "São Paulo",
        "date": "2025-12-01",
        "type": 1,
        "genre": "Shows e Eventos",
        "tickets": {
          "quantityTicketSale": 1,
          "quantityEventHouse": 0,
          "convenienceFeeValue": 15.5,
          "quantityFull": 1,
          "quantityHalf": 0,
          "batch": 1
        },
        "location": {
          "street": "Av. Paulista",
          "number": "1000",
          "complement": "Centro de Convenções",
          "zipCode": "01310-100",
          "city": "São Paulo",
          "state": "SP",
          "country": "Brasil",
          "district": "Bela Vista",
          "reference": "Próximo ao MASP"
        }
      }
    ],
    "scheduledAt": "2025-07-30",
    "executedAt": "2025-07-30",
    "nextAttemptAt": "2025-07-31",
    "isEmulated": false,
    "emulatedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2025-07-30T20:14:12.599715Z",
    "paymentHistory": [
      {
        "id": "84ec50c5-1fb4-4d6b-bbff-fedc47ba9fa3",
        "createdAt": "2025-07-30T20:14:12.608115Z",
        "executedAt": "2025-07-30T20:14:13.104331Z",
        "chargeId": "6f2a0713-c4cd-4e2d-8603-69855902676d",
        "attemptNumber": 1,
        "status": "authorized",
        "paymentMethod": {
          "type": "credit",
          "card": {
            "cardId": "ebef4e7e-b5d3-49d8-ac8f-b973faaa3ac5"
          },
          "installments": 1
        },
        "error": {
          "message": "Card declined",
          "providerError": {
            "declinedCode": "insufficient_funds",
            "message": "<string>",
            "networkDeniedMessage": "<string>",
            "networkDeniedReason": "<string>",
            "retryable": true
          }
        }
      }
    ]
  },
  "createdAt": "2025-07-31T13:36:40.118822Z",
  "updatedAt": "2025-07-31T13:36:40.118822Z",
  "cancelAtPeriodEnd": true,
  "scheduledCancellationAt": "2025-12-31",
  "scheduledCancellationReason": "Cliente solicitou cancelamento"
}

GET

subscriptions

{id}

Recuperar detalhes de assinatura

curl --request GET \
  --url https://api.malga.io/v1/subscriptions/{id} \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Client-Id: <api-key>'

const options = {method: 'GET', headers: {'X-Client-Id': '<api-key>', 'X-Api-Key': '<api-key>'}};

fetch('https://api.malga.io/v1/subscriptions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.malga.io/v1/subscriptions/{id}"

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

	req.Header.Add("X-Client-Id", "<api-key>")
	req.Header.Add("X-Api-Key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "id": "019860b2-feb8-7edf-b5ba-0c48a7a8bd3f",
  "name": "Assinatura Premium com Eventos",
  "clientId": "e234eeb3-483d-4df2-87eb-1e2be5cdaccd",
  "merchantId": "225d39bc-1fbb-480a-90bd-f0caad05d2d0",
  "customerId": "2a8b64ce-904c-4256-b79a-49525808609c",
  "referenceKey": "SUB-PREMIUM-001",
  "currency": "BRL",
  "items": [
    {
      "name": "Ingresso VIP Mensal",
      "amount": 29900,
      "quantity": 1,
      "description": "Acesso VIP premium a eventos mensais",
      "sku": "VIP-EVENT-001",
      "risk": "Low",
      "categoryId": "entertainment",
      "locality": "São Paulo",
      "date": "2025-12-01",
      "type": 1,
      "genre": "Shows e Eventos",
      "tickets": {
        "quantityTicketSale": 1,
        "quantityEventHouse": 0,
        "convenienceFeeValue": 15.5,
        "quantityFull": 1,
        "quantityHalf": 0,
        "batch": 1
      },
      "location": {
        "street": "Av. Paulista",
        "number": "1000",
        "complement": "Centro de Convenções",
        "zipCode": "01310-100",
        "city": "São Paulo",
        "state": "SP",
        "country": "Brasil",
        "district": "Bela Vista",
        "reference": "Próximo ao MASP"
      }
    }
  ],
  "recurrence": {
    "interval": "monthly",
    "cycles": 12,
    "startAt": "2025-08-10",
    "endAt": "2026-08-10",
    "nextDueDate": "2025-07-30"
  },
  "paymentMethod": {
    "type": "credit",
    "card": {
      "cardId": "ebef4e7e-b5d3-49d8-ac8f-b973faaa3ac5"
    },
    "installments": 1
  },
  "trial": {
    "endDate": "2025-08-15"
  },
  "splitRules": [
    {
      "sellerId": "5323ece6-816d-11ed-a1eb-0242ac120002",
      "percentage": 70,
      "processingFee": false,
      "chargeEntireFee": false,
      "chargeRemainderFee": false,
      "liable": true,
      "fares": {
        "mdr": 2.5,
        "fee": 0.3
      }
    }
  ],
  "status": "created",
  "amount": 29900,
  "liveMode": true,
  "lastCycle": {
    "id": "01985cf8-9877-7c09-bbf6-2cceb3384a61",
    "customerId": "2a8b64ce-904c-4256-b79a-49525808609c",
    "merchantId": "225d39bc-1fbb-480a-90bd-f0caad05d2d0",
    "cycle": 1,
    "attempts": 1,
    "status": "authorized",
    "amount": 29900,
    "items": [
      {
        "name": "Ingresso VIP Mensal",
        "amount": 29900,
        "quantity": 1,
        "description": "Acesso VIP premium a eventos mensais",
        "sku": "VIP-EVENT-001",
        "risk": "Low",
        "categoryId": "entertainment",
        "locality": "São Paulo",
        "date": "2025-12-01",
        "type": 1,
        "genre": "Shows e Eventos",
        "tickets": {
          "quantityTicketSale": 1,
          "quantityEventHouse": 0,
          "convenienceFeeValue": 15.5,
          "quantityFull": 1,
          "quantityHalf": 0,
          "batch": 1
        },
        "location": {
          "street": "Av. Paulista",
          "number": "1000",
          "complement": "Centro de Convenções",
          "zipCode": "01310-100",
          "city": "São Paulo",
          "state": "SP",
          "country": "Brasil",
          "district": "Bela Vista",
          "reference": "Próximo ao MASP"
        }
      }
    ],
    "scheduledAt": "2025-07-30",
    "executedAt": "2025-07-30",
    "nextAttemptAt": "2025-07-31",
    "isEmulated": false,
    "emulatedAt": "2023-11-07T05:31:56Z",
    "createdAt": "2025-07-30T20:14:12.599715Z",
    "paymentHistory": [
      {
        "id": "84ec50c5-1fb4-4d6b-bbff-fedc47ba9fa3",
        "createdAt": "2025-07-30T20:14:12.608115Z",
        "executedAt": "2025-07-30T20:14:13.104331Z",
        "chargeId": "6f2a0713-c4cd-4e2d-8603-69855902676d",
        "attemptNumber": 1,
        "status": "authorized",
        "paymentMethod": {
          "type": "credit",
          "card": {
            "cardId": "ebef4e7e-b5d3-49d8-ac8f-b973faaa3ac5"
          },
          "installments": 1
        },
        "error": {
          "message": "Card declined",
          "providerError": {
            "declinedCode": "insufficient_funds",
            "message": "<string>",
            "networkDeniedMessage": "<string>",
            "networkDeniedReason": "<string>",
            "retryable": true
          }
        }
      }
    ]
  },
  "createdAt": "2025-07-31T13:36:40.118822Z",
  "updatedAt": "2025-07-31T13:36:40.118822Z",
  "cancelAtPeriodEnd": true,
  "scheduledCancellationAt": "2025-12-31",
  "scheduledCancellationReason": "Cliente solicitou cancelamento"
}

Authorizations

X-Client-Id

string

header

required

X-Api-Key

string

header

required

Path Parameters

string<uuid>

required

Id da assinatura que deseja recuperar

Response

Success

string<uuid>

Identificador da assinatura

Example:

"019860b2-feb8-7edf-b5ba-0c48a7a8bd3f"

name

string

Nome da assinatura

Example:

"Assinatura Premium com Eventos"

clientId

string<uuid>

Identificador do client

Example:

"e234eeb3-483d-4df2-87eb-1e2be5cdaccd"

merchantId

string<uuid>

Identificador do merchant

Example:

"225d39bc-1fbb-480a-90bd-f0caad05d2d0"

customerId

string<uuid>

Identificador do cliente

Example:

"2a8b64ce-904c-4256-b79a-49525808609c"

referenceKey

string

Chave de referência da assinatura

Example:

"SUB-PREMIUM-001"

currency

string

Moeda da assinatura

Example:

"BRL"

items

object[]

Show child attributes

recurrence

object

Show child attributes

paymentMethod

object

Show child attributes

trial

object

Período de trial. Só vem quando a assinatura foi criada com trial

Show child attributes

splitRules

object[]

Regras de divisão de valores entre recebedores. Só vem quando a assinatura tem split

Show child attributes

status

enum<string>

Status da assinatura

Available options:

created,

active,

paused,

canceled,

unpaid,

expired,

trialing

Example:

"created"

amount

integer

Valor de cada ciclo em centavos, a soma de amount vezes quantity dos itens

Example:

29900

liveMode

boolean

Indica se a assinatura está em modo de produção

Example:

true

lastCycle

object | null

Último ciclo da assinatura. Sempre presente nas respostas individuais (GET, CREATE, UPDATE), pode ser null se não houver ciclos. Não traz items.

Show child attributes

createdAt

string<date-time>

Example:

"2025-07-31T13:36:40.118822Z"

updatedAt

string<date-time>

Example:

"2025-07-31T13:36:40.118822Z"

cancelAtPeriodEnd

boolean

Indica se a assinatura tem cancelamento agendado. Enquanto for true, recurrence.cycles mostra o ciclo atual mais um, e o valor anterior volta quando o agendamento é removido

Example:

true

scheduledCancellationAt

string<date>

Data efetiva do cancelamento agendado (YYYY-MM-DD). Só vem quando cancelAtPeriodEnd é true. Sem data enviada, é trial.endDate ou, sem trial, recurrence.nextDueDate

Example:

"2025-12-31"

scheduledCancellationReason

string

Motivo do cancelamento agendado. Só vem quando foi informado

Example:

"Cliente solicitou cancelamento"

Visão Geral

Sub-keys

Cards

Tokens

3DS2 Malga

Charges

Sessions

Purchases

Subscriptions

Customers

Merchants

Providers

Vendors

Sellers

Payouts

Plans

Prepayment

Receipts

Flows

Webhooks

Settings

Recuperar detalhes de assinatura

Authorizations

Path Parameters

Response