Path parameters

• invoice string Required

  The ID of the desired invoice (e.g., in_4RviYgc2Wt).

Responses

• 200 application/json

  Returns an invoice object if a valid invoice ID was provided. Returns an error otherwise.

  Hide response attributes Show response attributes object

  • contractor string

    ID of the contractor.

  • created integer(int64)

    Time at which the object was created. Measured in seconds since the Unix epoch.

  • gross_pay integer

    The gross pay that the contractor earned in the last pay period.

    A positive integer representing the gross pay (e.g., 15000 cents to charge $150.00). The minimum amount is 100 cents US. The maximum amount is 100000000 cents US ($1,000,000).

    Minimum value is 100, maximum value is 100000000.

  • id string

    Unique identifier for the object.

  • job string

    ID of the job that the contractor was paid to do.

  • paycycle_enddate integer(int64)

    Pay period end date. Measured in seconds since the Unix epoch.

  • paycycle_startdate integer(int64)

    Pay period start date. Measured in seconds since the Unix epoch.

  • premium_due integer

    Premium due for pay cycle. Calculated as a percentage of gross pay for the period.

    A positive integer representing the premium due (e.g., 150 cents to charge $1.50). The minimum amount is 100 cents US.

  • purchase_order_number string

    The purchase order number for this invoice. Used for dashboard display and agency-pay billing.

    By default an invoice inherits this from the purchase_order_number set on the job's custom_metadata when it is created. It can be overridden per invoice on create or update by sending purchase_order_number (an explicit value wins over the job default), or cleared by sending an empty string (""). Omitting the field on update leaves the current value unchanged.

    When a wage change re-prices an invoice, the replacement invoice keeps this value rather than re-inheriting it from the job.

    Precedence: explicit value on the invoice, then the value carried forward when an invoice is re-priced, then the job's custom_metadata default.