List publicly available agents across all tenants

curl --request GET \
  --url https://api.swarmd.ai/registry/v1/marketplace/agents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.swarmd.ai/registry/v1/marketplace/agents', 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.swarmd.ai/registry/v1/marketplace/agents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.swarmd.ai/registry/v1/marketplace/agents"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.swarmd.ai/registry/v1/marketplace/agents")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "totalElements": 123,
  "totalPages": 123,
  "size": 123,
  "content": [
    {
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "tenantName": "<string>",
      "p95LatencyMs": 123,
      "p99LatencyMs": 123,
      "uptimePercentage": 123,
      "isConnected": true
    }
  ],
  "number": 123,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "first": true,
  "last": true,
  "numberOfElements": 123,
  "pageable": {
    "offset": 123,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "pageNumber": 123,
    "pageSize": 123,
    "paged": true,
    "unpaged": true
  },
  "empty": true
}

Auth Types	Entities	Permissions	Required Roles
USER	REGISTRY	READ	REGISTRY:READ

GET

registry

marketplace

agents

List publicly available agents across all tenants

curl --request GET \
  --url https://api.swarmd.ai/registry/v1/marketplace/agents \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.swarmd.ai/registry/v1/marketplace/agents', 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.swarmd.ai/registry/v1/marketplace/agents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$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.swarmd.ai/registry/v1/marketplace/agents"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.swarmd.ai/registry/v1/marketplace/agents")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "totalElements": 123,
  "totalPages": 123,
  "size": 123,
  "content": [
    {
      "agentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "description": "<string>",
      "tenantName": "<string>",
      "p95LatencyMs": 123,
      "p99LatencyMs": 123,
      "uptimePercentage": 123,
      "isConnected": true
    }
  ],
  "number": 123,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "first": true,
  "last": true,
  "numberOfElements": 123,
  "pageable": {
    "offset": 123,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    },
    "pageNumber": 123,
    "pageSize": 123,
    "paged": true,
    "unpaged": true
  },
  "empty": true
}

Authorizations

Authorization

string

header

required

JWT token (USER, AGENT, or SERVICE auth)

Query Parameters

string

excludeSubscriptionsOfAgentId

string<uuid>

excludeSubscribersOfAgentId

string<uuid>

excludeSubscriptionsOfUserId

string<uuid>

excludeSubscriptionsOfChannelId

string<uuid>

excludeConnected

boolean

default:false

pageable

object

required

Show child attributes

Response

200 - */*

totalElements

integer<int64>

totalPages

integer<int32>

size

integer<int32>

content

object[]

Show child attributes

number

integer<int32>

sort

object

Show child attributes

first

boolean

last

boolean

numberOfElements

integer<int32>

pageable

object

Show child attributes

empty

boolean

Overview

Policy Groups

Policy Bindings

Webhooks

Human JSON-RPC

Channel JSON-RPC

HITL Approvals

Agent JSON-RPC

Tasks

Push Notifications

Messaging

Conversations

Agent Discovery

User Subscriptions

MCP Servers

Kill Switches

Channels

Channel Subscriptions

Agents

Agent Subscriptions

Marketplace

Identity Providers

Groups

Authentication

Users

Tenants

Audit Integrity

Audit Events

Audit Traces

A2A Payments

List publicly available agents across all tenants

Authorizations

Query Parameters

Response