GET /purchase-orders/{id}

Summary

Get purchase order

URL Parameters

Name	Type	Required	Description
id	string	Yes	Purchase order identifier

Query Parameters

• None

Request Body Fields

No request body is accepted for this endpoint.

Request Example

cURL

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

JavaScript

const response = await fetch(
  "https://api.requidex.com/api/open/v1/purchase-orders/{id}",
  {
    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/purchase-orders/{id}',
    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/purchase-orders/{id}", 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	Purchase order id
status	string	Purchase order status
reference	string	Purchase order reference
startDate	string	Purchase order start date
endDate	string	Purchase order end date
value	number	Purchase order value
company	object	Show child attributes id string - Company id name string - Company name
projects	array[object]	Project references with id and name
site	object	Show child attributes id string - Site id name string - Site name
agency	object	Show child attributes id string - Agency id name string - Agency name
trades	array[object]	Trade references with id and name
allTrades	boolean	Whether the purchase order applies to all trades
tradeOption	string	Trade selection mode
tag	object	Only included when a tag is set. Show child attributes id string - Tag id name string - Tag name
revoked	object	Only included when the purchase order has been revoked. Show child attributes user object - User reference with id and name date string - Revocation timestamp
reinstated	object	Only included when the purchase order has been reinstated. Show child attributes user object - User reference with id and name date string - Reinstatement timestamp
createdAt	string	Creation timestamp
updatedAt	string	Last update timestamp

Response Example (200)

{
  "success": true,
  "data": {
    "id": "67bc36db80a1616ec3f48001",
    "status": "inactive",
    "reference": "PO-44321",
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-06-30T23:59:59.999Z",
    "value": 150000,
    "company": {
      "id": "67bc36db80a1616ec3f47001",
      "name": "Requidex Construction Ltd"
    },
    "projects": [
      {
        "id": "67bc36db80a1616ec3f47011",
        "name": "Project Alpha"
      }
    ],
    "site": {
      "id": "67bc36db80a1616ec3f47055",
      "name": "Manchester Central"
    },
    "agency": {
      "id": "67bc36db80a1616ec3f47060",
      "name": "Agency One"
    },
    "trades": [
      {
        "id": "67bc36db80a1616ec3f47031",
        "name": "Electrician"
      }
    ],
    "allTrades": false,
    "tradeOption": "specific",
    "tag": {
      "id": "67bc36db80a1616ec3f47099",
      "name": "Rail"
    },
    "revoked": {
      "user": {
        "id": "67bc36db80a1616ec3f49998",
        "name": "Alex Carter"
      },
      "date": "2026-02-01T10:00:00.000Z"
    },
    "createdAt": "2026-01-10T12:00:00.000Z",
    "updatedAt": "2026-02-20T14:03:12.111Z"
  }
}

Errors

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