Preview subscription transition

curl --request POST \
  --url https://api.hyperline.co/v2/subscriptions/transitions/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transition_id": "<string>"
}
'

import requests

url = "https://api.hyperline.co/v2/subscriptions/transitions/preview"

payload = { "transition_id": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({transition_id: '<string>'})
};

fetch('https://api.hyperline.co/v2/subscriptions/transitions/preview', 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.hyperline.co/v2/subscriptions/transitions/preview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'transition_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.hyperline.co/v2/subscriptions/transitions/preview"

	payload := strings.NewReader("{\n  \"transition_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.hyperline.co/v2/subscriptions/transitions/preview")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"transition_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperline.co/v2/subscriptions/transitions/preview")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"transition_id\": \"<string>\"\n}"

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

{
  "transition_documents": [
    {
      "id": "inv_1eTaiytfA0i2Va",
      "number": "INV-35",
      "type": "invoice",
      "document_name": null,
      "status": "paid",
      "reference": "V0KAHOU6J3",
      "purchase_order": "PO-12345",
      "currency": "EUR",
      "source": "hyperline",
      "total_amount": 24000,
      "amount_due": 0,
      "amount_paid": 24000,
      "amount_fixed": 20000,
      "amount_excluding_tax": 20000,
      "tax_rate": 123,
      "tax_amount": 4000,
      "tax_scheme": "standard",
      "discount_amount": 0,
      "conversion_rate": 1,
      "converted_amount": 24000,
      "converted_at": "2026-10-13T02:00:00.000Z",
      "payment_method_id": "pm_1ryTrMj4TTAT1N",
      "bank_account_id": "bac_KJyPrMA1toAqRG",
      "custom_note": "Thank you for your purchase!",
      "additional_info": "This invoice must be paid within the payment delay indicated. After this period a late payment penalty of 10% will be applied.",
      "footer": "ACME (Acme SAS) is a company registered in France | SIREN N°123456",
      "customer": {
        "id": "cus_Typ0px2W0aiEtl",
        "name": "Acme",
        "email": "billing@acme.com",
        "external_id": null,
        "vat_number": "<string>",
        "tax_id": "FR123456789",
        "local_tax_number": "12/345/67890",
        "registration_number": "36252187900034",
        "address": {
          "name": "Acme",
          "line1": "5 rue de Paradis",
          "line2": null,
          "city": "Paris",
          "zip": "75010",
          "state": "CA",
          "country": "FR"
        }
      },
      "seller": {
        "id": "ive_47484fjdhy5",
        "name": "Name of the invoicing entity",
        "tax_id": "FR5878986578",
        "registration_number": "87898657800016",
        "address": {
          "name": "Acme",
          "line1": "5 rue de Paradis",
          "line2": null,
          "city": "Paris",
          "zip": "75010",
          "state": "CA",
          "country": "FR"
        }
      },
      "subscription_id": "sub_amiaWZ3lzDIWaoT",
      "period_starts_at": "2026-10-13T00:00:00.000Z",
      "period_ends_at": "2026-11-13T00:00:00.000Z",
      "emitted_at": "2026-10-13T00:00:00.000Z",
      "due_at": "2026-11-12T00:00:00.000Z",
      "issuing_method": "manual",
      "refunded_at": null,
      "grace_period_ended_at": null,
      "settled_at": "2026-10-15T14:01:56.000Z",
      "updated_at": "2026-10-15T14:01:56.000Z",
      "properties": null,
      "custom_properties": null,
      "additional_display_fields": null,
      "original_invoice_id": null,
      "original_invoice_number": null,
      "line_items": [
        {
          "id": "ili_0FACNpeoEFkGu3",
          "name": "Platform access",
          "entry_type": "debit",
          "product_id": "itm_KbLcWt2qm5p1S2",
          "price_configuration_id": "pcf_monthly",
          "product_type": "flat_fee",
          "units_count": 1,
          "unit_amount": 24000,
          "amount": 24000,
          "amount_excluding_tax": 20000,
          "tax_rate": 20,
          "tax_rate_id": null,
          "tax_amount": 4000,
          "discount_amount": 0,
          "discount_percent": 123,
          "period_starts_at": "2026-10-13T00:00:00.000Z",
          "period_ends_at": "2026-11-13T00:00:00.000Z",
          "revenue_type": "recurring",
          "revenue_interval_count": 1,
          "revenue_interval_period": "months",
          "display_unit_amount": true,
          "display_service_period": true,
          "original_line_item_id": null
        }
      ],
      "coupons": [
        {
          "id": "cou_DKL4Xcb5VSa8CQ",
          "name": "Partner discount",
          "subscription_coupon_id": "coos_d9pVekhjoGppuX",
          "discount_amount": 2000,
          "discount_percent": null,
          "line_item_ids": [
            "ili_0FACNpeoEFkGu3"
          ]
        }
      ],
      "transactions": [
        {
          "id": "tra_2QdJDDUej969ev",
          "type": "subscription",
          "amount": 31500,
          "currency": "EUR",
          "customer_id": "cus_QalW2vTAdkR6IY",
          "provider_id": "<string>",
          "process_at": "2024-11-12T07:38:39.222Z",
          "settled_at": "2024-11-12T07:38:39.222Z",
          "refunded_at": null,
          "original_transaction_id": null,
          "reversed_at": null,
          "last_refreshed_at": null,
          "provider_fee": null,
          "chargeback": null,
          "integrations": [
            {
              "entity_id": "123456789",
              "provider_name": "stripe",
              "provider_account_id": "acc_1234567890"
            }
          ],
          "payment_method_type": "card",
          "payment_method": {
            "id": "pm_1xMpj5bwRqN7LM",
            "status": "active",
            "type": "card",
            "last_4_digits": 2718,
            "expiration_date": "2027-11",
            "brand": "visa"
          },
          "status": "settled"
        }
      ],
      "public_url": "<string>",
      "integrations": [
        {
          "entity_id": "123456789",
          "provider_name": "stripe",
          "provider_account_id": "acc_1234567890"
        }
      ],
      "allocations": [
        {
          "invoice_id": "inv_2QdJDDUej969ev",
          "amount": 780000
        }
      ]
    }
  ],
  "next_invoice_after_transition": {
    "id": "inv_1eTaiytfA0i2Va",
    "number": "INV-35",
    "type": "invoice",
    "document_name": null,
    "status": "paid",
    "reference": "V0KAHOU6J3",
    "purchase_order": "PO-12345",
    "currency": "EUR",
    "source": "hyperline",
    "total_amount": 24000,
    "amount_due": 0,
    "amount_paid": 24000,
    "amount_fixed": 20000,
    "amount_excluding_tax": 20000,
    "tax_rate": 123,
    "tax_amount": 4000,
    "tax_scheme": "standard",
    "discount_amount": 0,
    "conversion_rate": 1,
    "converted_amount": 24000,
    "converted_at": "2026-10-13T02:00:00.000Z",
    "payment_method_id": "pm_1ryTrMj4TTAT1N",
    "bank_account_id": "bac_KJyPrMA1toAqRG",
    "custom_note": "Thank you for your purchase!",
    "additional_info": "This invoice must be paid within the payment delay indicated. After this period a late payment penalty of 10% will be applied.",
    "footer": "ACME (Acme SAS) is a company registered in France | SIREN N°123456",
    "customer": {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "email": "billing@acme.com",
      "external_id": null,
      "vat_number": "<string>",
      "tax_id": "FR123456789",
      "local_tax_number": "12/345/67890",
      "registration_number": "36252187900034",
      "address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      }
    },
    "seller": {
      "id": "ive_47484fjdhy5",
      "name": "Name of the invoicing entity",
      "tax_id": "FR5878986578",
      "registration_number": "87898657800016",
      "address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": null,
        "city": "Paris",
        "zip": "75010",
        "state": "CA",
        "country": "FR"
      }
    },
    "subscription_id": "sub_amiaWZ3lzDIWaoT",
    "period_starts_at": "2026-10-13T00:00:00.000Z",
    "period_ends_at": "2026-11-13T00:00:00.000Z",
    "emitted_at": "2026-10-13T00:00:00.000Z",
    "due_at": "2026-11-12T00:00:00.000Z",
    "issuing_method": "manual",
    "refunded_at": null,
    "grace_period_ended_at": null,
    "settled_at": "2026-10-15T14:01:56.000Z",
    "updated_at": "2026-10-15T14:01:56.000Z",
    "properties": null,
    "custom_properties": null,
    "additional_display_fields": null,
    "original_invoice_id": null,
    "original_invoice_number": null,
    "line_items": [
      {
        "id": "ili_0FACNpeoEFkGu3",
        "name": "Platform access",
        "entry_type": "debit",
        "product_id": "itm_KbLcWt2qm5p1S2",
        "price_configuration_id": "pcf_monthly",
        "product_type": "flat_fee",
        "units_count": 1,
        "unit_amount": 24000,
        "amount": 24000,
        "amount_excluding_tax": 20000,
        "tax_rate": 20,
        "tax_rate_id": null,
        "tax_amount": 4000,
        "discount_amount": 0,
        "discount_percent": 123,
        "period_starts_at": "2026-10-13T00:00:00.000Z",
        "period_ends_at": "2026-11-13T00:00:00.000Z",
        "revenue_type": "recurring",
        "revenue_interval_count": 1,
        "revenue_interval_period": "months",
        "display_unit_amount": true,
        "display_service_period": true,
        "original_line_item_id": null
      }
    ],
    "coupons": [
      {
        "id": "cou_DKL4Xcb5VSa8CQ",
        "name": "Partner discount",
        "subscription_coupon_id": "coos_d9pVekhjoGppuX",
        "discount_amount": 2000,
        "discount_percent": null,
        "line_item_ids": [
          "ili_0FACNpeoEFkGu3"
        ]
      }
    ],
    "transactions": [
      {
        "id": "tra_2QdJDDUej969ev",
        "type": "subscription",
        "amount": 31500,
        "currency": "EUR",
        "customer_id": "cus_QalW2vTAdkR6IY",
        "provider_id": "<string>",
        "process_at": "2024-11-12T07:38:39.222Z",
        "settled_at": "2024-11-12T07:38:39.222Z",
        "refunded_at": null,
        "original_transaction_id": null,
        "reversed_at": null,
        "last_refreshed_at": null,
        "provider_fee": null,
        "chargeback": null,
        "integrations": [
          {
            "entity_id": "123456789",
            "provider_name": "stripe",
            "provider_account_id": "acc_1234567890"
          }
        ],
        "payment_method_type": "card",
        "payment_method": {
          "id": "pm_1xMpj5bwRqN7LM",
          "status": "active",
          "type": "card",
          "last_4_digits": 2718,
          "expiration_date": "2027-11",
          "brand": "visa"
        },
        "status": "settled"
      }
    ],
    "public_url": "<string>",
    "integrations": [
      {
        "entity_id": "123456789",
        "provider_name": "stripe",
        "provider_account_id": "acc_1234567890"
      }
    ],
    "allocations": [
      {
        "invoice_id": "inv_2QdJDDUej969ev",
        "amount": 780000
      }
    ]
  }
}