FAfactorialhr
ProjectManagement > Rate

Reads a single Rate

Changed on

Read rates

get/api/2026-10-01/resources/project_management/rates/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/project_management/rates/{id}
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: project_management_projects
    • or API key in header x-api-key

Path parameters

idstring required

Filter rates by IDs

Response

OK

idstring required

The id of the rate

company_idstring required

The id of the company the rate belongs to

project_idstring

The id of the project the rate belongs to

quote_idstring
reference_rate_idstring
resource_idstring required

The id of the resource the rate applies to. Together with resource_kind it forms the resource's composite identity.

resource_kind'project_worker' | 'project' | 'employee' | 'job_catalog_tree_node' required

The kind of resource the rate applies to. Together with resource_id it forms the resource's composite identity.

starts_onstring required

The date from which the rate applies

ends_onstring
charging_cost_centsinteger required

The charging cost in cents

billing_rate_centsinteger required

The billing rate in cents

markup_percentage_centsinteger required

The markup-on-cost percentage in cents (e.g. 3000 = 30%)

margin_percentage_centsinteger required

Computed profit margin on price in cents = (billing - charging) / billing * 10000. Returns 0 when billing equals charging, and -10000 when billing is zero.

currencystring required

The currency of the rate

unlinkedboolean required

Whether the rate is custom

Example response

{
  "id": "314159",
  "company_id": "1",
  "project_id": "1234",
  "resource_id": "271828",
  "resource_kind": "project_worker",
  "starts_on": "2025-01-01T00:00:00.000Z",
  "charging_cost_cents": 5000,
  "billing_rate_cents": 6000,
  "markup_percentage_cents": 10000,
  "margin_percentage_cents": 1667,
  "currency": "EUR"
}

Changes