GET /rates

Summary

List rates

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)
company	string	No	Filter by company id(s). Pass a single id or comma-separated ids. If omitted, rates for all linked companies are returned.
region	string	No	Filter by region id
sector	string	No	Filter by sector id
project	string	No	Filter by project id
agency	string	No	Filter by agency id
query	string	No	Case-insensitive search against trade, region, sector, project, and agency names
from	string	No	Created date filter start (YYYY-MM-DD)
to	string	No	Created date filter end (YYYY-MM-DD)
sortBy	enum(createdAt, updatedAt, tradeName, regionName, sectorName, projectName, supplierName)	No	Sort field (default tradeName)
sortOrder	enum(asc, desc)	No	Sort direction (default asc)
fields	string	No	Comma-separated list of response fields or dot-path nested fields to return

Request Example

cURL

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

JavaScript

const response = await fetch("https://api.requidex.com/api/open/v1/rates", {
  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/rates',
    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/rates", 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
agency	object	Returned only when the rate is agency-specific. Show child attributes id string - Agency id name string - Agency name
company	object	Show child attributes id string - Company id name string - Company name
createdAt	string	Creation timestamp
dayRates	object	Daily rate sets Show child attributes cis object - CIS day-rate set with pay, emp, margin, charge, and comparablePayRate paye object - PAYE day-rate set with pay, emp, margin, charge, and comparablePayRate psc object - PSC day-rate set with pay, emp, margin, charge, and comparablePayRate
id	string	Rate id
pieceRates	array	Piece-rate rows for this rate. Show child attributes id string - Piece rate id code string - Generated piece-rate code name string - Piece-rate name active boolean - Whether the piece rate is active unitLabel string - Singular unit label unitLabelPlural string - Plural unit label frequency enum - daily or weekly values object - CIS, PAYE, and PSC value sets with pay, emp, margin, and charge
project	object	Returned only when the rate is project-specific. Show child attributes id string - Project id name string - Project name
rates	object	Hourly rate sets Show child attributes cis object - CIS rate set with pay, emp, margin, charge, and comparablePayRate paye object - PAYE rate set with pay, emp, margin, charge, and comparablePayRate psc object - PSC rate set with pay, emp, margin, charge, and comparablePayRate
region	object	Show child attributes id string - Region id name string - Region name
sector	object	Show child attributes id string - Sector id name string - Sector name
trade	object	Show child attributes id string - Trade id name string - Trade name
updatedAt	string	Last update timestamp

Response Example (200)

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f47040",
      "trade": {
        "id": "67bc36db80a1616ec3f47031",
        "name": "Electrician"
      },
      "company": {
        "id": "67bc36db80a1616ec3f47001",
        "name": "Requidex Construction Ltd"
      },
      "region": {
        "id": "67bc36db80a1616ec3f47010",
        "name": "South East"
      },
      "sector": {
        "id": "67bc36db80a1616ec3f47020",
        "name": "Commercial"
      },
      "project": {
        "id": "67bc36db80a1616ec3f47050",
        "name": "Project Alpha"
      },
      "agency": {
        "id": "67bc36db80a1616ec3f47060",
        "name": "Agency One"
      },
      "rates": {
        "cis": {
          "pay": 21,
          "emp": 2.5,
          "margin": 3,
          "charge": 26.5,
          "comparablePayRate": 21
        },
        "paye": null,
        "psc": null
      },
      "dayRates": {
        "cis": null,
        "paye": null,
        "psc": null
      },
      "pieceRates": [
        {
          "id": "pr_9X2KLM",
          "code": "PR-A1B2C3",
          "name": "Meters installed",
          "active": true,
          "unitLabel": "metre",
          "unitLabelPlural": "metres",
          "frequency": "daily",
          "values": {
            "cis": {
              "pay": 12.5,
              "emp": 0,
              "margin": 2.5,
              "charge": 15
            },
            "paye": null,
            "psc": null
          }
        }
      ],
      "createdAt": "2026-01-10T12:00:00.000Z",
      "updatedAt": "2026-02-20T14:03:12.111Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 1
  }
}

Errors

HTTP Status	Description
400	Invalid filters or parameters
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