Skip to main content
GET
/
List All Agents
curl --request GET \
  --url https://server.sellagent.ai/api/agent/ \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>'
import requests

url = "https://server.sellagent.ai/api/agent/"

headers = {
"x-api-key": "<x-api-key>",
"Content-Type": "<content-type>"
}

response = requests.get(url, headers=headers)

print(response.text)
const options = {
method: 'GET',
headers: {'x-api-key': '<x-api-key>', 'Content-Type': '<content-type>'}
};

fetch('https://server.sellagent.ai/api/agent/', 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://server.sellagent.ai/api/agent/",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Content-Type: <content-type>",
"x-api-key: <x-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://server.sellagent.ai/api/agent/"

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

req.Header.Add("x-api-key", "<x-api-key>")
req.Header.Add("Content-Type", "<content-type>")

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://server.sellagent.ai/api/agent/")
.header("x-api-key", "<x-api-key>")
.header("Content-Type", "<content-type>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://server.sellagent.ai/api/agent/")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = '<content-type>'

response = http.request(request)
puts response.read_body
[
  {
    "_id": "686679f702bfb2054ec3d1f0",
    "name": "Appointement Setter Agent",
    "type": "Single Prompt",
    "firstMessage": "Hello, how can I help you today?",
    "modelType": "deepseek/deepseek-chat-v3-0324",
    "backgroundSound": {
      "volume": 30
    },
    "dynamicVariables": {
      "first_name": "John"
    },
    "webhookURL": "Url endpoint",
    "language": {
      "code": "en",
      "label": "English",
      "icon": "US"
    },
    "customFunctions": [
      "<unknown>"
    ],
    "voiceMailDetection": false,
    "silenceThreshold": 30,
    "maxCallDuration": 300,
    "pauseBeforeSpeaking": 0,
    "enableRecording": false,
    "enableTranscript": false,
    "providerId": "105922657181422688240",
    "currentWorkspace": "685846b162e555e53cd3aeaa",
    "creditsBalance": 0,
    "currentSubscription": {
      "status": "free",
      "stripeCustomerId": "cus_SarEyKO1v9KQfP"
    },
    "usageMetrics": {
      "callingMinutesUsed": 0,
      "contactsUploaded": 0,
      "emailsSent": 0,
      "lastResetDate": "2025-06-29T16:37:16.234Z",
      "currentPeriodUsage": {
        "callingMinutes": 0,
        "contacts": 0,
        "emails": 0
      }
    },
    "workspaceId": "685846b162e555e53cd3aeaa",
    "modelId": {
      "_id": "68243c0eba21403731844a8c",
      "provider": "OpenRouter",
      "label": "DeepSeek V3",
      "type": "text",
      "currency": "USD",
      "icon": "https://assets-seleagent.s3.us-east-2.amazonaws.com/deepseek.png",
      "modelName": "deepseek/deepseek-chat-v3-0324",
      "cost": 0.01,
      "latency": 400
    },
    "voiceId": {
      "_id": "6800a813e6052d216985b6eb",
      "voiceName": "Luna",
      "accent": "English (US)",
      "gender": "Female",
      "voiceId": "aura-2-luna-en",
      "demoUrl": "https://d2z4jjzwkquvhw.cloudfront.net/Luna.wav",
      "voiceImg": "https://img.freepik.com/...jpg",
      "voiceProvider": "Deepgram",
      "providerId": "68243c0eba21403731844a8a",
      "voiceKey": "aura-2-luna-en"
    },
    "knowledgeBase": [
      "<unknown>"
    ],
    "createdAt": "2025-07-03T12:39:19.318Z",
    "updatedAt": "2025-07-04T20:39:32.968Z",
    "script": "Agent Script"
  }
]
{
"status": "error",
"message": "API key is missing or invalid."
}
{
"status": "error",
"message": "An unexpected server error occurred."
}

Headers

x-api-key
string
required

Your API key for authentication

Content-Type
enum<string>
required

Must be application/json

Available options:
application/json
x-workspace-id
string

Optional Workspace ID. If not provided, defaults to the user's current workspace.

Response

Successfully retrieved all agents

_id
string
required

Unique ID of the agent

Example:

"686679f702bfb2054ec3d1f0"

name
string
required

Name of the agent

Example:

"Appointement Setter Agent"

type
string
required

Agent type (e.g., Single Prompt, Multi-Step)

Example:

"Single Prompt"

firstMessage
string

Initial message spoken by the agent

Example:

"Hello, how can I help you today?"

modelType
string

Model used by the agent

Example:

"deepseek/deepseek-chat-v3-0324"

backgroundSound
object
dynamicVariables
object
webhookURL
string

Model used by the agent

Example:

"Url endpoint"

language
object
customFunctions
any[]

Custom functions used in the agent

voiceMailDetection
boolean
Example:

false

silenceThreshold
integer
Example:

30

maxCallDuration
integer
Example:

300

pauseBeforeSpeaking
integer
Example:

0

enableRecording
boolean
Example:

false

enableTranscript
boolean
Example:

false

providerId
string
Example:

"105922657181422688240"

currentWorkspace
string
Example:

"685846b162e555e53cd3aeaa"

creditsBalance
number
Example:

0

currentSubscription
object
usageMetrics
object
workspaceId
string
Example:

"685846b162e555e53cd3aeaa"

modelId
object
voiceId
object
knowledgeBase
any[]

Knowledge base entries attached to the agent

createdAt
string<date-time>
Example:

"2025-07-03T12:39:19.318Z"

updatedAt
string<date-time>
Example:

"2025-07-04T20:39:32.968Z"

script
string
Example:

"Agent Script"