Skip to content
Bottle

Mark several invoices paid

POST
/invoices/mark-paid
curl --request POST \
  --url https://example.com/invoices/mark-paid \
  --header 'Content-Type: application/json' \
  --cookie __Host-bottle.session_token=<__Host-bottle.session_token> \
  --data '{ "invoiceIds": [ "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f" ], "via": "transfer" }'

For a batch of bank transfers, or a pile of cash: each unpaid invoice is marked paid today, the same way. One already paid or cancelled is left as it is and listed as skipped.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
invoiceIds
required
Array<string>
>= 1 items <= 500 items
via
required
string
Allowed values: transfer cash card

Responses

Section titled “Responses”

200

Section titled “200”

What was marked paid and what was skipped

Media typeapplication/json
object
done
required
Array<object>
object
invoiceId
required

UUID v7

string format: uuid
number
required
string
skipped
required
Array<object>
object
invoiceId
required

UUID v7

string format: uuid
number
required
string | null
reason
required
string
Allowed values: not_found paid void

Example 

{
  "done": [
    {
      "invoiceId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f"
    }
  ],
  "skipped": [
    {
      "invoiceId": "019205d1-6e7a-7c3b-9f6e-3a2b1c0d9e8f",
      "reason": "not_found"
    }
  ]
}

401

Section titled “401”

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}

403

Section titled “403”

Not a member, or without the permission this needs

Media typeapplication/json
object
error
required
string
message
required
string

Example 

{
  "error": "not_found",
  "message": "Customer not found"
}

422

Section titled “422”

Validation failed

Media typeapplication/json
object
error
required
string
Allowed values: validation
message
required
string
issues
required
Array<object>
object
path
required
string
message
required
string

Example 

{
  "error": "validation",
  "issues": [
    {
      "path": "email",
      "message": "Invalid email"
    }
  ]
}