GET /assignments

Summary

List assignments

URL Parameters

• None

Query Parameters

Name	Type	Required	Description
company	string	No	Filter by company id. If omitted, data for all companies linked to the API key is returned.
page	integer	No	Page number (default 1)
limit	integer	No	Records per page (default 50, max 200)
status	enum(pending, confirmed, cancelled, completed, ended)	No	Filter by assignment status
project	string	No	Filter by project id
site	string	No	Filter by site id
trade	string	No	Filter by trade id
worker	string	No	Filter by worker id
agency	string	No	Filter by agency id
requisition	string	No	Filter by requisition id
query	string	No	Case-insensitive search against assignment reference, worker name/reference, and agency name
from	string	No	Created date filter start (YYYY-MM-DD)
to	string	No	Created date filter end (YYYY-MM-DD)
sortBy	enum(createdAt, updatedAt, assignmentRef, startDate, endDate)	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/assignments' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

const response = await fetch("https://api.requidex.com/api/open/v1/assignments", {
  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/assignments',
    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/assignments", 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	Assignment id
nanoid	string	Short assignment id
reference	string	Assignment reference
status	enum(pending, confirmed, cancelled, completed, ended)	Assignment status
payType	enum(hourly, daily)	Pay type
rateType	enum(cis, paye, psc)	Rate type
confirmationDate	string	Confirmation timestamp in ISO 8601 date-time format
cancellation	object	Show child attributes reason string - Cancellation reason date string - Cancellation timestamp in ISO 8601 date-time format comments string - Cancellation comments user object - Cancelling user (id, name)
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
agency	object	Show child attributes id string - Entity id name string - Entity name
umbrella	string	Umbrella company name
worker	object	Show child attributes id string - Worker id reference string - Worker reference name string - Worker name
workerDistanceToSite	number	Worker distance to site, in miles
workerLodgeDistanceToSite	number	Worker lodge distance to site, in miles
requisition	object	Show child attributes id string - Requisition id reference string - Requisition reference
costCode	object	Show child attributes name string - Cost code name description string - Cost code description
workActivity	string	Work activity name
rates	object	Show child attributes pay number - Pay rate charge number - Charge rate
values	object	Show child attributes pay number - Pay value charge number - Charge value
rateUplifts	object	Show child attributes bh number - Bank holiday uplift percentage bhNw number - Bank holiday night uplift percentage wdOt number - Weekday overtime uplift percentage sat number - Saturday uplift percentage sun number - Sunday uplift percentage wdNw number - Weekday night uplift percentage weNw number - Weekend night uplift percentage
enhancedUplifts	object	Show child attributes enabled boolean - Whether enhanced uplifts are enabled breakdown array[object] - Enhanced uplift breakdown rows breakdown[].date string - Breakdown row date in ISO 8601 date-time format, where available breakdown[].dayOfWeek string - Day of week breakdown[].shiftType string - Shift type breakdown[].blockStartHour number - Block start hour breakdown[].blockEndHour number - Block end hour breakdown[].blockHours number - Hours in the block breakdown[].upliftPercentage number - Applied uplift percentage breakdown[].chargeRate number - Charge rate for the block breakdown[].chargeValue number - Charge value for the block breakdown[].payRate number - Pay rate for the block breakdown[].payValue number - Pay value for the block
lodgeApplicable	boolean	Whether lodge/accommodation is applicable
weeksElapsed	integer	Full weeks elapsed since confirmation or start
purchaseOrder	string	Purchase order reference
sds	object	Show child attributes status string - SDS status attachment string - SDS attachment URL
sdc	object	Show child attributes status string - SDC status attachment string - SDC attachment URL
kid	string	KID attachment URL
startDate	string	Assignment start date in ISO 8601 date-time format
endDate	string	Assignment end date in ISO 8601 date-time format
timesheetStartDate	string	Timesheet start date in ISO 8601 date-time format
completedDate	string	Completion timestamp in ISO 8601 date-time format
createdAt	string	Creation timestamp in ISO 8601 date-time format
updatedAt	string	Last update timestamp in ISO 8601 date-time format

Response Example (200)

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f49001",
      "nanoid": "asg01abcd2",
      "reference": "A1044",
      "status": "confirmed",
      "payType": "hourly",
      "rateType": "cis",
      "confirmationDate": "2026-02-24T09:00:00.000Z",
      "cancellation": null,
      "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"
      },
      "agency": {
        "id": "67bc36db80a1616ec3f47101",
        "name": "Northline Labour Desk"
      },
      "umbrella": "UmbrellaCo",
      "worker": {
        "id": "67bc36db80a1616ec3f48999",
        "reference": "WK-1044",
        "name": "Jordan Smith"
      },
      "workerDistanceToSite": 12.4,
      "workerLodgeDistanceToSite": 4.8,
      "requisition": {
        "id": "67bc36db80a1616ec3f48123",
        "reference": "REQ-R1002",
        "nanoid": "req01abcde"
      },
      "costCode": {
        "name": "CC-001",
        "description": "Trackside installation"
      },
      "workActivity": "Install containment",
      "rates": {
        "pay": 21.5,
        "charge": 28.75
      },
      "values": {
        "pay": 3440,
        "charge": 4600
      },
      "rateUplifts": {
        "bh": 100,
        "bhNw": 125,
        "wdOt": 50,
        "sat": 50,
        "sun": 100,
        "wdNw": 25,
        "weNw": 40
      },
      "enhancedUplifts": {
        "enabled": true,
        "breakdown": [
          {
            "date": "2026-03-03T00:00:00.000Z",
            "dayOfWeek": "Tuesday",
            "shiftType": "dayShift",
            "blockStartHour": 8,
            "blockEndHour": 12,
            "blockHours": 4,
            "upliftPercentage": 25,
            "chargeRate": 35.94,
            "chargeValue": 143.76,
            "payRate": 26.88,
            "payValue": 107.52
          }
        ]
      },
      "lodgeApplicable": true,
      "weeksElapsed": 6,
      "purchaseOrder": "PO-44321",
      "sds": null,
      "sdc": {
        "status": "confirmed",
        "attachment": "https://files.requidex.com/sdc-confirmation.pdf"
      },
      "kid": "https://files.requidex.com/kid.pdf",
      "startDate": "2026-03-01T00:00:00.000Z",
      "endDate": "2026-03-31T23:59:59.999Z",
      "timesheetStartDate": "2026-03-03T00:00:00.000Z",
      "completedDate": null,
      "createdAt": "2026-02-20T11:30:00.000Z",
      "updatedAt": "2026-02-21T09:15:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1
  }
}