FAfactorialhr
Procurement > PurchaseRequest

Reads a single Purchase request

Changed on

Fetch one or all purchase requests for the company.

get/api/2026-10-01/resources/procurement/purchase_requests/{id}

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/procurement/purchase_requests/{id}
  • Auth
    API key in header x-api-key

Path parameters

idstring required

An array of purchase request IDs to filter by.

Response

OK

idstring required

Unique identifier of the purchase request

descriptionstring required

Description or notes about the purchase request

type_idstring required

The id of the referred type

company_idstring

Identifier of the company that owns this purchase request

datestring required

Date when the purchase request was created

requester_employee_idstring required

Identifier of the employee who requested this purchase

vendor_idstring

Identifier of the vendor (contact) associated with this purchase request

status'approved' | 'draft' | 'pending' | 'rejected' | 'changes_requested' required

Current status of the purchase request

urlstring

URL related to the purchase request (e.g., product link)

additional_informationstring

Additional information or notes about the purchase request

rejection_reasonstring

Reason for rejection if the purchase request was rejected

deadlinestring

Deadline date for the purchase request

Example response

{
  "id": "678432",
  "description": "Office supplies request",
  "type_id": "12353",
  "company_id": "1",
  "cost": {
    "cents": 10000,
    "currency": "EUR"
  },
  "date": "2025-01-15",
  "requester_employee_id": "20",
  "vendor_id": "9012",
  "status": "pending",
  "url": "https://example.com/product",
  "additional_information": "Urgent delivery required",
  "rejection_reason": "Budget exceeded",
  "deadline": "2025-02-15"
}

Changes