Lister les factures
curl --request GET \
  --url https://kennhosting.com/api/v1/invoices \
  --header 'Authorization: Bearer <token>'

​
Requête

GET /v1/invoices
Authorization: Bearer kh_live_xxxx

​
Paramètres de query

ParamètreTypeDescription
statusstringFiltre par statut Order (seul filtre implémenté)
pageintegerPagination Laravel

​
Réponse

{
  "success": true,
  "data": [
    {
      "id": 14,
      "uuid": "192b4bd5-76b7-44aa-b323-2801115adaf5",
      "user_id": 2,
      "order_number": "KH-AWROJCRIZE",
      "status": "payment_required",
      "checkout_mode": "auto",
      "order_type": "standalone_domain",
      "billing_period": "annual",
      "total_amount": "3705.00",
      "discount_amount": "0.00",
      "original_amount": "3705.00",
      "payment_method": "notchpay",
      "created_at": "2026-04-11T11:41:02.000000Z",
      "updated_at": "2026-04-11T11:41:02.000000Z"
    }
  ],
  "meta": {
    "total": 9,
    "per_page": 20,
    "current_page": 1
  }
}

​
Télécharger une facture PDF

GET /v1/invoices/{order_uuid}/pdf
Retourne le PDF uniquement si la commande est en statut active ou payment_confirmed.
Sinon, l’API renvoie 422 avec error.code = invalid_state. 
$pdf = $client->request('get', "invoices/{$invoiceId}/pdf");

// Sauvegarder le PDF
file_put_contents("facture-{$invoiceId}.pdf", $pdf);

​
Permissions requises

invoices:read