Get embeddable badge code
curl --request GET \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embedimport requests
url = "https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed', 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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed",
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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed"
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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed")
.asString();require 'uri'
require 'net/http'
url = URI("https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed")
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{
"agent_url": "<string>",
"verified": true,
"badge_svg_url": "<string>",
"registry_url": "<string>",
"html": "<string>",
"markdown": "<string>",
"adcp_version": "<string>"
}{
"error": "<string>",
"code": "invalid_role",
"message": "<string>",
"valid_roles": []
}{
"error": "<string>"
}{
"error": "<string>"
}Agent Compliance
Get embeddable badge code
Returns HTML and Markdown embed snippets for displaying an AAO Verified badge on websites, social profiles, and documentation. The badge links to the agent’s AAO registry listing.
GET
/
api
/
registry
/
agents
/
{encodedUrl}
/
badge
/
{role}
/
embed
Get embeddable badge code
curl --request GET \
--url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embedimport requests
url = "https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed', 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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed",
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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed"
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://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed")
.asString();require 'uri'
require 'net/http'
url = URI("https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed")
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{
"agent_url": "<string>",
"verified": true,
"badge_svg_url": "<string>",
"registry_url": "<string>",
"html": "<string>",
"markdown": "<string>",
"adcp_version": "<string>"
}{
"error": "<string>",
"code": "invalid_role",
"message": "<string>",
"valid_roles": []
}{
"error": "<string>"
}{
"error": "<string>"
}Path Parameters
URL-encoded agent URL
Canonical badge role
Available options:
media-buy, creative, signals, governance, brand, sponsored-intelligence ⌘I