Skip to main content

Users

This object represents an end-user within an event organization. Users can be attendees, vendors, performers, staff, etc.

Retrieve Current User

Returns the user object for the currently authenticated user.

Authentication

On Behalf Of (OBO) with pii:basic scope. Other permissions are required to access additional information, such as PII and order history.

Response

substring
The ID of the user, represented as a string.
bornAtstring
The date the user was born, in ISO 8601 format.
firstNamestring
The user's legal first name, as it appears on their ID.
idnumber
The ID of the user.
lastNamestring
The user's legal last name, as it appears on their ID.
newsletterboolean
Whether the user has opted in to the newsletter.
preferredNamestring (optional)
nullable
An optional preferred name for the user. This will be displayed first on the user's profile.
usernamestring
The user's username.
emailVerifiedboolean
Returns true if the user has verified their email.
identityVerifiedboolean
Returns true if the user has verified their identity.
isVolunteerboolean
Returns true if the user is an assigned volunteer.
permissionsarray of string
The permissions granted to the user.
profilePictureUrlstring
Publicly accessible URL to the user's profile picture.
isDepartmentLeadboolean
Returns true if the user is assigned as the lead of a department.
Scope Restricted Attributes
lockaddressCitystring
City, town, or village of the user's address.
Required Scope(s): pii:address
lockaddressCountrystring
Two-letter ISO 3166-1 alpha-2 country code.
Required Scope(s): pii:address
lockaddressLine1string
First line of the user's address. (e.g. 1234 Main St)
Required Scope(s): pii:address
lockaddressLine2string (optional)
nullable
Optional second line of the user's address. (e.g. Suite 100, Apt 2B)
Required Scope(s): pii:address
lockaddressStatestring
State or province of the user's address.
Required Scope(s): pii:address
lockaddressZipcodestring
ZIP or postal code of the user's address.
Required Scope(s): pii:address
lockemailstring
The user's email address.
Required Scope(s): pii:email
lockphonestring
Phone number in international format. (e.g. +15555555555)
Required Scope(s): pii:phone
GET /api/users/:idcURL
curl https://reg.cces.dev/api/users/current \
-H "Authorization: Bearer <token>"
Responseapplication/json
{
"sub": "1234",
"addressCity": "New York",
"addressCountry": "US",
"addressLine1": "123 Main St",
"addressLine2": "Suite 100",
"addressState": "NY",
"addressZipcode": "10001",
"bornAt": "1990-01-01T00:00:00.000Z",
"email": "[email protected]",
"firstName": "John",
"id": 1234,
"lastName": "Doe",
"newsletter": true,
"phone": "+15555555555",
"preferredName": "Jonathan",
"username": "aperson",
"emailVerified": true,
"identityVerified": true,
"isVolunteer": true,
"permissions": [],
"profilePictureUrl": "https://www.gravatar.com/avatar/example",
"isDepartmentLead": false
}