# Invoice history endpoints

## List invoices

### `get/beta/v1/org/{org_id}/invoices`

Returns all invoices for the organization, most recent first. Invoices are generated monthly once cloud provider bills are finalized and are the source of truth for Archera premiums and rebates. Per-term breakdowns are only included on the detail endpoint.

### Path parameters

- `org_id`: string · uuid (Required)

### Responses

#### 200 OK

```json
{
  "id": "string",  
  "year": 2023,  
  "month": 10,  
  "invoice_date": "2023-10-01",  
  "commitment_financials_invoice_month": {},  
  "premium_billing": {},  
  "total_cloud_bill": null,  
  "sections": []
}
```

#### 400 Bad request
#### 401 Unauthorized
#### 403 Forbidden
#### 404 Not found
#### 405 Method not allowed
#### 409 Conflict
#### 500 Internal server error

---

## Get invoice by year and month

### `get/beta/v1/org/{org_id}/invoices/{year}/{month}`

Returns a single invoice for the specified year and month. Invoices are the source of truth for Archera fees and premiums charged during each billing cycle.

### Path parameters

- `org_id`: string · uuid (Required)
- `year`: integer (Required)
- `month`: integer (Required)

### Responses

#### 200 OK

```json
{
  "id": "string",  
  "year": 2023,  
  "month": 10,  
  "invoice_date": "2023-10-01",  
  "commitment_financials_invoice_month": {},  
  "premium_billing": {},  
  "total_cloud_bill": null,
  "sections": [],  
  "by_term": [],  
  "by_type": []  
}
```

#### 400 Bad request
#### 401 Unauthorized
#### 403 Forbidden
#### 404 Not found
#### 405 Method not allowed
#### 409 Conflict
#### 500 Internal server error

---

## Get invoice line items

### `get/beta/v1/org/{org_id}/invoices/{year}/{month}/line-items`

Returns all line items for the specified invoice, showing per-commitment charges, savings, premiums, and rebates.

### Path parameters

- `org_id`: string · uuid (Required)
- `year`: integer (Required)
- `month`: integer (Required)

### Responses

#### 200 OK

```json
[
  {
    "id": "string",  
    "commitment_id": "string",  
    "commitment": {},  
    "utilization": 0.75,
    "contract_term": "one_year_gris",
    "commitment_financials_invoice_month": {}
  }
]
```

#### 400 Bad request
#### 401 Unauthorized
#### 403 Forbidden
#### 404 Not found
#### 405 Method not allowed
#### 409 Conflict
#### 500 Internal server error