contacts

Suggest contacts

Discoverable tenant accounts the caller hasn't added yet — the "people you may want to add" feed. Requires: same tenant, is_discoverable=true, active=true, a VERIFIED kyc or kyb session, and excludes the caller and anyone already linked as a contact. Returns an empty page (not an error) when the tenant has discovery turned off tenant-wide.

get/contacts/suggestions

Request

  • Base URL: https://api.instruxi.dev/api/v1/enforcer
  • URL: https://api.instruxi.dev/api/v1/enforcer/contacts/suggestions
  • Auth: one of:
    • API key in header Authorization
    • API key in header X-API-Key

Query parameters

qstring

free-text search (username/email/first/last/wallet/phone)

first_namestring

filter by first name (partial)

last_namestring

filter by last name (partial)

usernamestring

filter by username (partial)

emailstring

filter by email (partial)

phonestring

filter by phone (partial)

wallet_addressstring

filter by wallet address (exact)

user_idstring uuid

filter by account id (exact)

require_verifiedstring

comma list: email,phone

exclude_account_idsstring

comma list of account ids to also suppress

sort'name' | 'name_desc' | 'recent' | 'oldest' | 'active'

sort order

limitinteger

page size

offsetinteger

page offset

Response

OK

limitinteger
offsetinteger
successboolean
totalinteger

Example response

{
  "success": true
}

Changes

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