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. 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)

Request Body Fields

No request body is accepted for this endpoint.

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
id	string	Rate id
trade	object	Show child attributes id string - Trade id name string - Trade name
company	object	Show child attributes id string - Company id name string - Company name
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
project	object	Show child attributes id string - Project id name string - Project name
agency	object	Show child attributes id string - Agency id name string - Agency 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
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
createdAt	string	Creation timestamp
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
      },
      "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