List all lines

GET

https://saperly.com/api/v1/lines

GET

/api/v1/lines

1 const url = 'https://saperly.com/api/v1/lines';
2 const options = {
3   method: 'GET',
4   headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5   body: '{}'
6 };
7 
8 try {
9   const response = await fetch(url, options);
10   const data = await response.json();
11   console.log(data);
12 } catch (error) {
13   console.error(error);
14 }

1 {
2   "lines": [
3     {
4       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5       "phone_number": "+14155552671",
6       "display_name": "Support Line West Coast",
7       "name": "West Coast Support",
8       "mode": "audio",
9       "audio_handler_url": "wss://audio-handler.saperly.com/lines/3fa85f64-5717-4562-b3fc-2c963f66afa6",
10       "webhook_url": "https://hooks.saperly.com/line-events",
11       "status_callback_url": "https://callbacks.saperly.com/status-updates",
12       "compliance_enabled": true,
13       "system_prompt": "Welcome to Saperly AI support. How can I assist you today?",
14       "begin_message": "Hello! This is your AI assistant speaking.",
15       "voice": "elevenlabs-voice-1234abcd",
16       "context_limit": 20,
17       "recording_enabled": true,
18       "status": "active",
19       "environment": "live",
20       "created_at": "2024-01-15T09:30:00Z"
21     }
22   ]
23 }

Returns all active (non-released) lines for the authenticated user, filtered by API key environment.

Authentication

AuthorizationBearer

Send as Authorization: Bearer <your-key>. Obtain keys from the portal — prefix sk_live_ for production, sk_test_ for sandbox.

Response

List of lines

lineslist of objects

Errors

401

Unauthorized Error