Admin

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)