Skip to main content
GET
/
timmi-project
/
api
/
projects
/
financials
List financials by project
curl --request GET \
  --url https://{host}/timmi-project/api/projects/financials \
  --header 'Authorization: <authorization>'
{
  "time": {
    "value": 128,
    "iso": "P5DT8H",
    "unit": "hour"
  },
  "spent": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "progress": 123,
  "totalInvoiced": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "managementOutstanding": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "currentOverrun": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "estimatedOverrun": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "price": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "currentRecoveryRate": 1,
  "initialRecoveryRate": 1,
  "estimatedRecoveryRate": 1,
  "currentDiscount": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "discountedSpent": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "spentToComplete": {
    "amount": 123,
    "currencyId": "EUR"
  },
  "timeToComplete": {
    "value": 128,
    "iso": "P5DT8H",
    "unit": "hour"
  },
  "next": "<string>",
  "prev": "<string>",
  "count": 1,
  "items": [
    {
      "project": {
        "id": 2,
        "code": "<string>",
        "name": "<string>",
        "client": {
          "id": 2,
          "code": "<string>",
          "name": "<string>",
          "externalCode": "<string>"
        },
        "owner": {
          "picture": {
            "href": "<string>"
          },
          "establishmentId": 123,
          "id": 123,
          "firstName": "<string>",
          "lastName": "<string>",
          "dtContractEnd": "<unknown>"
        },
        "status": "<unknown>",
        "contractType": "<unknown>",
        "initialDeliveryDate": "2023-12-25",
        "revisedDeliveryDate": "2023-12-25",
        "billRate": {
          "price": {
            "amount": 123,
            "currencyId": "EUR"
          },
          "unit": "day"
        },
        "initialTimeEstimate": {
          "value": 128,
          "iso": "P5DT8H",
          "unit": "hour"
        },
        "revisedTimeEstimate": {
          "value": 128,
          "iso": "P5DT8H",
          "unit": "hour"
        },
        "anomalies": [
          {}
        ],
        "risks": [
          {
            "type": "<string>",
            "label": "<string>"
          }
        ],
        "invoicingWarnings": [
          {}
        ],
        "initialBudget": {
          "amount": 123,
          "currencyId": "<string>"
        },
        "revisedBudget": {
          "amount": 123,
          "currencyId": "<string>"
        },
        "price": {
          "amount": 123,
          "currencyId": "<string>"
        },
        "invoiceMilestonesTotal": "<unknown>",
        "discount": {
          "amount": 123,
          "currencyId": "EUR"
        },
        "startsOn": "<string>"
      },
      "time": {
        "value": 128,
        "iso": "P5DT8H",
        "unit": "hour"
      },
      "spent": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "progress": 123,
      "totalInvoiced": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "managementOutstanding": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "currentOverrun": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "estimatedOverrun": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "price": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "currentRecoveryRate": 1,
      "initialRecoveryRate": 1,
      "estimatedRecoveryRate": 1,
      "currentDiscount": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "discountedSpent": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "spentToComplete": {
        "amount": 123,
        "currencyId": "EUR"
      },
      "timeToComplete": {
        "value": 128,
        "iso": "P5DT8H",
        "unit": "hour"
      }
    }
  ]
}

Headers

​
Authorization
string
required

API key. Value must be formatted like so: lucca application={api_key}.

Query Parameters

​
organizationId
integer
required

Only return projects in given organization (by id).

​
projectContractType
any[]

Only return projects with given contract type.

​
projectStatus
any[]

Only return projects with given status.

​
projectOwnerId
integer

Identifier of the project lead.

​
hasProjectAnomaly
boolean

Only return projects with anomalies (any).

​
isProjectDelayedDelivery
boolean

Only return late projects (risk).

​
isProjectBudgetOverrun
integer

Only return overrun projects (risk)

​
isProjectHighlyDiscounted
boolean

Only return highly discounted projects (risk).

​
from
string<date>

Start date.

​
till
string<date>

End date.

​
projectId
integer[]

Identifier of the project.

​
search
string

Find a project based on its name or code.

​
projectIntersectsPeriod
string<date>[]

Only return projects with [startsOn, revisedDeliveryDate] dates intersecting given period ?projectIntersectsPeriod={start},{end}. In other words, projects that spread partially or completely over passed period. Projects with no dates startsOn: null, revisedDeliveryDate: null will always be returned (these may only be non-billable projects).

Required array length: 2 elements
Examples:

"2022-01-01,2022-01-31"

"2022-01-01,2022-12-31"

​
projectOwnerDepartmentId
integer[]

List the identifiers of departments the project owner must belong to.

Minimum array length: 1
Required range: x >= 0
​
page
integer
default:1

Page number

Required range: x >= 1
​
limit
integer
default:10

Page size

​
fields.root
enum<string>

Return total items count (across all pages).

Available options:
count
​
sort
enum<string>

Sort results by property

Available options:
project.id,
-project.id,
project.name,
-project.name,
project.owner.lastName,
-project.owner.lastName,
project.price,
-project.price,
project.billRate,
-project.billRate,
discountedSpent,
-discountedSpent,
totalInvoiced,
-totalInvoiced,
managementOutstanding,
-managementOutstanding,
estimatedOverrun,
-estimatedOverrun,
estimatedRecoveryRate,
-estimatedRecoveryRate

Response

OK

​
time
Duration · object

Total time spent on all items.

Example:
{
  "value": 128,
  "iso": "P5DT8H",
  "unit": "hour"
}
​
spent
Price · object

Total value (standard prices) of the whole time spent on all items.

​
progress
number

Ratio of budget spent. Equal to Spent / RevisedBudget.

Must be a multiple of 0.01
​
totalInvoiced
Price · object

Total amount of all invoices issued on the items.

​
managementOutstanding
Price · object

Total worth of uninvoiced time spent. Equal to Spent - TotalInvoiced.

​
currentOverrun
Price · object

Value of the budget overrun as of today. Equal to Spent - InitialBudget.

​
estimatedOverrun
Price · object

Value of the estimated budget overrun upon project end. Equal to Spent - RevisedBudget.

​
price
Price · object

Total price of all items.

​
currentRecoveryRate
number

Ratio between the total invoiced amount and the worth of all time spent. Equal to TotalInvoiced / Spent.

Required range: x >= 0Must be a multiple of 0.01
​
initialRecoveryRate
number

Ratio between the price and the initial budget of all items. Equal to Price / InitialBudget.

Required range: x >= 0Must be a multiple of 0.01
​
estimatedRecoveryRate
number

Ratio between the price and the revised budget. Equal to Price / RevisedBudget.

Required range: x >= 0Must be a multiple of 0.01
​
currentDiscount
Price · object

Ratio of total discount already spent.

​
discountedSpent
Price · object

Equal to Spent - CurrentDiscount.

​
spentToComplete
Price · object

Equal to RevisedBudget - Spent.

​
timeToComplete
Duration · object

Equal to spentToComplete / standardPrice.

Example:
{
  "value": 128,
  "iso": "P5DT8H",
  "unit": "hour"
}
​
next
string<uri> | null
​
prev
string<uri> | null
​
count
integer | null
Required range: x >= 0
​
items
The Project Financials resource · object[]