Skip to main content
POST
/
workers
/
{id}
/
orders
Create Worker Order
curl --request POST \
  --url https://api.roostedhr.com/api/1_12/workers/{id}/orders \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "id": "<string>",
  "p_id": "<string>"
}
'
{
  "id": "<string>",
  "personnel_id": "<string>",
  "company_id": "<string>",
  "ordering_personnel_id": "<string>",
  "companies_personnel_orderables_id": "<string>",
  "name": "<string>",
  "cost": "<string>",
  "date": "<string>",
  "formatted_date": "<string>",
  "status": "0",
  "response_message": "<string>",
  "submitter": "<string>",
  "reach_out_email": "<string>",
  "deduction_types_id": "<string>",
  "status_datetime": "<string>"
}
The id in the request body refers to an orderable item configured under time_tracking.personnel_orderables in GET /config.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
id
string
required

Worker ID

Body

application/json
​
id
string
required

Orderable item ID from GET /config (time_tracking.personnel_orderables).

​
p_id
string
required

Worker's personnel ID.

Response

Created

A worker order for an orderable item (e.g., uniforms, equipment).

​
id
string

Order identifier.

​
personnel_id
string

Worker's personnel identifier.

​
company_id
string

Company identifier.

​
ordering_personnel_id
string

Personnel ID of the user who placed the order.

​
companies_personnel_orderables_id
string

Orderable item ID from configuration.

​
name
string

Name of the ordered item.

​
cost
string

Cost of the order (e.g. "27.00").

​
date
string

Raw order timestamp (YYYY-MM-DD HH:mm:ss).

​
formatted_date
string

Human-readable order date (e.g. "Mar 19, 2026").

​
status
enum<string>

Order status: "0" = pending, "1" = approved, "2" = completed.

Available options:
0,
1,
2
​
response_message
string | null

Response message from the approver, if any.

​
submitter
string

Name of the person who submitted the order.

​
reach_out_email
string

Email address associated with the order.

​
deduction_types_id
string

Deduction type identifier for payroll.

​
status_datetime
string

Timestamp of the last status change (YYYY-MM-DD HH:mm:ss).