Address Book

Get Address

Retrieves detailed information on a specific address record stored in the system's address book. With this endpoint, you can query for an address using a unique identifier and get the relevant details associated with it.

get/v4/addresses/{addressId}

Path parameters

addressIdstring required

A unique identifier for each address record assigned by the system (ID) or by you (alias). This information ensures that each address is distinctly referenced and managed within the system.

Response

Returns the details of a address book.

AddressIdstring nullable

A unique identifier for each address record. This information ensures that each address can be distinctly referenced and managed within the system.

ContactNamestring nullable

The name of the primary contact associated with the address. This field is essential for identification and communication purposes.

CompanyNamestring nullable

The name of the company linked to the address. This field provides context for the address, especially in business-related queries.

ContactEmailstring email nullable

The email address of the primary contact for the address. This is used for correspondence and can facilitate communication directly related to the address.

ContactPhonestring tel nullable

The phone number of the primary contact associated with the address. This field is crucial for any immediate communication needs.

Line1string required

The first line of the address, typically containing the primary address information such as house number and street name.

Line2string nullable

An optional second line for the address, often used for additional details like apartment numbers or suite designations.

Line3string nullable

A third optional line in the address to include any further address specifications, allowing for more detailed address information if necessary.

Townstring required

The town or city, indicating the specific locality where the address is located.

Postcodestring nullable

The postal or ZIP code corresponding to the address, used to identify specific geographic areas.

Countystring nullable

The county, state, or province in which the address is located, providing additional geographical context for the address.

CountryCodestring required

An abbreviation representing the country of the address, following the ISO 3166-1 alpha-2 standard, for example, "GB" for the United Kingdom.

What3Wordsstring nullable

A three-word location identifier provided by the What3words service, offering a precise way to define addresses using a unique combination of three words, for example, the front door of 10 Downing Street in London is identified by slurs.this.shark.

LastUpdatedDateUtcstring date-time

A timestamp in Coordinated Universal Time (UTC) indicating when the address record was last updated.This helps users understand the recency of the address information.

LastUpdatedBystring nullable

The identifier of the user or system that last modified the address details, ensuring accountability and traceability for updates.

Example response

{
  "AddressId": "John Brown Default",
  "ContactName": "Jane Doe",
  "CompanyName": "My Company Ltd.",
  "ContactEmail": "jane@example.com",
  "Line1": "10 Sky Lane",
  "CountryCode": "GB",
  "What3Words": "brick.space.employ",
  "LastUpdatedDateUtc": "2022-02-06T16:13:24.010Z"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.