Skip to main content
POST

​
Recording work on a project

Work entries are the individual units of work performed for a client. Recording them through the API lets an external system — for example field management software that captures hours and material expenses on site — feed a project in Infinity, so the work can be billed from Infinity later on. The type field selects how the work entry is valued and which further fields are required: All amounts are given in cents, and date is the day the work was performed on, in YYYY-MM-DD format.

​
Examples

Two and a half hours of work at an hourly rate of CHF 120.00:
Material purchased for the project, billed at a fixed CHF 450.50:
Work that should be documented on the project but never invoiced:
The response returns the created work entry, including its id and the resulting amount in cents.
Recording a work entry does not create any invoice or booking. New work entries appear as unbilled work on the project and are billed from Infinity, where you choose which entries to include on an invoice and how they are presented.

Authorizations

​
x-api-token
string
header
required

API token for authentication. Obtain from your Infinity account settings.

Path Parameters

​
projectId
string
required

The id of the project the work entries belong to.

Body

application/json

The work entry payload. The type field selects which further fields are required.

Request body for recording a work entry. Which fields are required depends on type.

​
type
enum<string>
required

The kind of a work entry, which determines how it is valued:

  • hourly is valued by an hourly rate and the time spent
  • fixed-price is valued by a fixed amount, e.g. for materials or lump sum work
  • unbillable has no value and cannot be billed
Available options:
unbillable,
fixed-price,
hourly
​
date
string<date>
required

The date the work was performed on, in YYYY-MM-DD format.

​
description
string
required

The description of the work that was performed.

Maximum string length: 2000
​
price
integer

The amount in cents to invoice. Required for fixed-price work entries, must be greater than zero.

​
rate
integer

The hourly rate in cents. Required for hourly work entries, must be greater than zero.

​
hours
integer

The number of full hours spent. Required for hourly work entries.

​
minutes
integer
default:0

The number of minutes spent in addition to hours, between 0 and 59. Optional for hourly work entries. The total time must be greater than zero.

Response

The work entry was recorded successfully.

​
workEntry
WorkEntry · object

A single unit of work that was performed on a project.