Skip to main content
POST
Confirm Bill Invoice

Authorizations

x-api-key
string
header
required

Your Meow API key, sent in the x-api-key header for authentication.

Headers

x-entity-id
string<uuid>

Optional entity_id to scope requests to a specific entity.

Path Parameters

bill_id
string<uuid>
required

The bill ID.

Body

application/json

One uploaded file to attach to the bill.

object_key
string
required

Storage key returned with the upload URL. It must belong to your entity and the file must already be uploaded.

filename
string
required

Name to show the document under on the bill.

Response

Successful Response

id
string<uuid>
required

Identifier for this bill.

status
enum<string>
required

The current status of the bill.

Available options:
CANCELED,
DRAFT_PROCESSING,
DRAFT,
PAYMENT_INFO_NEEDED,
PENDING,
APPROVED,
REJECTED,
SCHEDULED,
PAYMENT_INITIATED,
PAYMENT_DELIVERED,
PAYMENT_FAILED,
PAYMENT_CANCELED
vendor_name
string
required

The name of the vendor.

creation_source
enum<string>
required

How the bill was created.

Available options:
USER,
EMAIL,
SCHEDULE
created_by
string
required

Who created the bill.

created_at
string<date-time>
required

The creation timestamp.

invoice_number
string | null

The invoice number.

description
string | null

Description of the bill.

memo
string | null

Memo for the bill.

bill_date
string<date> | null

The bill date.

bill_due_date
string<date> | null

The due date.

bill_total
string | null

The total amount of the bill.

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
currency
enum<string> | null

The bill's currency.

Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BOV,
BRL,
BSD,
BTN,
BWP,
BYN,
BZD,
CAD,
CDF,
CHE,
CHF,
CHW,
CLF,
CLP,
CNY,
COP,
COU,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRU,
MUR,
MVR,
MWK,
MXN,
MXV,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SLE,
SEK,
SGD,
SHP,
SLL,
SOS,
SRD,
SSP,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
USN,
UYI,
UYU,
UYW,
UZS,
VED,
VES,
VND,
VUV,
WST,
XAF,
XAG,
XAU,
XBA,
XBB,
XBC,
XBD,
XCD,
XDR,
XOF,
XPD,
XPF,
XPT,
XSU,
XTS,
XUA,
XXX,
YER,
ZAR,
ZMW,
ZWG,
ZWL
payment_type
enum<string> | null

How this bill is paid: ACH, WIRE, CHECK, CRYPTO, or INTERNATIONAL_PAYMENT_FX.

Available options:
ACH,
CRYPTO,
INTERNATIONAL_PAYMENT_FX,
WIRE,
CHECK
contact_id
string<uuid> | null

The ID of the associated contact.

category_id
string<uuid> | null

The spend category this bill is coded to, if any.

category_name
string | null

The name of the spend category, if any.

updated_at
string<date-time> | null

The last-updated timestamp.

submitted_at
string<date-time> | null

When the bill was submitted for approval.

submitted_by
string | null

Who submitted the bill.

paid_at
string<date-time> | null

The paid timestamp.

paid_by
string | null

Who paid the bill.

scheduled_at
string<date-time> | null

The scheduled payment timestamp.

resolved_at
string<date-time> | null

When the bill was resolved.

canceled_at
string<date-time> | null

When the bill was canceled.

canceled_by
string | null

Who canceled the bill.

bill_schedule_id
string<uuid> | null

The recurring schedule this bill belongs to, if any.

ordinal
integer | null

The bill's position in its recurring schedule (template is 0).

line_items
BillLineItemResponse · object[]

Line items for the bill.

bill_payment_details
BillPaymentDetailsResponse · object | null

How this bill will be paid once approved: the funding account, payment type, currency, and scheduled date.

additional_documents
BillDocumentResponse · object[]

Documents attached to the bill, each with a download URL.

img_url
string | null

A short-lived URL to download the bill's primary document.

rrule
string | null

RFC 5545 RRULE string. Required: DTSTART, RRULE. Allowed frequencies: WEEKLY, MONTHLY.

Required string length: 1 - 120
auto_approval_enabled
boolean | null

Whether the recurring schedule auto-approves generated bills.

bill_sync_status
enum<string> | null

Sync status of the bill to your accounting integration.

Available options:
synced,
requires_sync,
sync_complete,
sync_failed
payment_sync_status
enum<string> | null

Sync status of the payment to your accounting integration.

Available options:
synced,
requires_sync,
sync_complete,
sync_failed
accounting_vendor
enum<string> | null

The accounting integration this bill syncs to, if any.

Available options:
QuickBooks,
Xero,
NetSuite,
Puzzle,
Ramp,
Stripe,
Wave,
Relay,
Mastercard
accounting_bill_id
string | null

The bill's ID in your accounting system, once it has synced there.

is_excluded_from_accounting
boolean
default:false

Whether this bill was excluded from accounting sync. An excluded bill reports no sync status, same as one that never synced.