List suggested teammate contacts from the caller's own sharing history.

GET

/v1/contacts/suggested

const url = 'https://api.share2.us/v1/contacts/suggested';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.share2.us/v1/contacts/suggested \
  --header 'Authorization: Bearer <token>'

Returns recent recipients the caller has already shared with, deduped by email and tagged with registered/device status. This is not a directory search and only uses the caller’s own interaction history.

Authorizations

Responses

200

Suggested teammate contacts.

application/json

object

suggestions

required

Array<object>

object

email

required

string format: email

registered

required

Whether the email belongs to an active Share2Us user.

boolean

has_device

required

Whether the registered user currently has at least one active key-registered device.

boolean

last_used_at

required

string format: date-time

source

required

string

Allowed values: teammate email_share

Example

{
  "suggestions": [
    {
      "source": "teammate"
    }
  ]
}

default

Standard error envelope.

application/json

object

error

required

object

code

required

string

message

required

string

request_id

required

string

Example

{
  "error": {
    "code": "quota_exceeded"
  }
}