Search contact by Email, Mobile, Name

Overview

Any active contact within an Airship account can searched for, and returned via the REST API.

This allows third parties to identify contact details based on a key identifier, if multiple contacts exist against a query (i.e. Name = John Smith), then an array of contacts will be returned in the response.

All queries by Email or Mobile will only return a single result, as they are unique in an account.

Example Request

GET

https://api.airship.co.uk/v1/contacts

Configuration

Headers

Field	Notes
Authentication (bearer token)	The authentication token is linked to the account that you are searching bookings in. If you are unsure of what your Authentication token is, ask our support team to confirm.

Body

Field	Notes
account_id	The account ID represents the account that you are searching bookings in. If you are unsure of what your account ID is, ask our support team to confirm.
email	Email address of contact you are searching for
mobile_number	Mobile number of contact you are searching for
name (first_name / last_name)	First / last name of contact you are searching for

Basic payload example

Email search

Contacts can be searched for by email address, there is some basic regex validation on the email to ensure it is in a valid format.

Request

{
    "account_id": 3,
    "email": "[e-mail]"
}

200 Response

422 Response

Mobile search

Contacts can be searched for by Mobile number. All mobile numbers are stored in Airship with the country code (447....), and the API will automatically add this when you pass in a value.

Request

{
    "account_id": 3,
    "mobile_number": "447810000001"
}

200 Response

422 Response

Name search

A contact can be searched for by;

• First name

• Surname

If either of these are left blank (i.e. just John searched for), an array of contacts matching that will be returned.

Request

{
    "account_id": 3,
    "name": {
        "first_name": "John",
        "last_name": "Smith"
    }
}

200 Response

422 Response