Try a request

Loading API specification…

API keyBearer authentication

Held in memory for this tab only. Clear it or refresh to forget it.

Code examplecURLJavaScriptPython

curl --request GET \
  --url 'https://api.requidex.com/api/open/v1/rates/{id}' \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Accept: application/json'

Requests go directly to the production API and use your key’s scopes and rate limits. GET requests only.

Get Rate

GET/rates/{id}

Access

Requirement	Value
Scope	read:rates
Company-scoped keys	Supported
Agency-scoped keys	Supported within agency access

Summary

Returns one rate by its id or internal nanoid. This endpoint requires the read:rates scope and returns the same rate fields as the list endpoint without pagination metadata.

Agency-scoped API keys can retrieve only generic rates and their own project or company-agency rates within their company and project access. A rate that exists but is outside the key's access is returned as 404 Rate not found.

For agency-specific rates, hourly, daily, and piece-rate margin and charge values include the resolved agency markup adjustment. A trade-specific adjustment replaces the agency default adjustment for that trade.

Path Parameters

Name	Type	Required	Description
id	string	Yes	Rate id or nanoid

Request Example

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

Response Fields

Field	Type	Description
id	string	Rate id
region	object or null	Response region Show child attributes id string or null — Entity id name string — Entity name
sector	object or null	Response sector Show child attributes id string or null — Entity id name string — Entity name
project	object or null	Response project Show child attributes id string or null — Entity id name string — Entity name
agency	object or null	Response agency Show child attributes id string or null — Entity id name string — Entity name
rates	object	Response rates Show child attributes cis object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null paye object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null psc object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null
dayRates	object	Response dayRates Show child attributes cis object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null paye object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null psc object or null Show child attributes pay number or null emp number or null margin number or null charge number or null comparablePayRate number or null
pieceRates	array of objects	Piece-rate values. For agency-specific rates, margin and charge include the resolved agency adjustment, including a matching trade override. Show child attributes id string or null code string or null name string or null active boolean unitLabel string or null unitLabelPlural string or null frequency string or null values object Show child attributes cis object or null Show child attributes pay number or null emp number or null margin number or null charge number or null paye object or null Show child attributes pay number or null emp number or null margin number or null charge number or null psc object or null Show child attributes pay number or null emp number or null margin number or null charge number or null
trade	object or null	Response trade Show child attributes id string or null — Entity id name string — Entity name
company	object or null	Response company Show child attributes id string or null — Entity id name string — Entity name
createdAt	string	Creation timestamp
updatedAt	string	Last update timestamp

Response Example (200)

{
  "success": true,
  "data": {
    "id": "67bc36db80a1616ec3f47030",
    "trade": {
      "id": "67bc36db80a1616ec3f47010",
      "name": "Electrician"
    },
    "company": {
      "id": "67bc36db80a1616ec3f47001",
      "name": "Requidex Construction Ltd"
    },
    "region": {
      "id": "67bc36db80a1616ec3f47002",
      "name": "South East"
    },
    "sector": {
      "id": "67bc36db80a1616ec3f47020",
      "name": "Commercial"
    },
    "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": [],
    "createdAt": "2026-01-10T12:00:00.000Z",
    "updatedAt": "2026-02-20T14:03:12.111Z"
  }
}

MCP Tool

The MCP server exposes this operation as open_api_get_rate with the input id.

Errors

HTTP Status	Description
400	Invalid or missing rate id
401	Missing, invalid, revoked, or expired API key
403	Forbidden due to scope or IP restrictions
404	Rate not found or not available to the API key
405	Method not allowed on Open API routes
429	Rate limit exceeded
500	Unexpected internal error