curl --request PUT \
  --url https://api.getlago.com/api/v1/credit_notes/{lago_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "credit_note": {
    "refund_status": "succeeded",
    "metadata": {
      "external_id": "ext-123",
      "synced_at": "2024-01-15"
    }
  }
}
'

import requests

url = "https://api.getlago.com/api/v1/credit_notes/{lago_id}"

payload = { "credit_note": {
        "refund_status": "succeeded",
        "metadata": {
            "external_id": "ext-123",
            "synced_at": "2024-01-15"
        }
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    credit_note: {
      refund_status: 'succeeded',
      metadata: {external_id: 'ext-123', synced_at: '2024-01-15'}
    }
  })
};

fetch('https://api.getlago.com/api/v1/credit_notes/{lago_id}', 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.getlago.com/api/v1/credit_notes/{lago_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'credit_note' => [
        'refund_status' => 'succeeded',
        'metadata' => [
                'external_id' => 'ext-123',
                'synced_at' => '2024-01-15'
        ]
    ]
  ]),
  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.getlago.com/api/v1/credit_notes/{lago_id}"

	payload := strings.NewReader("{\n  \"credit_note\": {\n    \"refund_status\": \"succeeded\",\n    \"metadata\": {\n      \"external_id\": \"ext-123\",\n      \"synced_at\": \"2024-01-15\"\n    }\n  }\n}")

	req, _ := http.NewRequest("PUT", 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.put("https://api.getlago.com/api/v1/credit_notes/{lago_id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"credit_note\": {\n    \"refund_status\": \"succeeded\",\n    \"metadata\": {\n      \"external_id\": \"ext-123\",\n      \"synced_at\": \"2024-01-15\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getlago.com/api/v1/credit_notes/{lago_id}")

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

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"credit_note\": {\n    \"refund_status\": \"succeeded\",\n    \"metadata\": {\n      \"external_id\": \"ext-123\",\n      \"synced_at\": \"2024-01-15\"\n    }\n  }\n}"

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

{
  "credit_note": {
    "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "billing_entity_code": "acme_corp",
    "sequential_id": 2,
    "number": "LAG-1234-CN2",
    "lago_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
    "invoice_number": "LAG-1234",
    "purchase_order_number": "PO-123",
    "issuing_date": "2022-12-06",
    "credit_status": "available",
    "refund_status": "pending",
    "reason": "other",
    "description": "Free text",
    "currency": "EUR",
    "total_amount_cents": 120,
    "precise_total_amount_cents": "120.0001",
    "taxes_amount_cents": 20,
    "precise_taxes_amount_cents": "20.0001",
    "taxes_rate": 20,
    "sub_total_excluding_taxes_amount_cents": 100,
    "balance_amount_cents": 100,
    "credit_amount_cents": 100,
    "refund_amount_cents": 0,
    "offset_amount_cents": 0,
    "coupons_adjustment_amount_cents": 20,
    "created_at": "2022-09-14T16:35:31Z",
    "updated_at": "2022-09-14T16:35:31Z",
    "file_url": "https://getlago.com/credit_note/file",
    "xml_url": "https://getlago.com/credit_note/xml",
    "self_billed": false,
    "items": [
      {
        "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "amount_cents": 100,
        "precise_amount_cents": "100.0001",
        "amount_currency": "EUR",
        "fee": {
          "amount_cents": 100,
          "amount_currency": "EUR",
          "taxes_amount_cents": 20,
          "taxes_rate": 20,
          "units": "0.32",
          "precise_unit_amount": "312.5",
          "total_aggregated_units": "0.32",
          "total_amount_cents": 120,
          "total_amount_currency": "EUR",
          "pay_in_advance": true,
          "invoiceable": true,
          "payment_status": "pending",
          "sub_total_excluding_taxes_amount_cents": 100,
          "sub_total_excluding_taxes_precise_amount_cents": "100.0",
          "item": {
            "type": "subscription",
            "code": "startup",
            "name": "Startup",
            "description": "Startup",
            "invoice_display_name": "Setup Fee (SF1)",
            "filter_invoice_display_name": "AWS eu-east-1",
            "filters": {},
            "lago_item_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
            "item_type": "Subscription",
            "grouped_by": {}
          },
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_charge_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_charge_filter_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_fixed_charge_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_invoice_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_true_up_fee_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_true_up_parent_fee_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_original_fee_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_subscription_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "lago_customer_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "external_customer_id": "external_id",
          "external_subscription_id": "external_id",
          "precise_amount": "1.0001",
          "precise_total_amount": "1.0212",
          "taxes_precise_amount": "0.20123",
          "events_count": 23,
          "from_date": "2022-04-29T08:59:51Z",
          "to_date": "2022-05-29T08:59:51Z",
          "created_at": "2022-08-24T14:58:59Z",
          "succeeded_at": "2022-08-24T14:58:59Z",
          "failed_at": "2022-08-24T14:58:59Z",
          "refunded_at": "2022-08-24T14:58:59Z",
          "event_transaction_id": "transaction_1234567890",
          "description": "Fee description",
          "precise_coupons_amount_cents": "0.0",
          "amount_details": {
            "plan_amount_cents": 10000,
            "graduated_ranges": [
              {
                "units": "10.0",
                "from_value": 0,
                "to_value": 10,
                "flat_unit_amount": "1.0",
                "per_unit_amount": "1.0",
                "per_unit_total_amount": "10.0",
                "total_with_flat_amount": "11.0"
              }
            ],
            "graduated_percentage_ranges": [
              {
                "units": "10.0",
                "from_value": 0,
                "to_value": 10,
                "flat_unit_amount": "1.0",
                "rate": "1.0",
                "per_unit_total_amount": "10.0",
                "total_with_flat_amount": "11.0"
              }
            ],
            "free_units": "10.0",
            "paid_units": "40.0",
            "per_package_size": 1000,
            "per_package_unit_amount": "0.5",
            "per_unit_total_amount": "10.0",
            "units": "20.0",
            "free_events": 10,
            "rate": "1.0",
            "paid_events": 20,
            "fixed_fee_unit_amount": "1.0",
            "fixed_fee_total_amount": "20.0",
            "min_max_adjustment_total_amount": "20.0",
            "per_unit_amount": "0.5",
            "flat_unit_amount": "10.0"
          },
          "self_billed": false,
          "applied_taxes": [
            {
              "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
              "lago_tax_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
              "tax_name": "TVA",
              "tax_code": "french_standard_vat",
              "tax_rate": 20,
              "tax_description": "French standard VAT",
              "amount_cents": 2000,
              "amount_currency": "USD",
              "created_at": "2022-09-14T16:35:31Z",
              "lago_fee_id": "1a901a90-1a90-1a90-1a90-1a901a901a90"
            }
          ],
          "pricing_unit_details": {
            "lago_pricing_unit_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
            "pricing_unit_code": "credits",
            "short_name": "CR",
            "amount_cents": 200,
            "precise_amount_cents": "200.0",
            "unit_amount_cents": 100,
            "precise_unit_amount": "100.0",
            "conversion_rate": "0.5"
          },
          "presentation_breakdowns": [
            {
              "presentation_by": {},
              "units": "9.0"
            }
          ]
        }
      }
    ],
    "applied_taxes": [
      {
        "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "lago_tax_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "tax_name": "TVA",
        "tax_code": "french_standard_vat",
        "tax_rate": 20,
        "tax_description": "French standard VAT",
        "amount_cents": 2000,
        "amount_currency": "USD",
        "created_at": "2022-09-14T16:35:31Z",
        "lago_credit_note_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "base_amount_cents": 100
      }
    ],
    "customer": {
      "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
      "sequential_id": 1,
      "slug": "LAG-1234-001",
      "external_id": "5eb02857-a71e-4ea2-bcf9-57d3a41bc6ba",
      "billing_entity_code": "acme_corp",
      "address_line1": "5230 Penfield Ave",
      "address_line2": null,
      "applicable_timezone": "America/Los_Angeles",
      "city": "Woodland Hills",
      "country": "US",
      "currency": "USD",
      "email": "dinesh@piedpiper.example",
      "legal_name": "Coleman-Blair",
      "legal_number": "49-008-2965",
      "logo_url": "http://hooli.com/logo.png",
      "name": "Gavin Belson",
      "firstname": "Gavin",
      "lastname": "Belson",
      "account_type": "customer",
      "customer_type": "company",
      "phone": "1-171-883-3711 x245",
      "state": "CA",
      "tax_identification_number": "EU123456789",
      "timezone": "America/Los_Angeles",
      "url": "http://hooli.com",
      "zipcode": "91364",
      "net_payment_term": 30,
      "external_salesforce_id": "0015p00001JQx1QAAT",
      "created_at": "2022-04-29T08:59:51Z",
      "updated_at": "2022-04-29T08:59:51Z",
      "finalize_zero_amount_invoice": "inherit",
      "skip_invoice_custom_sections": false,
      "billing_configuration": {
        "invoice_grace_period": 3,
        "subscription_invoice_issuing_date_anchor": "next_period_start",
        "subscription_invoice_issuing_date_adjustment": "keep_anchor",
        "payment_provider": "stripe",
        "payment_provider_code": "stripe-eu-1",
        "provider_customer_id": "cus_12345",
        "sync": true,
        "sync_with_provider": true,
        "document_locale": "fr",
        "provider_payment_methods": [
          "card",
          "sepa_debit",
          "us_bank_account",
          "bacs_debit",
          "link",
          "boleto",
          "crypto",
          "customer_balance"
        ]
      },
      "shipping_address": {
        "address_line1": "5230 Penfield Ave",
        "address_line2": null,
        "city": "Woodland Hills",
        "country": "US",
        "state": "CA",
        "zipcode": "91364"
      },
      "metadata": [
        {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "key": "Purchase Order",
          "value": "123456789",
          "display_in_invoice": true,
          "created_at": "2022-04-29T08:59:51Z"
        }
      ],
      "integration_customers": [
        {
          "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
          "type": "netsuite",
          "integration_code": "netsuite-eu-1",
          "code": "netsuite-eu-1",
          "is_default": true,
          "category": "accounting",
          "external_customer_id": "cus_12345",
          "sync_with_provider": true,
          "subsidiary_id": "2",
          "targeted_object": "contacts",
          "email": "dinesh@piedpiper.example"
        }
      ]
    },
    "metadata": {
      "external_id": "ext-123",
      "synced_at": "2024-01-15",
      "source": null
    },
    "error_details": [
      {
        "lago_id": "1a901a90-1a90-1a90-1a90-1a901a901a90",
        "error_code": "tax_error",
        "details": {}
      }
    ]
  }
}

{
  "status": 400,
  "error": "Bad request"
}

{
  "status": 401,
  "error": "Unauthorized"
}

{
  "status": 404,
  "error": "Not Found",
  "code": "object_not_found"
}

{
  "status": 422,
  "error": "Unprocessable entity",
  "code": "validation_errors",
  "error_details": {}
}