Skip to main content
BlueAI
Home/Received Documents/Received Invoices

Received Invoices

Register, approve, reject, and manage payment of received invoices.

|

Endpoints

GET/api/v1/received-invoicesList received invoices
POST/api/v1/received-invoicesRegister a received invoice
GET/api/v1/received-invoices/dashboardGet dashboard
GET/api/v1/received-invoices/{id}Get a received invoice
PATCH/api/v1/received-invoices/{id}Update a received invoice
DELETE/api/v1/received-invoices/{id}Delete a received invoice
POST/api/v1/received-invoices/{id}/approveApprove
POST/api/v1/received-invoices/{id}/rejectReject
POST/api/v1/received-invoices/{id}/mark-paidMark as paid
GET/api/v1/received-invoices

List received invoices

Authentication requiredInclude session cookie or Bearer token

Query Parameters

NameTypeRequiredDescription
status
stringOptionalFilter by status (pending / approved / rejected / paid)
company_id
stringOptionalFilter by company ID
limit
integerOptionalNumber of items to return (default: 50, max: 200)
offset
integerOptionalNumber of items to skip

Code Examples

curl "https://api.blueai.jp/api/v1/received-invoices" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/received-invoices

Register a received invoice

Authentication requiredInclude session cookie or Bearer token

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/received-invoices" \
  -H "Cookie: better-auth.session_token=<token>"
GET/api/v1/received-invoices/dashboard

Get dashboard

Returns unapproved count, approaching due dates, monthly spending summary, etc.

Authentication requiredInclude session cookie or Bearer token

Code Examples

curl "https://api.blueai.jp/api/v1/received-invoices/dashboard" \
  -H "Cookie: better-auth.session_token=<token>"
GET/api/v1/received-invoices/{id}

Get a received invoice

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"
PATCH/api/v1/received-invoices/{id}

Update a received invoice

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl -X PATCH "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"
DELETE/api/v1/received-invoices/{id}

Delete a received invoice

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl -X DELETE "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/received-invoices/{id}/approve

Approve

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/approve" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/received-invoices/{id}/reject

Reject

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/reject" \
  -H "Cookie: better-auth.session_token=<token>"
POST/api/v1/received-invoices/{id}/mark-paid

Mark as paid

Authentication requiredInclude session cookie or Bearer token

Path Parameters

NameTypeRequiredDescription
id
stringOptionalReceived invoice ID

Code Examples

curl -X POST "https://api.blueai.jp/api/v1/received-invoices/rinv_123e4567e89b12d3a456426614174000/mark-paid" \
  -H "Cookie: better-auth.session_token=<token>"