GET /operator/{did}/machines

GET

operator

{did}

machines

curl --request GET \
  --url https://mcr.peaq.xyz/operator/{did}/machines

import requests

url = "https://mcr.peaq.xyz/operator/{did}/machines"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://mcr.peaq.xyz/operator/{did}/machines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcr.peaq.xyz/operator/{did}/machines",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://mcr.peaq.xyz/operator/{did}/machines"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://mcr.peaq.xyz/operator/{did}/machines")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mcr.peaq.xyz/operator/{did}/machines")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

Endpoint

GET /operator/{did}/machines

Returns a paginated list of machines under an , with a full for each machine. The MCR score is computed from the machine’s full history (not bond-only). Machines that are not registered in the IdentityRegistry contract are silently excluded. The server reads the operator’s machines DID attribute and paginates over the full list. Pagination works past 100 machines using offset and limit; the underlying DID-attribute storage is bounded by the peaq DID (~2560 bytes), so very large fleets should iterate offset rather than expect an unbounded single response.

Path parameters

string

required

Operator DID (did:peaq:0x...) or raw EVM address (0x...)

Query parameters

integer

default:"0"

Number of machines to skip before the returned page. Must be >= 0.

integer

default:"20"

Maximum number of machines to return per page. Range 1-20.

Response

200 OK

Field	Type	Description
`operator_did`	string	The operator DID as supplied in the request path
`machines`	array	List of machines registered to this operator (for the current page)
`machines[].did`	string	Machine DID derived from the machine wallet address (`did:peaq:<machine_wallet>`)
`machines[].machine_id`	integer	On-chain machine ID
`machines[].mcr_score`	integer	MCR score 0-100
`machines[].mcr`	string	Letter rating: `AAA`, `AA`, `A`, `BBB`, `BB`, `B`, `NR`, or `Provisioned`
`machines[].negative_flag`	boolean	`true` when the AdminFlags contract has a negative-flag timestamp set for this machine. Stays `true` regardless of whether the 180-day MCR scoring penalty is still active.
`pagination`	object	Pagination metadata
`pagination.offset`	integer	The offset used for this page
`pagination.limit`	integer	The limit used for this page
`pagination.total`	integer	Number of valid machine IDs in the operator’s `machines` DID attribute, after integer validation but before registration filtering. Page slices may be smaller than `limit` because unregistered machines are dropped silently.

An operator with no machines returns 200 with an empty machines array and pagination.total of 0.

Error responses

Status	`detail`	Condition
400	`"Empty DID"`	Path parameter resolves to an empty string
400	`"Invalid Ethereum address format"`	DID or address does not match the expected hex format
422	(FastAPI validation error)	`offset` or `limit` fails validation constraints
503	`"Service not initialised"`	Server started without contract addresses
503	`"Chain unavailable"`	Any chain or DID call failed

Example

curl "${PEAQOS_MCR_API_URL}/operator/did:peaq:0xoperator0000000000000000000000000000001/machines?offset=0&limit=10"

const response = await fetch(
  `${PEAQOS_MCR_API_URL}/operator/did:peaq:0xoperator0000000000000000000000000000001/machines?offset=0&limit=10`
);
const data = await response.json();
console.log(data.machines.length, data.pagination.total);

import requests

response = requests.get(
    f"{PEAQOS_MCR_API_URL}/operator/did:peaq:0xoperator0000000000000000000000000000001/machines",
    params={"offset": 0, "limit": 10},
)
data = response.json()
print(len(data["machines"]), data["pagination"]["total"])

Response

{
  "operator_did": "did:peaq:0xoperator0000000000000000000000000000001",
  "machines": [
    {
      "did": "did:peaq:0xabc1230000000000000000000000000000000001",
      "machine_id": 1,
      "mcr_score": 45,
      "mcr": "BB",
      "negative_flag": false
    },
    {
      "did": "did:peaq:0xdef4560000000000000000000000000000000002",
      "machine_id": 2,
      "mcr_score": 0,
      "mcr": "NR",
      "negative_flag": false
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 2
  }
}

GET /mcr/ returns detailed MCR data for a single machine, including revenue trend and summary.
GET /machine/ returns the full machine profile with data visibility-dependent fields.

GET /metadata/{token_id}Return NFT metadata for a MachineNFT token, intended as an ERC-721 tokenURI target.

⌘I

GET /operator/{did}/machines

curl --request GET \
  --url https://mcr.peaq.xyz/operator/{did}/machines

import requests

url = "https://mcr.peaq.xyz/operator/{did}/machines"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://mcr.peaq.xyz/operator/{did}/machines', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mcr.peaq.xyz/operator/{did}/machines",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://mcr.peaq.xyz/operator/{did}/machines"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://mcr.peaq.xyz/operator/{did}/machines")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mcr.peaq.xyz/operator/{did}/machines")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

​Endpoint

​Path parameters

​Query parameters

​Response

​Error responses

​Example

​Related endpoints

Endpoint

Path parameters

Query parameters

Response

Error responses

Example

Related endpoints