Table of Contents

Interface IEmergencyClient

Namespace
Vonage.Voice.Emergency
Assembly
Vonage.dll

Exposes Emergency Calling API features for managing emergency addresses and assigning emergency-capable numbers.

public interface IEmergencyClient

Methods

AssignNumberAsync(Result<AssignNumberRequest>)

Assigns an emergency address to a phone number, enabling it for emergency calling.

Task<Result<EmergencyNumberResponse>> AssignNumberAsync(Result<AssignNumberRequest> request)

Parameters

request Result<AssignNumberRequest>

The request containing the country, number, and address ID to assign.

Returns

Task<Result<EmergencyNumberResponse>>

A EmergencyNumberResponse confirming the assignment, or Failure if the request is invalid.

Examples

var request = AssignNumberRequest.Build()
    .WithNumber("14155550100")
    .WithAddressId(Guid.Parse("8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9"))
    .WithContactName("John Doe")
    .Create();
var result = await client.AssignNumberAsync(request);
See Also

CreateAddressAsync(Result<CreateAddressRequest>)

Creates a new emergency address on your account.

Task<Result<Address>> CreateAddressAsync(Result<CreateAddressRequest> request)

Parameters

request Result<CreateAddressRequest>

The request containing the address details (street, city, state, country, postal code).

Returns

Task<Result<Address>>

The created Address with its assigned ID, or Failure if validation fails.

Examples

var request = CreateAddressRequest.Build()
    .WithName("Office HQ")
    .WithFirstAddressLine("123 Main Street")
    .WithCity("San Francisco")
    .WithRegion("CA")
    .WithPostalCode("94105")
    .WithCountry("US")
    .Create();
var result = await client.CreateAddressAsync(request);
See Also

DeleteAddressAsync(Result<DeleteAddressRequest>)

Deletes an emergency address from your account.

Task<Result<Unit>> DeleteAddressAsync(Result<DeleteAddressRequest> request)

Parameters

request Result<DeleteAddressRequest>

The request containing the address ID to delete.

Returns

Task<Result<Unit>>

Success if the address was deleted, or Failure if the address was not found.

Examples

var request = DeleteAddressRequest.Build()
    .WithId(Guid.Parse("8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9"))
    .Create();
var result = await client.DeleteAddressAsync(request);
See Also

GetAddressAsync(Result<GetAddressRequest>)

Retrieves the details of a specific emergency address by its ID.

Task<Result<Address>> GetAddressAsync(Result<GetAddressRequest> request)

Parameters

request Result<GetAddressRequest>

The request containing the address ID to retrieve.

Returns

Task<Result<Address>>

The Address if found, or Failure if the address does not exist.

Examples

var request = GetAddressRequest.Build()
    .WithId(Guid.Parse("8f35a1a7-eb2f-4552-8fdf-fffdaee41bc9"))
    .Create();
var result = await client.GetAddressAsync(request);
See Also

GetAddressesAsync(Result<GetAddressesRequest>)

Retrieves all emergency addresses configured on your account.

Task<Result<GetAddressesResponse>> GetAddressesAsync(Result<GetAddressesRequest> request)

Parameters

request Result<GetAddressesRequest>

The request for the address list.

Returns

Task<Result<GetAddressesResponse>>

A GetAddressesResponse containing all configured addresses, or Failure on error.

Examples

var request = GetAddressesRequest.Build()
    .WithPage(1)
    .WithPageSize(50)
    .Create();
var result = await client.GetAddressesAsync(request);
See Also

GetNumberAsync(Result<GetNumberRequest>)

Retrieves the details of an emergency number, including its assigned address.

Task<Result<EmergencyNumberResponse>> GetNumberAsync(Result<GetNumberRequest> request)

Parameters

request Result<GetNumberRequest>

The request containing the country and number to look up.

Returns

Task<Result<EmergencyNumberResponse>>

A EmergencyNumberResponse with the number details, or Failure if the number is not found.

Examples

var result = await client.GetNumberAsync(GetNumberRequest.Parse("14155550100"));
See Also