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
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, when the assignment has been confirmed
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
tag	object	Show child attributes id string - Tag id name string - Tag 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, when lodge travel distance is available
requisition	object	Show child attributes id string - Requisition id reference string - Requisition reference
shiftPattern	object	Show child attributes m, t, w, th, f, s, su object - Daily shift definitions Each day object includes start number - Shift start hour Each day object includes end number - Shift end hour Each day object includes active boolean - Whether the day is active Each day object includes break number - Break duration in minutes Each day object includes night boolean - Whether the shift is a night shift
costCode	object	Show child attributes name string - Cost code name description string - Cost code description
replacement	object	Returned when the assignment is linked to replacement data. Show child attributes replacedBy object - Replacement assignment (id, reference) replacementFor object - Original assignment (id, reference) requisition object - Replacement requisition (id, reference) reason string - Replacement reason type string - Replacement type (temporary, permanent)
clone	object	Returned when the assignment was cloned. Show child attributes date string - Clone timestamp in ISO 8601 date-time format original object - Source assignment (id, reference)
lodge	object	Returned when lodge details are stored on the assignment. Show child attributes address object - Lodge address distanceMiles number - Distance from lodge to site in miles travel object - Travel estimates with walkMinutes, busMinutes, carMinutes, trainMinutes, and calculatedAt
workActivity	string	Work activity name
competencyRequirements	array[object]	Returned when assignment-specific custom competency requirements are present. Show child attributes rule string - Requirement rule items array[object] - Direct qualifications with name groups array[object] - Qualification groups where each group contains items with 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	Returned when enhanced uplifts are disabled. 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	Returned when enhanced uplifts are enabled. Show child attributes enabled boolean - Whether enhanced uplifts are enabled mode string - Enhanced uplift calculation mode weekly object - Weekly threshold settings Show child attributes threshold number - Weekly hours threshold enforce boolean - Whether the weekly threshold must be worked before weekday uplifts apply reduce boolean - Whether authorised absences reduce the threshold blockThresholds object - Optional weekly threshold overrides keyed by uplift block index, with numeric hour values 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
customDocuments	array[object]	Applicable custom document requirements merged with uploaded assignment documents. Show child attributes id string - Custom document requirement id name string - Requirement name description string - Requirement description required boolean - Whether the requirement is mandatory uploadPermissions object - Upload permissions (company, supplier) attachment string - Uploaded document URL, when present uploadedBy string - Uploading user id, when present uploadedAt string - Upload timestamp in ISO 8601 date-time format expiry string - Document expiry timestamp in ISO 8601 date-time format inactive boolean - Present when the uploaded document belongs to an inactive requirement
metaFields	array[object]	Configured assignment meta fields with resolved values. Show child attributes id string - Meta field id title string - Meta field title type string - Meta field type (freeText or dynamicField) value string - Resolved value display array[string] - Configured display targets (ui, pdf)
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",
      "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"
      },
      "tag": {
        "id": "67bc36db80a1616ec3f47088",
        "name": "Rail"
      },
      "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"
      },
      "shiftPattern": {
        "m": { "start": 8, "end": 17, "active": true, "break": 30, "night": false },
        "t": { "start": 8, "end": 17, "active": true, "break": 30, "night": false },
        "w": { "start": 8, "end": 17, "active": true, "break": 30, "night": false },
        "th": { "start": 8, "end": 17, "active": true, "break": 30, "night": false },
        "f": { "start": 8, "end": 17, "active": true, "break": 30, "night": false },
        "s": { "start": null, "end": null, "active": false, "break": null, "night": false },
        "su": { "start": null, "end": null, "active": false, "break": null, "night": false }
      },
      "costCode": {
        "name": "CC-001",
        "description": "Trackside installation"
      },
      "replacement": {
        "replacedBy": {
          "id": "67bc36db80a1616ec3f49002",
          "reference": "A1045"
        },
        "replacementFor": {
          "id": "67bc36db80a1616ec3f49003",
          "reference": "A0999"
        },
        "requisition": {
          "id": "67bc36db80a1616ec3f48124",
          "reference": "REQ-R1003"
        },
        "reason": "Worker unavailable",
        "type": "temporary"
      },
      "clone": {
        "date": "2026-02-18T10:15:00.000Z",
        "original": {
          "id": "67bc36db80a1616ec3f49000",
          "reference": "A1043"
        }
      },
      "lodge": {
        "address": {
          "lineOne": "2 Lodge Lane",
          "city": "Manchester",
          "country": "United Kingdom",
          "code": "M1 2AB"
        },
        "distanceMiles": 4.8,
        "travel": {
          "walkMinutes": 18,
          "busMinutes": 12,
          "carMinutes": 7,
          "trainMinutes": null,
          "calculatedAt": "2026-02-25T08:45:00.000Z"
        }
      },
      "workActivity": "Install containment",
      "competencyRequirements": [
        {
          "rule": "mandatory",
          "items": [{ "name": "CSCS Gold Card" }],
          "groups": [
            {
              "items": [{ "name": "PASMA" }, { "name": "IPAF" }]
            }
          ]
        }
      ],
      "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
      },
      "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",
      "customDocuments": [
        {
          "id": "67bc36db80a1616ec3f49051",
          "name": "Passport copy",
          "description": "Photo page",
          "required": true,
          "uploadPermissions": {
            "company": true,
            "supplier": false
          },
          "attachment": "https://files.requidex.com/passport-copy.pdf",
          "uploadedBy": "67bc36db80a1616ec3f49091",
          "uploadedAt": "2026-02-25T10:30:00.000Z",
          "expiry": "2027-02-25T00:00:00.000Z"
        }
      ],
      "metaFields": [
        {
          "id": "meta-support",
          "title": "Support email",
          "type": "dynamicField",
          "value": "support@project-alpha.test",
          "display": ["ui"]
        }
      ],
      "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
  }
}