Phone Lines
Get line webhook delivery
Returns { "delivery": { … } }: the list’s fields plus the last attempt’s durationMs and responseBody, and payload — the exact body that was POSTed and signed, as a JSON string, so you can check your signature code against it. ⚠️ A phone_line.code_received payload carries the activation code, a credential: the response is sent with Cache-Control: private, no-store — do not log it. A delivery of another webhook or workspace, or an unknown id, answers 404 WEBHOOK_DELIVERY_NOT_FOUND.
Permissions: with an OAuth / MCP token, the user must be an Owner or Admin (phone_lines:webhooks) — 403 PERMISSION_DENIED otherwise.
Every /v1/phone-lines endpoint takes a tenant-scoped key only: phone-line webhooks belong to the workspace, not to a WhatsApp number, so a number-scoped key (or a per-number OAuth grant) gets 403 NUMBER_SCOPE_NOT_ALLOWED before any role is looked at. A 403 PERMISSION_DENIED / WORKSPACE_MEMBERSHIP_REQUIRED is sent with Cache-Control: no-store.
These are the phone-line webhooks — a registry separate from /v1/webhooks: they receive only phone_line.* events, and a number webhook never receives one.
Requires a tenant-scoped key.
GET
/
v1
/
phone-lines
/
webhooks
/
{id}
/
deliveries
/
{deliveryId}
Get a webhook delivery
curl --request GET \
--url https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId} \
--header 'x-api-key: <api-key>'import requests
url = "https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}', 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://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <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://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"delivery": {
"id": "cmh1w9c4m0002dl8example5f",
"event": "phone_line.code_received",
"status": "DELIVERED",
"attempts": 1,
"responseStatus": 200,
"lastError": null,
"createdAt": "2026-10-27T14:11:51.000Z",
"deliveredAt": "2026-10-27T14:11:52.000Z",
"durationMs": 184,
"responseBody": "ok",
"payload": "{\"id\":\"cmh1w9c4m0002dl8example5f\",\"event\":\"phone_line.code_received\",\"createdAt\":\"2026-10-27T14:11:51.000Z\",\"data\":{\"lineId\":\"cmg5k2l1n0001pl8example9x\",\"number\":\"551148637200\",\"name\":\"Suporte SP\",\"activationId\":\"cmg5k3a7c0002ac8example4q\",\"code\":\"123456\",\"failureReason\":null,\"audioUrl\":\"https://pilotstatus.com.br/v1/phone-lines/activations/cmg5k3a7c0002ac8example4q/audio\"}}"
}
}The
payload may contain an activation code, which is a credential: whoever has it can register a WhatsApp account on the line. Do not share or log this response. See Phone line webhooks.Authorizations
apiKeyapiKeyId
Your ps_ API key
Path Parameters
The webhook's id (from GET /v1/phone-lines/webhooks or the create response).
The delivery's id (from the deliveries list, or the id your endpoint received).
Response
The delivery in full
Show child attributes
Show child attributes
Was this page helpful?
⌘I
Get a webhook delivery
curl --request GET \
--url https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId} \
--header 'x-api-key: <api-key>'import requests
url = "https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}', 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://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <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://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://pilotstatus.com.br/v1/phone-lines/webhooks/{id}/deliveries/{deliveryId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"delivery": {
"id": "cmh1w9c4m0002dl8example5f",
"event": "phone_line.code_received",
"status": "DELIVERED",
"attempts": 1,
"responseStatus": 200,
"lastError": null,
"createdAt": "2026-10-27T14:11:51.000Z",
"deliveredAt": "2026-10-27T14:11:52.000Z",
"durationMs": 184,
"responseBody": "ok",
"payload": "{\"id\":\"cmh1w9c4m0002dl8example5f\",\"event\":\"phone_line.code_received\",\"createdAt\":\"2026-10-27T14:11:51.000Z\",\"data\":{\"lineId\":\"cmg5k2l1n0001pl8example9x\",\"number\":\"551148637200\",\"name\":\"Suporte SP\",\"activationId\":\"cmg5k3a7c0002ac8example4q\",\"code\":\"123456\",\"failureReason\":null,\"audioUrl\":\"https://pilotstatus.com.br/v1/phone-lines/activations/cmg5k3a7c0002ac8example4q/audio\"}}"
}
}