Register an E911 address for a number

post

https://api.emaktalk.com/api/v1/e911_registrations/{number}

Registers the emergency address for the number in caller_id. The {number} in the path is ignored, so the body alone decides which number is registered — check the two agree before sending. This is the address emergency dispatchers are given, so verify it first. Behavior matches POST /api/v1/e911_registrations: 201 for a new registration, 200 when an existing record is returned, reactivated or resynchronized, and 409 when an active or pending registration already exists. The stored record and the provider record are written separately, so a saved registration can still report a pending or failed provider status.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

number

string

required

Required by the route but ignored. caller_id in the body decides which number is registered.

Body Params

caller_id

string

required

The number to register, as +1 followed by ten digits. It must exist as a destination on your account, and it is used instead of the number in the path.

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 Canadian street address emergency services will be given. Validated in full 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. 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.

address.postal_code

string

required

Canadian postal code.

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. The reported provider status need not be active.

400The account context, JSON body, caller ID, 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, or your key has no account context.