GET
/
partner
/
users
/
:id
curl --request GET \
  --url https://api.thanx.com/partner/users/:id \
  --header 'Authorization: Bearer <token>'
{
  "user": {
    "id": "wroeiu2304hfwf",
    "email": "john.smith@example.com",
    "phone": "+14158672345",
    "first_name": "Jane",
    "last_name": "Smith",
    "birth_date": {
      "year": 1987,
      "month": 8,
      "day": 14
    },
    "zip_code": "12345",
    "updated_at": "2025-02-01T19:00:00Z",
    "loyalty": {
      "tier": "silver",
      "points_balance": 120.50,
      "user_joined_at": "2023-12-01T19:00:00Z"
    },
    "communication_settings": {
      "marketing_general_email": true
    }
  }
}

Scope required: users.read

The user’s phone number is not gathered by Thanx with the permission to use it for marketing.

Parameters

id
string
required

User ID

merchant_id
string
required

Merchant ID

Response

id
string

The user's identifier

email
string

The user's email

phone
string

The user's phone number, in E.164 format (eg. +14157582345)

first_name
string

The user's first name

last_name
string

The user's last name

birth_date
hash

The user's birthday information

zip_code
string

The user's zip code

updated_at
datetime

Datetime the user record was last updated.

loyalty
hash
communication_settings
hash
{
  "user": {
    "id": "wroeiu2304hfwf",
    "email": "john.smith@example.com",
    "phone": "+14158672345",
    "first_name": "Jane",
    "last_name": "Smith",
    "birth_date": {
      "year": 1987,
      "month": 8,
      "day": 14
    },
    "zip_code": "12345",
    "updated_at": "2025-02-01T19:00:00Z",
    "loyalty": {
      "tier": "silver",
      "points_balance": 120.50,
      "user_joined_at": "2023-12-01T19:00:00Z"
    },
    "communication_settings": {
      "marketing_general_email": true
    }
  }
}