GET /rates/{id}

Summary

Get rate

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 agency rates for projects they can access. A rate that exists but is outside the key's access is returned as 404 Rate not found.

URL Parameters

Name	Type	Required	Description
id	string	Yes	Rate id or nanoid

Query Parameters

• None

Request Example

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

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"
  }
}

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