---
title: "Create Billing Invoice"
method: POST
path: "/v1/customers/{customer_id}/billing/invoices"
---

# Create Billing Invoice

`POST /v1/customers/{customer_id}/billing/invoices`

## Request

- Base URL: `https://api.aivikings.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aivikings.ai/v1/customers/{customer_id}/billing/invoices`
- Auth: none declared

## Path parameters

- `customer_id` string, required

## Request body

- BillingInvoiceCreateRequest
  - `currency` string
  - `items` BillingInvoiceItemCreate[], required
    - `description` string, required
    - `quantity` integer
    - `unit_amount` union, required
      - number
      - string
  - `tax_amount` union
    - number
    - string
  - `notes` string, nullable
  - `due_at` string, date-time, nullable

## Response `201`

Successful Response

- BillingInvoiceResponse
  - `id` integer, required
  - `customer_id` string, required
  - `invoice_number` string, required
  - `status` string, required
  - `currency` string, required
  - `subtotal_amount` string, required
  - `tax_amount` string, required
  - `total_amount` string, required
  - `notes` string, nullable
  - `stripe_checkout_session_id` string, nullable
  - `stripe_payment_intent_id` string, nullable
  - `issued_at` string, date-time, required
  - `due_at` string, date-time, nullable
  - `paid_at` string, date-time, nullable
  - `voided_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `items` BillingInvoiceItemResponse[], required
    - `id` integer, required
    - `invoice_id` integer, required
    - `description` string, required
    - `quantity` integer, required
    - `unit_amount` string, required
    - `total_amount` string, required
    - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar.md) · [All operations](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/llms.txt) · [OpenAPI document](https://skmtc.dev/aivikings/apis/aivikings-ai-agent-registrar/revisions/2fc32ee9d1b1?raw)