API reference

Bill inbox

The address vendors send their bills to, and the emails sent there with what became of each.

GET/v1/bill_inboxGet the address vendors send bills to
GET/v1/bill_inbox/emailsList the emails sent to the bills address
POST/v1/bill_inbox/rotateReplace the bills address

Get the address vendors send bills to

GET/v1/bill_inbox

client.billInbox.get()

The address vendors send their bills to. Each PDF or photo attached to an email sent there, by anyone, becomes a vendor's invoice waiting to be entered as a bill.

Response

200BillInboxOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/bill_inbox" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

List the emails sent to the bills address

GET/v1/bill_inbox/emails

client.billInbox.listEmails()

Emails sent to the bills address, newest first, with what became of each: kept, with how many bills it brought, or refused because nothing attached was a PDF or a photo.

Parameters

Name	Type	Description
`limit`Query	integer	Page size, 1–200. Default 50
`cursor`Query	string or null	The `next_cursor` of the previous page.

Response

200ReceiptEmailPage

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl "https://api.ledgerit.ai/v1/bill_inbox/emails" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN"

Replace the bills address

POST/v1/bill_inbox/rotate· Idempotent

client.billInbox.rotate()

Replace the bills address with a new one. The old one reaches nothing from now on: for an address that draws mail it should not.

Response

200BillInboxOut

Errors

400: The request was malformed or a parameter is invalid.
401: No valid credential was sent.
403: The credential or the member's role does not allow this.
404: No such resource in this ledger.
409: A conflicting request, e.g. one with the same Idempotency-Key still running.
422: A well-formed request a business rule refused.
429: Too many requests; retry after the Retry-After header.
500: Something failed on our side; the request_id identifies it.

Example

curl

curl -X POST "https://api.ledgerit.ai/v1/bill_inbox/rotate" \
  -H "Authorization: Bearer $LEDGERIT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Objects

The objects these operations take and return.

BillInboxOut

Name	Type	Description
`address`Required	string or null	Where vendors send their bills. Null where this deployment does not receive email.

ReceiptEmailPage

Name	Type	Description
`data`Required	array of ReceiptEmailOut
`has_more`Required	boolean
`next_cursor`Required	string or null

ReceiptEmailOut

One email forwarded to the books' address, and what became of it.

Name	Type	Description
`documents_kept`Required	integer	Receipts kept from it, once taken.
`id`Required	string	An id that starts with `rcpt_`.
`received_at`Required	string (date-time)
`refusal`Required	string or null	Why nothing was kept: `not_a_member` (the sender may not attach receipts to these books) or `nothing_attached` (no PDF or photo in it).
`sender`Required	string	Who sent it, as the email says.
`status`Required	string	`pending` until taken, then `kept` or `refused`.
`subject`Required	string or null
`taken_at`Required	string (date-time) or null