Employers

List an employer's billing invoices

Returns a cursor-paginated page of the employer's billing invoices, newest first. Pass the next_offset from a previous page as offset to fetch the next page. The caller must be authorized for the employer; an unknown or unauthorized employer returns 404.

get/v1/employers/{employer_id}/invoices

Request

  • Base URL: https://api.vitablehealth.com
  • URL: https://api.vitablehealth.com/v1/employers/{employer_id}/invoices
  • Auth: HTTP bearer

Path parameters

employer_idstring required

Unique employer identifier (empr_*)

Query parameters

limitinteger

Items per page (default: 20, max: 100)

Maximum number of invoices per page

offsetstring

Opaque cursor from a previous page's next_offset

Headers

X-Vitable-Organizationstring

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Response

Changes

No recorded changes to this operation across all 1 revision of this API.