Smallest AI

https://docs.smallest.ai
Admin
Smallest AI is a voice AI platform providing speech-to-text (Pulse), text-to-speech (Lightning), and...
Tokens:1,781,226
Snippets:13,813
Trust Score:8.4
Update:1 day ago
Show doc for...
Tokens:
Raw
### Build and run the agent

Source: https://docs.smallest.ai/integrations/agent-framework/ten-framework

Starts the Docker containers, installs the voice-assistant example dependencies, and runs the agent in the background.

```bash
docker compose up -d
docker exec ten_agent_dev bash -c "cd /app/agents/examples/voice-assistant && task install"
docker exec -d ten_agent_dev bash -c "cd /app/agents/examples/voice-assistant && task run"
```

--------------------------------

### Install dependencies

Source: https://docs.smallest.ai/integrations/telephony/plivo

Install the required dependencies for the example code using pip.

```bash
pip install -r requirements.txt
```

--------------------------------

### Quickstart: Create and connect an AtomsAgent

Source: https://docs.smallest.ai/voice-agents/integrate/web-socket-sdk.md

TypeScript example showing how to instantiate AtomsAgent, listen to events, and connect. Microphone capture starts automatically; call agent.disconnect() when done. Do not put a raw API key in a browser; use a short-lived token from the Register Call endpoint.

```typescript
import { AtomsAgent } from "@smallest-ai/agent-sdk";

const agent = new AtomsAgent({
  apiKey:  "sk_...",   // Smallest API key
  agentId: "...",      // Agent ID
});

agent.on("session_started", (e) => {
  console.log("Session started:", e.session_id, e.call_id);
});
agent.on("agent_start_talking", () => console.log("Agent speaking"));
agent.on("agent_stop_talking",  () => console.log("Agent stopped"));
agent.on("error",               (e) => console.error(`[${e.code}] ${e.message}`));

await agent.connect();
// Microphone capture starts automatically. Speak, and the agent replies
// through the default audio output. Call agent.disconnect() when done.
```

--------------------------------

### Download and set up the getting_started example

Source: https://docs.smallest.ai/voice-agents/developer-guide/get-started/quickstart

Downloads the getting_started example folder from the smallest.ai cookbook, extracts it, and installs dependencies. This is for a single-node crew that streams chat completions and greets the caller on join.

```bash
curl -sL https://github.com/smallest-inc/cookbook/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=2 cookbook-main/voice-agents/getting_started
cd getting_started
pip install -r requirements.txt
```

--------------------------------

### Complete .env File Example

Source: https://docs.smallest.ai/models/self-host/docker-setup/tts-deployment/configuration.md

Provides a full environment file example with license key, API server port, TTS port, Redis host and port, GPU device ID, default voice, and voice speed settings.

```bash
LICENSE_KEY=your-license-key-here

API_SERVER_PORT=7100
TTS_PORT=8876

REDIS_HOST=redis
REDIS_PORT=6379

GPU_DEVICE_ID=0

DEFAULT_VOICE=default
VOICE_SPEED=1.0
```

--------------------------------

### Java SDK: Start campaign with Unirest

Source: https://docs.smallest.ai/api-reference/voice-agents/campaigns/start-or-resume.md

Java example using the Unirest HTTP library to send a POST request with a bearer token and get the response as a string.

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.smallest.ai/atoms/v1/campaign/id/start")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Connect to Hydra WebSocket (Python)

Source: https://docs.smallest.ai/models/speech-to-speech/web-socket-connection

Python example using the websockets library to connect to the Hydra speech-to-speech WebSocket. Requires pip install websockets. The connection streams JSON text frames, starting with session.created.

```python
import asyncio, os
import websockets
URL = f"wss://api.smallest.ai/waves/v1/s2s?model=hydra-v1.1&api_key={os.environ['SMALLEST_API_KEY']}"
async def main():
    async with websockets.connect(URL, max_size=None) as ws:
        async for raw in ws:
            print(raw)  # → session.created, then on to session.configure
asyncio.run(main())
```

--------------------------------

### Make setup script executable and run

Source: https://docs.smallest.ai/models/self-host/kubernetes-setup/aws/iam-irsa

Run these commands to make the setup script executable and execute it.

```bash
chmod +x setup-irsa.sh
./setup-irsa.sh
```

--------------------------------

### Get Compliance Status - C# SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

C# example using RestSharp to call the Get Compliance Status API. Sends a GET request with an empty body and executes it.

```csharp
using RestSharp;

var client = new RestClient("https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

--------------------------------

### Complete Setup Example with CrewSession and AtomsCrewApp

Source: https://docs.smallest.ai/voice-agents/developer-guide/get-started/agent-crew-core-concepts/sessions

Full example showing graph building, hooks, and lifecycle management. It initializes nodes, builds a graph (Tracker -> Agent), registers an interrupt hook, and launches the app with AtomsCrewApp.

```python
from smallestai.atoms.crew.session import CrewSession
from smallestai.atoms.crew.server import AtomsCrewApp
async def setup(session: CrewSession):
    # 1. Initialize Nodes
    agent = SalesAgent()
    tracker = StatsTracker()
    
    # 2. Build Graph
    session.add_node(tracker)
    session.add_node(agent)
    session.add_edge(tracker, agent)  # Events go Tracker -> Agent
    
    # 3. Register Hooks
    @session.on_event("system.control.interrupt")
    async def on_interrupt(session, event):
        print("User interrupted the agent!")
    # 4. Launch
    await session.start()
    await session.wait_until_complete()
if __name__ == "__main__":
    app = AtomsCrewApp(setup_handler=setup)
    app.run()
```

--------------------------------

### Get Compliance Status - PHP SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

PHP example using GuzzleHttp to call the Get Compliance Status API. Sends a GET request with an empty body and prints the response body.

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

--------------------------------

### Download and set up the background_agent example

Source: https://docs.smallest.ai/voice-agents/developer-guide/get-started/quickstart

Downloads the background_agent example folder from the smallest.ai cookbook, extracts it, and installs dependencies. This is for a multi-node crew with a support agent and a background sentiment analyzer.

```bash
curl -sL https://github.com/smallest-inc/cookbook/archive/refs/heads/main.tar.gz \
  | tar -xz --strip-components=2 cookbook-main/voice-agents/background_agent
cd background_agent
pip install -r requirements.txt
```

--------------------------------

### Get Compliance Status - Java SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

Java example using Unirest to call the Get Compliance Status API. Sends a GET request with an empty body and returns the response as a string.

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

--------------------------------

### Complete Setup with AtomsCrewApp

Source: https://docs.smallest.ai/voice-agents/developer-guide/get-started/agent-crew-core-concepts/sessions.md

Full example showing graph building, hooks, and lifecycle management. It initializes nodes, builds a graph, registers an interrupt hook, and launches the app. The session.start() validates for cycles and raises ValueError if any are found.

```python
from smallestai.atoms.crew.session import CrewSession
from smallestai.atoms.crew.server import AtomsCrewApp

async def setup(session: CrewSession):
    # 1. Initialize Nodes
    agent = SalesAgent()
    tracker = StatsTracker()
    
    # 2. Build Graph
    session.add_node(tracker)
    session.add_node(agent)
    session.add_edge(tracker, agent)  # Events go Tracker -> Agent
    
    # 3. Register Hooks
    @session.on_event("system.control.interrupt")
    async def on_interrupt(session, event):
        print("User interrupted the agent!")

    # 4. Launch
    await session.start()
    await session.wait_until_complete()

if __name__ == "__main__":
    app = AtomsCrewApp(setup_handler=setup)
    app.run()
```

--------------------------------

### Get Compliance Status - Go SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

Go example using the net/http package to call the Get Compliance Status API. Sends a GET request with an empty body and prints the response status and body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business"

	payload := strings.NewReader("{}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
```

--------------------------------

### Quickstart: Full agent session with WebSocket and audio

Source: https://docs.smallest.ai/voice-agents/integrate/mobile/android-kotlin

A complete agent session class that opens a WebSocket to the Smallest AI API, starts microphone capture, and plays agent audio. Owns a CoroutineScope to ensure the microphone coroutine outlives the OkHttp onOpen callback. Uses a read timeout of 0 for long-lived WebSocket connections.

```kotlin
import kotlinx.coroutines.*
import okhttp3.*
import okio.ByteString
import java.util.concurrent.TimeUnit
class AtomsAgent(
    private val apiKey:  String,
    private val agentId: String,
) {
    private val sampleRate = 24_000
    private val client = OkHttpClient.Builder()
        .readTimeout(0, TimeUnit.MILLISECONDS)  // unlimited for long-lived WS
        .build()
    // Own the scope: the microphone coroutine is launched asynchronously from
    // OkHttp's onOpen callback, so it must outlive any caller stack frame.
    // A short-lived scope (for example, one passed in from lifecycleScope.launch
    // whose lambda returns immediately) would be cancelled before onOpen fires,
    // and the mic coroutine would silently no-op.
    private val scope = CoroutineScope(Dispatchers.Default + SupervisorJob())
    private var webSocket: WebSocket? = null
    private var micJob: Job? = null
    private val player = AudioPlayer(sampleRate)
    fun start() {
        val url = HttpUrl.Builder()
            .scheme("https")  // OkHttp wraps wss:// via https://
            .host("api.smallest.ai")
            .addPathSegments("atoms/v1/agent/connect")
            .addQueryParameter("token",       apiKey)
            .addQueryParameter("agent_id",    agentId)
            .addQueryParameter("mode",        "webcall")
            .addQueryParameter("sample_rate", sampleRate.toString())
            .build()
        val request = Request.Builder().url(url).build()
        webSocket = client.newWebSocket(request, object : WebSocketListener() {
            override fun onOpen(ws: WebSocket, response: Response) {
                micJob = scope.launch { streamMicrophone(ws) }
                player.start()
            }
            override fun onMessage(ws: WebSocket, text: String)    = handleServerEvent(text)
            override fun onMessage(ws: WebSocket, bytes: ByteString) = handleServerEvent(bytes.utf8())
            override fun onClosing(ws: WebSocket, code: Int, reason: String) { stop() }
            override fun onFailure(ws: WebSocket, t: Throwable, r: Response?) { stop() }
        })
    }
    fun stop() {
        micJob?.cancel()
        player.stop()
        webSocket?.close(1000, "client stop")
        webSocket = null
        scope.cancel()
    }
}
```

--------------------------------

### Get Compliance Status - Ruby SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

Ruby example using Net::HTTP to call the Get Compliance Status API. Sets up an HTTPS connection, sends a GET request with an empty body, and prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

--------------------------------

### Setup

Source: https://docs.smallest.ai/integrations/sdks-libraries/vercel-ai-sdk.md

Set up the API key as an environment variable.

```APIDOC
## Setup

Get your API key from [waves.smallest.ai](https://waves.smallest.ai) and set it as an environment variable:

```bash
export SMALLEST_API_KEY="your_key_here"
```
```

--------------------------------

### Python SDK Usage Example

Source: https://docs.smallest.ai/models/self-host/api-reference/authentication.md

Initialize the Smallest client with API URL and license key, then transcribe an audio URL and print the result.

```python
from smallest import Client

client = Client(
    api_url="http://localhost:7100",
    license_key="your-license-key-here"
)

result = client.transcribe_url("https://example.com/audio.wav")
print(result.text)
```

--------------------------------

### Get Compliance Status - Python SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

Python example using the requests library to call the Get Compliance Status API. Sends a GET request with query parameters and an empty JSON body, using an Authorization bearer token.

```python
import requests

url = "https://api.smallest.ai/atoms/v1/compliance/status"

querystring = {"countryIso":"IN","numberType":"local","userType":"business"}

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.get(url, json=payload, headers=headers, params=querystring)

print(response.json())
```

--------------------------------

### Create project and install dependencies

Source: https://docs.smallest.ai/integrations/telephony/bandwidth.md

Creates a project directory, sets up a Python virtual environment, and installs FastAPI, Uvicorn, websockets, OpenAI, and python-dotenv.

```bash
mkdir bandwidth-smallest && cd bandwidth-smallest
python3 -m venv .venv && source .venv/bin/activate
pip install fastapi uvicorn "websockets>=13" openai python-dotenv
```

--------------------------------

### Get Credits Ledger Response Example

Source: https://docs.smallest.ai/api-reference/voice-agents/billing/get-ledger.md

Example JSON response from the Get Credits Ledger endpoint. Shows a successful response with transaction details, pagination info, and period summary.

```json
{
  "success": true,
  "data": {
    "transactions": [
      {
        "id": "txn_9f3a2c1b4e8d7f6a",
        "transactionType": "USAGE_DEDUCTION",
        "amount": 0.0425,
        "balanceAfter": 142.875,
        "createdAt": "2026-07-15T09:30:00Z",
        "featureId": "voice_ai_standard",
        "referenceId": "inv_2026071500123",
        "description": "Voice AI usage deduction for 85 minutes of call processing",
        "callId": "call_4d7e2f1a9b3c8e05",
        "agentId": "agent_b2c3d4e5f6a7b8c9",
        "requestId": "req_1a2b3c4d5e6f7890"
      }
    ],
    "total": 47,
    "hasMore": true,
    "summary": {
      "totalCreditsConsumed": 58.32,
      "totalCreditsAdded": 200
    },
    "period": {
      "from": "2026-07-01T00:00:00Z",
      "to": "2026-07-28T00:00:00Z"
    }
  }
}
```

--------------------------------

### C# SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

C# example using RestSharp to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and executes the request.

```csharp
using RestSharp;

var client = new RestClient("https://api.smallest.ai/atoms/v1/analytics/phone-number-trends");
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

--------------------------------

### Go SDK: Start campaign with net/http

Source: https://docs.smallest.ai/api-reference/voice-agents/campaigns/start-or-resume.md

Go example using the standard net/http package to send a POST request with a bearer token and print the response status and body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/atoms/v1/campaign/id/start"

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

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

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
```

--------------------------------

### Ruby SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

Ruby example using net/http to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and prints the response.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.smallest.ai/atoms/v1/analytics/phone-number-trends")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{}"

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

--------------------------------

### Deploy a voice agent example

Source: https://docs.smallest.ai/voice-agents/developer-guide/examples/examples

Commands to log in to Smallest AI, link an agent, deploy with an entry point, and make the build live.

```bash
# Login to Smallest AI
smallestai auth login
# Link to your agent
smallestai agent-crew init
# Deploy
smallestai agent-crew deploy --entry-point app.py
# Make live
smallestai agent-crew builds
```

--------------------------------

### Go SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

Go example using net/http to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and prints the response.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/atoms/v1/analytics/phone-number-trends"

	payload := strings.NewReader("{}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
```

--------------------------------

### Run a voice agent example locally

Source: https://docs.smallest.ai/voice-agents/developer-guide/examples/examples

Commands to clone the cookbook, install dependencies, set environment variables, run the app, and test with the CLI. Requires an OpenAI API key.

```bash
# Clone the cookbook
git clone https://github.com/smallest-inc/cookbook
cd cookbook/voice-agents/<example>
# Install dependencies
pip install -e .
# Set environment variables
export OPENAI_API_KEY="your-key"
# Run locally
python app.py
# Test with CLI (in another terminal)
smallestai agent-crew chat
```

--------------------------------

### Get Compliance Status - JavaScript SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/compliance/get-compliance-status.md

JavaScript example using the fetch API to call the Get Compliance Status endpoint. Uses async/await and logs the response data or error.

```javascript
const url = 'https://api.smallest.ai/atoms/v1/compliance/status?countryIso=IN&numberType=local&userType=business';
const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

--------------------------------

### Go SDK example for getting a time-limited recording download URL

Source: https://docs.smallest.ai/api-reference/voice-agents/conversations/get-a-time-limited-recording-download-url-legacy.md

Uses the net/http package to send a GET request. The response body is read and printed.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/atoms/v1/conversation/CALL-1781127346211-e765f7/recording/download-url"

	payload := strings.NewReader("{}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(res)
	fmt.Println(string(body))

}
```

--------------------------------

### Quickstart: Create and connect an AtomsAgent

Source: https://docs.smallest.ai/voice-agents/integrate/web-socket-sdk

Creates an AtomsAgent with your API key and agent ID, registers event handlers for session lifecycle, and connects. Microphone capture starts automatically; call agent.disconnect() when done. Do not put a raw API key in a browser; use a short-lived token from POST /conversation/register-call instead.

```javascript
import { AtomsAgent } from "@smallest-ai/agent-sdk";
const agent = new AtomsAgent({
  apiKey:  "sk_...",   // Smallest API key
  agentId: "...",      // Agent ID
});
agent.on("session_started", (e) => {
  console.log("Session started:", e.session_id, e.call_id);
});
agent.on("agent_start_talking", () => console.log("Agent speaking"));
agent.on("agent_stop_talking",  () => console.log("Agent stopped"));
agent.on("error",               (e) => console.error(`[${e.code}] ${e.message}`));
await agent.connect();
// Microphone capture starts automatically. Speak, and the agent replies
// through the default audio output. Call agent.disconnect() when done.
```

--------------------------------

### Swift SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

Swift example using URLSession to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and prints the response or error.

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.smallest.ai/atoms/v1/analytics/phone-number-trends")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

--------------------------------

### JavaScript SDK Usage Example

Source: https://docs.smallest.ai/models/self-host/api-reference/authentication.md

Initialize the SmallestClient with API URL and license key, then transcribe an audio URL and log the result.

```javascript
import { SmallestClient } from '@smallest/client';

const client = new SmallestClient({
  apiUrl: 'http://localhost:7100',
  licenseKey: 'your-license-key-here'
});

const result = await client.transcribeUrl('https://example.com/audio.wav');
console.log(result.text);
```

--------------------------------

### PHP SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

PHP example using Guzzle to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and echoes the response body.

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://api.smallest.ai/atoms/v1/analytics/phone-number-trends', [
  'body' => '{}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

--------------------------------

### Java SDK Example

Source: https://docs.smallest.ai/api-reference/voice-agents/analytics/get-phone-number-trends.md

Java example using Unirest to call the Get Phone Number Trends API. Sends a GET request with an empty JSON body and returns the response as a string.

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://api.smallest.ai/atoms/v1/analytics/phone-number-trends")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();
```

--------------------------------

### Go SDK Example for Audience Members Search

Source: https://docs.smallest.ai/api-reference/voice-agents/audience/search-audience-members.md

Uses net/http to create a GET request with an Authorization header, sends it, and prints the response status and body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smallest.ai/atoms/v1/audience/60d0fe4f5311236168a109ca/members/search"

	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(res)
	fmt.Println(string(body))

}
```

--------------------------------

### Start Local Agent Server with python server.py

Source: https://docs.smallest.ai/voice-agents/developer-guide/get-started/quickstart

Run the entry point to start a local WebSocket server on localhost:8080 that mimics the production environment.

```bash
python server.py
```
Tokens:
Raw