---
title: "Retrieves a pending invoice creation proposal"
method: GET
path: "/invoices/creation-proposals/{invoice_id}"
tags: ["Invoices"]
---

# Retrieves a pending invoice creation proposal

`GET /invoices/creation-proposals/{invoice_id}`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/invoices/creation-proposals/{invoice_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/invoices/creation-proposals/:invoice_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the captured contents of an invoice awaiting creation approval. No effective invoice exists yet.
After approval, retrieve the invoice through the normal invoice endpoint. Pending proposals are excluded from invoice lists.

## Path parameters

- `invoice_id` string, uuid, required

## Response `200`

Pending invoice creation proposal

- InvoiceCreationProposal: A creation proposal, not an effective invoice. Use the review reference to track approval.
  - `invoice_id` string, uuid, required
  - `approval_request_id` string, uuid, required
  - `status` 'PENDING' | 'REJECTED' | 'CANCELLED' | 'REPLACED', required
  - `proposal` InvoiceCreationPreview: Captured invoice contents awaiting creation approval.
    - `customer_id` string, uuid, required
    - `subsidiary_id` string, uuid, required
    - `scope` string, required
    - `invoice_date` string, date, required
    - `due_date` string, date, required
    - `currency` string, required
    - `total_amount` number, required
    - `tax_amount` number, required
    - `memo` string
    - `purchase_order_number` string
    - `items` InvoiceCreationLinePreview[], required
      - `id` string, uuid, required
      - `product_id` string, uuid, nullable
      - `description` string, required
      - `net_amount` number, required
      - `tax_amount` number, required
      - `quantity` number, required
    - `metadata` object, required

## Other responses

- `404`: No accessible pending creation proposal exists
- `default`: Error

## Changes

- **2026-11-03** `c393d0102005`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rillet/apis/rillet-accounting-api/changes/invoices/creation-proposals/:invoice_id/get.md)

---

[API](https://skmtc.dev/rillet/apis/rillet-accounting-api.md) - [All operations](https://skmtc.dev/rillet/apis/rillet-accounting-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rillet/apis/rillet-accounting-api/revisions/c393d0102005?raw)