Submit an invoice

POSThttps://api.sandbox.stridehq.ai/v1/invoices

Submits an invoice as structured fields for a creator you've already added. It waits for review in StrideHQ like an invoice uploaded there, and is matched to your purchase orders. Nothing is approved through the API. Uploading the invoice file through the API is coming later. Idempotency-Key is required.

Scope invoices:write

View as Markdown

Headers

Idempotency-Key stringrequired

A unique value, such as a UUID. The same key and body within 24 hours returns the original response.

Body parameters

creator_id stringrequired

The creator who sent the invoice. Add them first with Create a creator.

invoice_number stringrequired

Up to 100 characters. Unique per creator.

invoice_date string (date)

due_date string (date)

po_number string

Matched against your purchase orders.

description string

net_amount integer

Minor units. Optional; if you send it with vat_amount, they must add up to total_amount.

vat_amount integer

Minor units. Optional; 0 if neither it nor net_amount is sent.

total_amount integerrequired

Minor units.

currency stringrequired

ISO 4217.

external_id string

Your own reference, up to 100 characters. Unique in your organisation.

metadata object

Up to 20 string keys (up to 40 characters) and values (up to 500 characters), for your use. StrideHQ never reads them. Send null to clear it.

Responses