Text-To-911

Receiving a 911 Text Message from a Caller

Overview

When a caller sends a 911 text message, your HTTP Endpoint receives the data via a POST method from the NGGT service. The POST method sends information via the HTTP header as name/value pairs sent within the body of the HTTP request.

Accessing POST Values

With the programming language of your choice, you access the POST values. For example, in PHP:

$callerPhoneNumber = $_POST['from'];

Response Parameters (complete list upon Registration)

Parameter	Name	Description
Caller Phone Number	from	Country Code + 10 digits (e.g. +14071234567)
Station Id	stid	Unique identifier for your Http Endpoint (URL)
Text	text	Message from Caller (maximum 140 characters, encoded)

Notes

Text-To-911 can only be initiated by the Caller
Please Register for access to the complete Text-To-911 API Documentation
The NGGT Text-To-911 service sends and receives 8-bit Unicode (UTF-8) characters, including letters with diacritical marks (accents)

Sending a 911 Text Message to a Caller Over 911

Overview

When sending a 911 text message to a caller, your HTTP endpoint sends the data via a GET method to the NGGT service endpoint. The GET method sends information via the HTTP URL as name=value pairs in the query string of the HTTP request.

GET Request

With the programming language of your choice, you send request.

{NggtServiceEndpoint}/send.php?auth={AuthorizationCode}&stid={StationId}&body={Message+to+Caller}&tn={CallerPhoneNumber}&fingerprint={fingerprint}&status=2

Query String Parameters (complete list upon Registration)

Parameter	Name	Description
Authorization Code	auth	Unique access key for your HTTP endpoint (URL)
Caller Phone Number	tn	Country Code + 10 digits (e.g. +14071234567)
Station Id	stid	Unique identifier for your HTTP endpoint (URL)
Text	body	Message to Caller (maximum 140 characters, encoded)
Session Status	status	Active Session = 2

Notes

Please Register for access to the complete Text-To-911 API Documentation
The NGGT Text-To-911 service sends and receives 8-bit Unicode (UTF-8) characters, including letters with diacritical marks (accents)

Sending a Request to End a 911 Session

Overview

When you are ready to end the 911 session with a caller, your HTTP endpoint sends the data via a GET method to the NGGT service endpoint. The GET method sends information via the HTTP URL as name=value pairs in the query string of the HTTP request.

GET Request

With the programming language of your choice, you send request.

{NggtServiceEndpoint}/send.php?auth={AuthorizationCode}&stid={StationId}&body={End+Session+Message+to+Caller}&tn={CallerPhoneNumber}&fingerprint={fingerprint}&status=0

Query String Parameters (complete list upon Registration)

Parameter	Name	Description
Authorization Code	auth	Unique access key for your HTTP endpoint (URL)
Caller Phone Number	tn	Country Code + 10 digits (e.g. +14071234567)
Station Id	stid	Unique identifier for your HTTP endpoint (URL)
Text	body	Message from Caller (maximum 140 characters, encoded)
Session Status	status	End Session = 0

Notes

Please Register for access to the complete Text-To-911 API Documentation
The NGGT Text-To-911 service sends and receives 8-bit Unicode (UTF-8) characters, including letters with diacritical marks (accents)

Sending a Request for a Caller Location Update (Rebid)

Overview

When you want to get an update of the caller's location, your HTTP endpoint sends the data via a GET method to the NGGT service endpoint. The GET method sends information via the HTTP URL as name=value pairs in the query string of the HTTP request.

GET Request

With the programming language of your choice, you send request.

{NggtServiceEndpoint}/geo.send.php?auth={AuthorizationCode}&stid={StationId}&tn={CallerPhoneNumber}&fingerprint={fingerprint}

Query String Parameters (complete list upon Registration)

Parameter	Name	Description
Authorization Code	auth	Unique access key for your HTTP endpoint (URL)
Caller Phone Number	tn	Country Code + 10 digits (e.g. +14071234567)
Station Id	stid	Unique identifier for your HTTP endpoint (URL)

Notes

Please Register for access to the complete Text-To-911 API Documentation
The NGGT Text-To-911 service sends and receives 8-bit Unicode (UTF-8) characters, including letters with diacritical marks (accents)