Assign an E911 Address to Your Phone Number

Enables an assignment of a valid E911 address to a specific long code, or toll-free number in a Flowroute account.

NOTE: Only US/Canadian toll-free numbers support emergency services. The API will return an error when attempting to apply an E911 address to a number which does not support this feature. Example: 'Cannot assign an E911 record to a number that does not support emergency services.'

A fee is charged for non-exempt numbers. Click here for more information.

Endpoint

PATCH /numbers/:number_id/relationships/e911s/:e911_id

Path Parameters

  • number_id
    integer REQUIRED

    The Flowroute long code, or toll-free phone number to be associated with the valid E911 address.

  • e911_id
    integer REQUIRED

    A valid E911 record ID to be assigned to a Flowroute long code, or toll-free phone number.

Response Fields

On success, the HTTP status code in the response header is 204 No Content which means that the server successfully processed the request and is not returning any content.


Example Request

PATCH /v2/numbers/12013451234/relationships/e911s/20155 HTTP/1.1
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

                        

Example Request

curl https://api.flowroute.com/v2/numbers/12013451234/relationships/e911s/20155 -X PATCH \
-u accessKey:secretKey 

                        

Example Response

204 NO CONTENT

401 Unauthorized

{
  "errors": [
    {
      "detail": "Authentication failed.",
      "id": "7fc8c70a-ca58-430c-b383-b89df84f8083",
      "status": 401,
      "title": "Unauthorized"
    }
  ]
}
                

403 Forbidden

{
  "errors": [
    {
      "status": 403,
      "detail": "",
      "title": "ActionNotAuthorizedError"
    }
  ]
}
                

422 Invalid Resource

{
  "errors": [
    {
      "detail": "Cannot assign an E911 record to a number that does not support emergency services.",
      "id": "2ee1a30f-f321-46c5-9065-8be93692d44b",
      "status": 422,
      "title": "Invalid Resource"
    }
  ]
}