Skip to content
Trile Docs

Create a subscription-scoped invoice in draft status. Idempotency-Key required on retries.

POST
/v1/invoices

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string

Required on every mutating /v1/* endpoint (Phase 1 fixture relaxes to optional)

Request Body required

Section titled “Request Body required ”
object
subscriptionId
required
string
amountPaisa
required
string format: int64
description
required
string
priceId
required
string
periodStart
required
string format: date-time
periodEnd
required
string format: date-time

Responses

Section titled “ Responses ”

201

Section titled “201 ”
object
success
required
boolean
data
required
object
invoice
required
object
id
required
string
businessId
required
string
subscriptionId
required
string
invoiceNumber
required
string
status
required
string
Allowed values: draft open paid void uncollectible
periodStart
required
string format: date-time
periodEnd
required
string format: date-time
totalAmountPaisa
required
string format: int64
currency
required
string
metadata
required
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
meta
required
object
requestId
required
string