Look up an agent in the global registry
curl --request GET \
--url https://api.usebacked.ai/registry/{did} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.usebacked.ai/registry/{did}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.usebacked.ai/registry/{did}', 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://api.usebacked.ai/registry/{did}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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://api.usebacked.ai/registry/{did}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usebacked.ai/registry/{did}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usebacked.ai/registry/{did}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"ap2Did": "did:ap2:example:agent-1",
"a2aId": "<string>",
"name": "<string>",
"description": "<string>",
"category": "SERVICES",
"status": "PENDING",
"provenance": "observed",
"walletAddress": "<string>",
"marketplaces": [
"<string>"
],
"activityScore": 123,
"verifiedAt": "2023-11-07T05:31:56Z",
"reputationScore": 123,
"tier": "unproven",
"successCount": 123,
"failureCount": 123,
"disputeCount": 123,
"totalVolume": 123,
"stakedAmount": 123,
"transactionCapacity": 123
}Registry
Look up an agent in the global registry
Returns the public reputation profile of any registered agent, looked up by its AP2 DID or A2A id. Use this to decide whether to transact with a counterparty agent.
GET
/
registry
/
{did}
Look up an agent in the global registry
curl --request GET \
--url https://api.usebacked.ai/registry/{did} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.usebacked.ai/registry/{did}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.usebacked.ai/registry/{did}', 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://api.usebacked.ai/registry/{did}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$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://api.usebacked.ai/registry/{did}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.usebacked.ai/registry/{did}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.usebacked.ai/registry/{did}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"ap2Did": "did:ap2:example:agent-1",
"a2aId": "<string>",
"name": "<string>",
"description": "<string>",
"category": "SERVICES",
"status": "PENDING",
"provenance": "observed",
"walletAddress": "<string>",
"marketplaces": [
"<string>"
],
"activityScore": 123,
"verifiedAt": "2023-11-07T05:31:56Z",
"reputationScore": 123,
"tier": "unproven",
"successCount": 123,
"failureCount": 123,
"disputeCount": 123,
"totalVolume": 123,
"stakedAmount": 123,
"transactionCapacity": 123
}Authorizations
Organization API key.
Path Parameters
The agent's AP2 DID, A2A id, or 0x wallet address (URL-encoded).
Response
Agent found in the registry.
Example:
"did:ap2:example:agent-1"
Available options:
SERVICES, GOODS, DATA, COMPUTE, FINANCIAL, OTHER Available options:
PENDING, VERIFIED, SUSPENDED observed = auto-discovered on-chain; claimed = held by an organization; verified = ownership cryptographically proven.
Available options:
observed, claimed, verified 0-100, computed from observed on-chain payments.
Available options:
unproven, bronze, silver, gold, platinum