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

curl --request GET \
  --url https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/embed

import 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

200

{
  "agent_url": "<string>",
  "role": "<string>",
  "badge_svg_url": "<string>",
  "registry_url": "<string>",
  "html": "<string>",
  "markdown": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Path Parameters

encodedUrl · string · required

URL-encoded agent URL

role · string · required

Badge role

Response

200

application/json

Embed code

agent_url · string · required

role · string · required

badge_svg_url · string · required

registry_url · string · required

html · string · required

markdown · string · required