List Account E911 Addresses

Returns a list of E911 addresses within the US and Canada on your account. You can apply search filters using any of the available query parameters.

Endpoint

GET /e911s

Query Parameters

  • limit
    integer

    Limits the number of E911 records to retrieve by your specified value. A maximum of 2000 items can be retrieved with 10 being the default value if not specified.

  • offset
    integer

    Offsets the list of E911 records by your specified value. For example, if you have 4 E911 records and you entered 1 as your offset value, then only 3 of your E911 records will be displayed in the response.

  • label
    string

    Filters by and displays E911 addresses matching a partial case-insensitive search of the label. For example, Office for 'My Seattle Office' or 'Monroe Office Location'.

  • street_name
    string

    Filters by and displays E911 addresses matching a partial case-insensitive search of the street name. For example, Main for Main Street or Central%20Avenue for Central Avenue.

  • city
    string

    Filters by and displays E911 addresses matching a partial case-insensitive search of the city. For example, iversi for Riverside and Culver%20City for Culver City.

  • state
    string

    Filters by and displays E911 addresses in the specified case-insensitive 2-letter abbreviated US state or Canadian province or territory. For example, WA for Washington State, USA and AB for Alberta, Canada.

Response Fields

On success, the HTTP status code in the response header is 200 OK and the response body contains an array of e911 objects in JSON format. On error, the header status code is an error code and the response body contains an array of error objects.

Example Request

GET /v2/e911s?limit=2 HTTP/1.1
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json

Example Request

curl -X GET https://api.flowroute.com/v2/e911s?limit=2 -u accessKey:secretKey

Example Request

This assumes that you have the Python API Wrapper installed and set up. The following example is from cnam_demo.py. Please make sure to use neutral (vertical) quotes in your request. Smart quotes are known to cause errors. 

print("--List E911 Records")
limit = 2
offset = None
result = e911s_controller.list_e911s(limit, offset)
pprint.pprint(result)

Example Responses

200 OK

{
'data': [
    {
        'attributes': {
            'address_type': 'Lobby',
            'address_type_number': '12',
            'city': 'Seattle',
            'country': 'USA',
            'first_name': 'Maria',
            'label': 'Example E911',
            'last_name': 'Bermudez',
            'state': 'WA',
            'street_name': '20th Ave SW',
            'street_number': '7742',
            'zip': '98106'
        },
        'id': '20930',
        'links': {
            'self': 'https://api.flowroute.com/v2/e911s/20930'},
            'type': 'e911'
    },
    {
        'attributes': {
            'address_type': 'Apartment',
              'address_type_number': '12',
              'city': 'Seattle',
              'country': 'US',
              'first_name': 'Something',
              'label': '5th E911',
              'last_name': 'Someone',
              'state': 'WA',
              'street_name': 'Main St',
              'street_number': '645',
              'zip': '98104'
        },
        'id': '20707',
        'links': {
            'self': 'https://api.flowroute.com/v2/e911s/20707'
        },
        'type': 'e911'}
    ],

    'links': {
        'next': 'https://api.flowroute.com/v2/e911s?limit=2&offset=2',
        'self': 'https://api.flowroute.com/v2/e911s?limit=2&offset=0'
    }
}

422 UNPROCESSABLE ENTITY

{
  "errors": [
    {
      "detail": {
        "limit": [
          "Not a valid integer."
        ]
      },
      "id": "07f2df99-f31d-45ce-93d3-1512f81ab27d",
      "status": 422
    }
  ]
}