GET /trades/{id}

Agency-scoped keys

This endpoint is not available for agency-scoped API keys.

Summary

Get trade

URL Parameters

Name	Type	Required	Description
id	string	Yes	Trade id or nanoid

Query Parameters

Name	Type	Required	Description
includeRates	boolean	No	Include rate records for this trade
includeCompetencyMatrix	boolean	No	Include competency matrix entries for this trade

Request Example

cURL

curl -X GET 'https://api.requidex.com/api/open/v1/trades/{id}?includeRates=true&includeCompetencyMatrix=true' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

const response = await fetch(
  "https://api.requidex.com/api/open/v1/trades/{id}?includeRates=true&includeCompetencyMatrix=true",
  {
    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/trades/{id}?includeRates=true&includeCompetencyMatrix=true',
    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/trades/{id}?includeRates=true&includeCompetencyMatrix=true", 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
active	boolean	Whether trade is active
company	object	Company reference with id and name
competencyMatrix	array	Returned only when includeCompetencyMatrix=true. Show child attributes sector object - Sector reference with id and name requirements array - Requirement rules Show child attributes rule string - Requirement rule items array - Qualification items with child attribute name groups array - Grouped qualification items, each with child attribute name
createdAt	string	Creation timestamp
description	string	Trade description
id	string	Trade id
masterTrade	object	Master trade reference with id and name
name	string	Trade name
rates	array	Returned only when includeRates=true. Show child attributes id string - Rate id region object - Region reference with id and name sector object - Sector reference with id and name project object - Project reference with id and name agency object - Agency reference with id and name rates object - Rate sets for cis, paye, and psc Show child attributes pay number emp number margin number charge number comparablePayRate number dayRates object - Day rate sets for cis, paye, and psc Show child attributes pay number emp number margin number charge number comparablePayRate number pieceRates array - Piece-rate rows. Each row includes id, code, name, unitLabel, unitLabelPlural, frequency, and values for CIS, PAYE, and PSC.
tags	array	Trade tags with id, name, and description
updatedAt	string	Last update timestamp

Response Example (200)

{
  "success": true,
  "data": {
    "id": "67bc36db80a1616ec3f47031",
    "name": "Electrician",
    "description": "Electrical installation and maintenance",
    "active": true,
    "company": {
      "id": "67bc36db80a1616ec3f47001",
      "name": "Requidex Construction Ltd"
    },
    "masterTrade": {
      "id": "67bc36db80a1616ec3f47090",
      "name": "Electrical"
    },
    "tags": [
      {
        "id": "67bc36db80a1616ec3f47111",
        "name": "High Voltage",
        "description": "Trades approved for high voltage works"
      }
    ],
    "createdAt": "2026-01-10T12:00:00.000Z",
    "updatedAt": "2026-02-20T14:03:12.111Z",
    "rates": [
      {
        "id": "67bc36db80a1616ec3f47040",
        "region": {
          "id": "67bc36db80a1616ec3f47010",
          "name": "South East"
        },
        "sector": {
          "id": "67bc36db80a1616ec3f47020",
          "name": "Commercial"
        },
        "project": null,
        "agency": null,
        "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",
            "unitLabel": "metre",
            "unitLabelPlural": "metres",
            "frequency": "daily",
            "values": {
              "cis": {
                "pay": 12.5,
                "emp": 0,
                "margin": 2.5,
                "charge": 15
              },
              "paye": null,
              "psc": null
            }
          }
        ]
      }
    ],
    "competencyMatrix": [
      {
        "sector": {
          "id": "67bc36db80a1616ec3f47020",
          "name": "Commercial"
        },
        "requirements": [
          {
            "rule": "mandatory",
            "items": [
              {
                "name": "ECS Gold Card"
              }
            ],
            "groups": []
          }
        ]
      }
    ]
  }
}

Errors

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