Register an E911 address

post

https://api.emaktalk.com/api/v1/e911_registrations

Registers the physical address emergency services are given when someone calls 911 from caller_id. Verify the address before sending it — this is the address dispatchers use to find the caller. The number must be a +1 number already on your account. When a registration already exists, the response is 200 and describes the existing, reactivated or resynchronized record instead of creating a new one, and an already active or pending registration for the same number is refused with 409. Addresses are Canadian: province and postal code are validated against Canadian formats, and the stored record and the emergency-services provider are updated in separate steps, so a 201 can still report a pending or failed provider status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

caller_id

string

required

The number to register, as +1 followed by ten digits. It must already exist as a destination on your account.

tenant_id

string

Optional account identifier. When sent, it must match your own account.

domain_name

string

Optional account domain name. When sent, it must resolve to your own account.

address

object

required

The street address emergency services will be given. Every field below is validated before anything is saved.

address.name

string

required

Required. Name shown with the address, up to 100 characters, from a restricted character set.

address.street_number

string

required

Street number: digits, optionally followed by a single letter.

address.street_name

string

required

Street name. Must not be empty, and uses a restricted character set.

address.suite

string | null

Suite or unit, up to 20 characters after trimming. Defaults to none.

address.city

string

required

City name. Letters, spaces, apostrophes and hyphens only.

address.province

string

required

Canadian province or territory, as a code or an accepted full name. Stored uppercased.

address.postal_code

string

required

Canadian postal code. Stored uppercased with normalized spacing.

address.language

string

Language for the emergency-services record: E or F, case-insensitive. Defaults to E.

Responses

401

Missing or invalid API key.

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A registration already existed and was returned, reactivated or resynchronized.

201A new registration was created. Check the returned status — the provider side can still be pending or failed.

400The account context, JSON body, number, address, or the number's membership on your account was invalid.

403The number is already registered to another account.

409This number already has an active or pending registration.

500The registration could not be saved.