User Lookup

Look Up a User

Look up an Academia user by phone number. Use this to confirm the user's identity before making a deposit.

Endpoint: GET /user-lookup?phone={phone_number}

Request

curl -X GET "https://api.academia.ly/api/v1/reseller/user-lookup?phone=0912345678" \
  -H "Authorization: Bearer {token}"

Parameter	Type	Required	Description
phone	string (query)	Yes	The user's phone number

Response

User found (200):

{
  "data": {
    "first_name": "Foulen",
    "status": "active"
  }
}

Field	Type	Description
data.first_name	string	User's first name --- use this to confirm identity with the customer
data.status	string	"active" or "inactive"

TIP

Always confirm the first name with the customer at your terminal before proceeding with a deposit. For example: "Is the account holder named Foulen?"

User not found (404):

{
  "message": "User not found."
}

Errors

Status	Meaning
401	Invalid or expired token
403	IP not whitelisted
404	No user found with this phone number

WARNING

Do not proceed with a deposit if the user lookup returns "status": "inactive". The deposit will be rejected.