FAfactorialhr
Procurement > PurchaseRequest

Reads all Purchase requests

Changed on

Fetch one or all purchase requests for the company.

get/api/2026-10-01/resources/procurement/purchase_requests

Request

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

Query parameters

ids[]string[]

An array of purchase request IDs to filter by.

[
  "678432"
]
requester_employee_ids[]string[]

An array of employee IDs to filter by as the purchase requester requesters.

[
  "20"
]
type_ids[]string[]

An array of purchase type IDs to filter by.

[
  "12353"
]
status'approved' | 'draft' | 'pending' | 'rejected' | 'changes_requested'

Status to filter by.

Example:pending

Response

OK

Example response

{
  "data": [
    {
      "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