List agents
curl --request GET \
--url https://api.nixflex.com/v1/agentsimport requests
url = "https://api.nixflex.com/v1/agents"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.nixflex.com/v1/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.nixflex.com/v1/agents",
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://api.nixflex.com/v1/agents"
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://api.nixflex.com/v1/agents")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nixflex.com/v1/agents")
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_bodyAgents
List agents
GET /v1/agents
GET
/
v1
/
agents
List agents
curl --request GET \
--url https://api.nixflex.com/v1/agentsimport requests
url = "https://api.nixflex.com/v1/agents"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.nixflex.com/v1/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.nixflex.com/v1/agents",
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://api.nixflex.com/v1/agents"
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://api.nixflex.com/v1/agents")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nixflex.com/v1/agents")
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_bodyReturns your active agents, newest first. Inactive agents are not included. 100 per page by default - page with
Fetch one agent by ID with Get agent.
limit and offset.
Request
curl https://api.nixflex.com/v1/agents \
-H "Authorization: Bearer KEY_ID:KEY_SECRET"
Query parameters
| Parameter | Type | Default | Notes |
|---|---|---|---|
limit | int | 100 | How many agents to return. Hard-capped at 200 per request - a higher value is reduced to 200 rather than rejected. |
offset | int | 0 | How many agents to skip. Combine with limit to page through. |
Response
200 OK returns a JSON array:
[
{
"agent_id": "agent_125207e452f8714a",
"name": "Acme Dental Receptionist",
"system_prompt": "You are the receptionist for...",
"welcome_message": "Good morning, Acme Dental.",
"voice_id": "Dennis",
"language": "en",
"voice_speed": 1,
"temperature": 0.7,
"max_call_duration_seconds": 600,
"silence_hangup_seconds": 20,
"record_call": true,
"webhook_url": null,
"transfer_number": null,
"fallback_message": "Sorry, could you say that again?",
"post_call_sms_enabled": false,
"post_call_sms_template": null,
"data_extraction_fields": [],
"is_active": true,
"created_at": "2026-05-17T03:45:12Z",
"updated_at": "2026-05-17T03:45:12Z"
}
]
Response fields
| Field | Type | Notes |
|---|---|---|
agent_id | string | Unique ID for the agent |
name | string | Display name |
system_prompt | string | The agent’s instructions |
welcome_message | string | What the agent says first |
voice_id | string | The voice the agent speaks with |
language | string | Language code, e.g. en |
voice_speed | number | Speaking rate multiplier |
temperature | number | How much the agent’s wording varies |
max_call_duration_seconds | int | Hard cap on call length |
silence_hangup_seconds | int | Hang up after this much silence |
record_call | boolean | Whether calls are recorded |
webhook_url | string | Agent-level webhook, or null |
transfer_number | string | Default transfer destination, or null |
fallback_message | string | Said when the agent cannot answer |
post_call_sms_enabled | boolean | Whether an SMS is sent after the call |
post_call_sms_template | string | Template for that SMS, or null |
data_extraction_fields | array | Fields to pull from each call |
is_active | boolean | Always true in this response |
created_at | string | ISO 8601 |
updated_at | string | ISO 8601 |
Results are ordered newest first (
created_at descending).⌘I