Set the emergency (E911) address for a number
curl --request PUT \
--url https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"caller_name": "Jane Operator",
"street_line_1": "1600 Amphitheatre Pkwy",
"street_line_2": "Suite 200",
"city": "Mountain View",
"region": "CA",
"postal_code": "94043",
"country": "US"
}
'import requests
url = "https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address"
payload = {
"caller_name": "Jane Operator",
"street_line_1": "1600 Amphitheatre Pkwy",
"street_line_2": "Suite 200",
"city": "Mountain View",
"region": "CA",
"postal_code": "94043",
"country": "US"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
caller_name: 'Jane Operator',
street_line_1: '1600 Amphitheatre Pkwy',
street_line_2: 'Suite 200',
city: 'Mountain View',
region: 'CA',
postal_code: '94043',
country: 'US'
})
};
fetch('https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address', 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.orbit.devotel.io/api/v1/numbers/{id}/emergency-address",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'caller_name' => 'Jane Operator',
'street_line_1' => '1600 Amphitheatre Pkwy',
'street_line_2' => 'Suite 200',
'city' => 'Mountain View',
'region' => 'CA',
'postal_code' => '94043',
'country' => 'US'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address"
payload := strings.NewReader("{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}")
req, _ := http.NewRequest("PUT", 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(string(body))
}HttpResponse<String> response = Unirest.put("https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "<string>",
"address": {
"caller_name": "<string>",
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"registered_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"validation_status": "registered",
"validated_at": "2023-11-07T05:31:56Z",
"validation_issues": [
"<string>"
]
}
},
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docs_url": "<string>"
}
}Numbers
Set the emergency (E911) address for a number
Register or replace the E911 dispatchable civic address on a number so an emergency call from it can be routed to the correct PSAP. Saving resets the address to an unverified state, so call the verify endpoint afterwards to run the local dispatch-readiness check.
PUT
/
api
/
v1
/
numbers
/
{id}
/
emergency-address
Set the emergency (E911) address for a number
curl --request PUT \
--url https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"caller_name": "Jane Operator",
"street_line_1": "1600 Amphitheatre Pkwy",
"street_line_2": "Suite 200",
"city": "Mountain View",
"region": "CA",
"postal_code": "94043",
"country": "US"
}
'import requests
url = "https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address"
payload = {
"caller_name": "Jane Operator",
"street_line_1": "1600 Amphitheatre Pkwy",
"street_line_2": "Suite 200",
"city": "Mountain View",
"region": "CA",
"postal_code": "94043",
"country": "US"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
caller_name: 'Jane Operator',
street_line_1: '1600 Amphitheatre Pkwy',
street_line_2: 'Suite 200',
city: 'Mountain View',
region: 'CA',
postal_code: '94043',
country: 'US'
})
};
fetch('https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address', 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.orbit.devotel.io/api/v1/numbers/{id}/emergency-address",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'caller_name' => 'Jane Operator',
'street_line_1' => '1600 Amphitheatre Pkwy',
'street_line_2' => 'Suite 200',
'city' => 'Mountain View',
'region' => 'CA',
'postal_code' => '94043',
'country' => 'US'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address"
payload := strings.NewReader("{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}")
req, _ := http.NewRequest("PUT", 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(string(body))
}HttpResponse<String> response = Unirest.put("https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.orbit.devotel.io/api/v1/numbers/{id}/emergency-address")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"caller_name\": \"Jane Operator\",\n \"street_line_1\": \"1600 Amphitheatre Pkwy\",\n \"street_line_2\": \"Suite 200\",\n \"city\": \"Mountain View\",\n \"region\": \"CA\",\n \"postal_code\": \"94043\",\n \"country\": \"US\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "<string>",
"address": {
"caller_name": "<string>",
"street_line_1": "<string>",
"street_line_2": "<string>",
"city": "<string>",
"region": "<string>",
"postal_code": "<string>",
"country": "<string>",
"registered_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"validation_status": "registered",
"validated_at": "2023-11-07T05:31:56Z",
"validation_issues": [
"<string>"
]
}
},
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docs_url": "<string>"
}
}Authorizations
BearerApiKey
Dashboard JWT token from Clerk
Path Parameters
Body
application/json
Operator-supplied E911 dispatchable civic address for a number. All fields are required except street_line_2; country is an ISO-3166 alpha-2 code.
Name of the person / entity at the dispatchable location.
House number and street.
State / province / region.
ISO-3166 alpha-2 country code.
Apartment / suite / floor (optional).
⌘I