GET /requisitions

Summary

List requisitions

URL Parameters

• None

Query Parameters

Name	Type	Required	Description
page	integer	No	Page number (default 1)
limit	integer	No	Records per page (default 50, max 200)
status	enum(raised, approved, filled, cancelled, rejected)	No	Filter by derived requisition status
project	string	No	Filter by project id
site	string	No	Filter by site id
costCode	string	No	Filter by cost code id
trade	string	No	Filter by trade id
agency	string	No	Filter by agency id
query	string	No	Case-insensitive search against requisition reference
from	string	No	Created date filter start (YYYY-MM-DD)
to	string	No	Created date filter end (YYYY-MM-DD)
sortBy	enum(createdAt, updatedAt, reqRef, approvedDate)	No	Sort field
sortOrder	enum(asc, desc)	No	Sort direction

Request Body Fields

No request body is accepted for this endpoint.

Request Example

cURL

curl -X GET 'https://api.requidex.com/api/open/v1/requisitions' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

const response = await fetch('https://api.requidex.com/api/open/v1/requisitions', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer <API_KEY>',
    Accept: 'application/json',
  },
});

const json = await response.json();

Python

import requests

response = requests.request(
    'GET',
    'https://api.requidex.com/api/open/v1/requisitions',
    headers={
        'Authorization': 'Bearer <API_KEY>',
        'Accept': 'application/json',
    },
    timeout=30,
)

print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.requidex.com/api/open/v1/requisitions", nil)
  req.Header.Set("Authorization", "Bearer <API_KEY>")
  req.Header.Set("Accept", "application/json")

  client := &http.Client{}
  resp, err := client.Do(req)
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  payload, _ := io.ReadAll(resp.Body)
  fmt.Println(string(payload))
}

Response Fields

Field	Type	Description
id	string	Requisition id
nanoid	string	Short requisition id
reference	string	Requisition reference
status	enum(raised, approved, filled, cancelled, rejected)	Derived requisition status
quantity	number	Requested worker quantity
company	object	Show child attributes id string - Entity id name string - Entity name
project	object	Show child attributes id string - Entity id name string - Entity name
region	object	Show child attributes id string - Entity id name string - Entity name
sector	object	Show child attributes id string - Entity id name string - Entity name
site	object	Show child attributes id string - Entity id name string - Entity name
trade	object	Show child attributes id string - Entity id name string - Entity name
activity	object	Show child attributes id string - Entity id name string - Entity name
startDate	string	Planned start date
endDate	string	Planned end date
approvedDate	string	Final approval timestamp
createdAt	string	Creation timestamp
updatedAt	string	Last update timestamp

Response Example (200)

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f48123",
      "nanoid": "req01abcde",
      "reference": "REQ-R1002",
      "status": "raised",
      "quantity": 4,
      "company": {
        "id": "67bc36db80a1616ec3f47001",
        "name": "Requidex Construction Ltd"
      },
      "project": {
        "id": "67bc36db80a1616ec3f47011",
        "name": "Northern Rail Electrification"
      },
      "region": {
        "id": "67bc36db80a1616ec3f47002",
        "name": "North West"
      },
      "sector": {
        "id": "67bc36db80a1616ec3f47003",
        "name": "Rail"
      },
      "site": {
        "id": "67bc36db80a1616ec3f47055",
        "name": "Manchester Central"
      },
      "trade": {
        "id": "67bc36db80a1616ec3f47077",
        "name": "Electrician"
      },
      "activity": {
        "id": "67bc36db80a1616ec3f47099",
        "name": "Install containment"
      },
      "startDate": "2026-03-01T00:00:00.000Z",
      "endDate": "2026-03-31T23:59:59.999Z",
      "approvedDate": null,
      "createdAt": "2026-02-20T11:10:00.000Z",
      "updatedAt": "2026-02-20T11:10:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1
  }
}

Errors

HTTP Status	Description
401	Missing, invalid, revoked, or expired API key
403	Forbidden due to scope or IP restrictions
405	Method not allowed on Open API routes
429	Rate limit exceeded
500	Unexpected internal error