Invoice Endpoints - StartMyVPN

All endpoints require authentication.

GET /v1/invoices

List all invoices for the authenticated user. Query parameters:

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`status`	string	Filter by status: `pending`, `paid`, `cancelled`

Response (200):

{
  "success": true,
  "data": [
    {
      "id": 1,
      "uuid": "abc-123-def",
      "amount": "9.99",
      "currency": "USD",
      "status": "paid",
      "gateway": "stripe",
      "created_at": "2026-01-01T10:00:00Z",
      "paid_at": "2026-01-01T10:05:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 6,
    "per_page": 15
  }
}

GET /v1/invoices/

Get details of a specific invoice. Path parameter: invoice — invoice UUID Response (200):

{
  "success": true,
  "data": {
    "id": 1,
    "uuid": "abc-123-def",
    "amount": "9.99",
    "currency": "USD",
    "discount": "0.00",
    "promo_code": null,
    "status": "paid",
    "gateway": "stripe",
    "plan": {
      "name": "Premium"
    },
    "cycle": {
      "name": "Monthly",
      "duration_days": 30
    },
    "created_at": "2026-01-01T10:00:00Z",
    "due_date": "2026-01-08T10:00:00Z",
    "paid_at": "2026-01-01T10:05:00Z"
  }
}

GET /v1/invoices//payment-url

Get the payment URL for a pending invoice. Path parameter: invoice — invoice UUID Response (200):

{
  "success": true,
  "data": {
    "url": "https://checkout.stripe.com/pay/...",
    "gateway": "stripe",
    "expires_at": "2026-01-08T10:00:00Z"
  }
}

Returns 422 if the invoice is already paid or cancelled.

​GET /v1/invoices

​GET /v1/invoices/

​GET /v1/invoices//payment-url

GET /v1/invoices

GET /v1/invoices/

GET /v1/invoices//payment-url