GET api/v1/addressbook/contacts?filter.Firstname={filter.Firstname}&filter.Lastname={filter.Lastname}&filter.MobilePhone={filter.MobilePhone}&filter.EmailAddress={filter.EmailAddress}&paging.Page={paging.Page}&paging.NoOfRecords={paging.NoOfRecords}

This method returns a list of all the contacts stored on the customer’s account if no parameters are provided. For each contact it will include their first name, last name, mobile number, email address and the type of authentication the contact has chosen if used with an SMS+ message. This method allows the list to be page for large address books and filtered to reduce the size of the data returned.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
Firstname

Firstname of the person in addressbook

string

None.

Lastname

Lastname of the person in addressbook

string

None.

MobilePhone

Mobile number of the person in addressbook

string

None.

EmailAddress

Email address of the person in addressbook

string

None.

Page

The Page number for the report.

integer

Required

NoOfRecords

The number of records to return per page.

integer

Required

Body Parameters

None.

Response Information

Resource Description

List of contacts that the authenticated user is allowed to view.

ResponseOfAddressBook[]
NameDescriptionTypeAdditional information
Error

Error

None.

ResponseData

ResponseDataOfAddressBook[]

None.

Response Formats

application/json, text/json

Sample:
{
  "Error": {
    "ErrorCode": "sample string 1",
    "ErrorReason": "sample string 2"
  },
  "ResponseData": {
    "Identification": {
      "UserId": "sample string 1"
    },
    "Result": "sample string 1",
    "Detail": [
      {
        "PersonNumber": 1,
        "FirstName": "sample string 2",
        "LastName": "sample string 3",
        "MobilePhone": "sample string 4",
        "EmailAddress": "sample string 5",
        "Password": "sample string 6",
        "LoginType": 7,
        "DateCreated": "2017-09-24T12:13:10.1285133Z",
        "DateModified": "2017-09-24T12:13:10.1285133Z",
        "LastModifiedBy": "sample string 8",
        "VetoValidation": true
      },
      {
        "PersonNumber": 1,
        "FirstName": "sample string 2",
        "LastName": "sample string 3",
        "MobilePhone": "sample string 4",
        "EmailAddress": "sample string 5",
        "Password": "sample string 6",
        "LoginType": 7,
        "DateCreated": "2017-09-24T12:13:10.1285133Z",
        "DateModified": "2017-09-24T12:13:10.1285133Z",
        "LastModifiedBy": "sample string 8",
        "VetoValidation": true
      }
    ]
  }
}

application/xml, text/xml

Sample:
<ResponseOfArrayOfAddressBook xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Error>
    <ErrorCode>sample string 1</ErrorCode>
    <ErrorReason>sample string 2</ErrorReason>
  </Error>
  <ResponseData>
    <Result>sample string 1</Result>
    <Identification>
      <UserId>sample string 1</UserId>
    </Identification>
    <Detail>
      <AddressBook>
        <PersonNumber>1</PersonNumber>
        <FirstName>sample string 2</FirstName>
        <LastName>sample string 3</LastName>
        <MobilePhone>sample string 4</MobilePhone>
        <EmailAddress>sample string 5</EmailAddress>
        <Password>sample string 6</Password>
        <LoginType>7</LoginType>
        <DateCreated>2017-09-24T12:13:10.1285133Z</DateCreated>
        <DateModified>2017-09-24T12:13:10.1285133Z</DateModified>
        <LastModifiedBy>sample string 8</LastModifiedBy>
        <VetoValidation>true</VetoValidation>
      </AddressBook>
      <AddressBook>
        <PersonNumber>1</PersonNumber>
        <FirstName>sample string 2</FirstName>
        <LastName>sample string 3</LastName>
        <MobilePhone>sample string 4</MobilePhone>
        <EmailAddress>sample string 5</EmailAddress>
        <Password>sample string 6</Password>
        <LoginType>7</LoginType>
        <DateCreated>2017-09-24T12:13:10.1285133Z</DateCreated>
        <DateModified>2017-09-24T12:13:10.1285133Z</DateModified>
        <LastModifiedBy>sample string 8</LastModifiedBy>
        <VetoValidation>true</VetoValidation>
      </AddressBook>
    </Detail>
  </ResponseData>
</ResponseOfArrayOfAddressBook>