GET account/get | ExpoPlatform Helpdesk

GET `/api/v2/account/get`

Returns the full profile of a single participant registered for a given event. The account can be looked up by internal ID, External ID, or email address.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/account/get

Query Parameters

Parameter	Type	Required	Accepted Values / Format	Description
`event_id`	integer	Yes	Valid event ID	The ID of the event the participant is registered for
`filter`	string	Yes	`id`, `external_id`, `email`	The field to search by
`value`	string	Yes	When `filter=email`: valid email address. When `filter=id`: integer. Otherwise: any string	The value to search for

Response

Success Response (HTTP 200)

JSON

{
  "code": 200,
  "errors": null,
  "data": { ... },
  "response_id": "1700000000.12345"
}

The data object contains the full participant profile.

Response Fields

Identity

Field	Type	Description
`id`	integer	Internal account ID
`external_id`	string or null	External ID
`external_qr`	string or null	External QR code value
`barcode`	string	EAN barcode assigned to the account
`badge_qr`	string	QR code value for the participant's badge
`status`	string	Participant status for this event (e.g. `ACTIVE`, `REGISTERED`)

Personal Information

Field	Type	Description
`title`	string or null	Honorific title / salutation
`first_name`	string	First name
`last_name`	string	Last name
`email`	string	Email address / login
`job_title`	string or null	Job title
`company_name`	string	Company name
`country`	string or null	Country name
`region`	string or null	Region / state name
`city`	string or null	City name
`postcode`	string or null	Postal / ZIP code
`nationality`	string or null	Nationality
`address`	string or null	Street address
`tel`	string	Phone number
`website`	string or null	Website URL
`birthdate`	string or null	Date of birth
`photo`	string	Profile photo URL
`description`	string or null	Participant biography
`matchmaking_message`	string	Matchmaking introduction message
`organisation_name`	string or null	Organisation name
`organisation_id`	string or null	Organisation ID
`default_lang`	string	Default notification language code

Event Participation

Field	Type	Description
`category_id`	integer	Participant category ID for this event
`category_name`	string	Participant category name
`exhibitor_id`	integer	Associated exhibitor ID (`0` if none)
`exhibitor_category_id`	string	Exhibitor category ID
`member_role`	string or null	Role within the exhibitor team
`speaker`	boolean	Whether the account has the speaker role for this event
`moderator`	boolean	Whether the account has the moderator role for this event
`assign_admin_id`	integer or null	Admin account assigned to this participant
`registered_date`	string	Registration date in `DD.MM.YYYY` format
`registered_time`	string	Registration time in `HH:MM:SS` format
`last_update`	integer	Unix timestamp of the last profile update

Business Matching

Field	Type	Description
`activity_categories`	string or null	Semicolon-separated activity category IDs
`interest_categories`	string or null	Semicolon-separated interest category IDs

Field	Type	Description
`twitter_page`	string or null	Twitter / X URL
`facebook_page`	string or null	Facebook URL
`linkedin_page`	string or null	LinkedIn URL
`instagram_page`	string or null	Instagram URL
`youtube_page`	string or null	YouTube URL

Notification Settings

Field	Type	Description
`receiveAppointmentConfirm`	boolean	Appointment confirmed notification enabled
`receiveAppointmentCancel`	boolean	Appointment cancelled notification enabled
`receiveAppointmentIncoming`	boolean	Incoming appointment notification enabled
`receiveAppointmentRescheduled`	boolean	Rescheduled appointment notification enabled
`receiveMessageNotification`	boolean	New message notification enabled

Connection Settings

Field	Type	Description
`networking`	integer	Networking opt-in flag (`0` or `1`)
`allow_receive_requests`	integer	Allow meeting requests (`0` or `1`)
`allow_receive_messages`	integer	Allow messages (`0` or `1`)
`allow_meetings`	integer	Meetings feature flag (`0` or `1`)
`allow_chats`	integer	Chat feature flag (`0` or `1`)
`timeslot_daily_limit`	integer	Daily meeting slot limit

Barcodes

Field	Type	Description
`external_barcode`	string	External barcode value

Error Responses

HTTP Code	Condition	Error Message
400	`event_id`, `filter`, or `value` is missing	`Missing required parameter: {param}`
400	`event_id` is not a valid integer	`Param must be a integer: event_id`
400	`event_id` references a non-existent event	`Could not find an event with id = {id}`
400	`filter` is not one of the accepted values	`Invalid Filter. Valid filters: id, external_id, email`
400	`filter=email` and `value` is not a valid email	`Param email must be a valid email`
400	`filter=id` and no account found	`Invalid Account ID`
400	`filter=external_id` and no account found	`Invalid Account External Id`
400	`filter=email` and no account found	`Invalid Account Email`
400	Account exists but is not registered for this event	`User exists in the database but is not registered for event ID`
403	Missing or invalid API key	`Forbidden`

Example Request

Bash

curl -X GET "https://your-event-domain.com/api/v2/account/get?event_id=7&filter=email&value=john.doe@example.com" \
  -H "Authorization: Bearer your_api_key_here"

Example Response