POST account/exists | ExpoPlatform Helpdesk

POST `/api/v2/account/exists`

Checks whether a participant account exists in the system, and whether it is registered for a specific event. Accepts an account ID, External ID, or email address as the lookup identifier.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

POST /api/v2/account/exists

Body Parameters

Content-Type: multipart/form-data

Parameter	Type	Required	Accepted Values / Format	Description
`id`	string	Yes	Numeric account ID, External ID string, or email address	The identifier to look up. The endpoint tries to match it as an integer ID first, then as an External ID, then as an email address
`event_id`	integer	Yes	Valid event ID	The event to check membership against

How the lookup works

The endpoint resolves the account by trying three strategies in order, stopping at the first match:

By numeric ID — if the value is an integer, it's matched against the internal account ID
By External ID — the value is matched against stored External IDs
By email — the value is matched against account email addresses

The info field in the response indicates which strategy produced the match.

Response

Success Response (HTTP 200)

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "exist": true,
    "event_exist": true,
    "info": ["Account match: id"]
  },
  "response_id": "1700000000.12345"
}

Field	Type	Description
`id`	integer	Resolved internal account ID. Returns `0` if no account was found
`exist`	boolean	`true` if an account matching the given identifier was found
`event_exist`	boolean	`true` if the account is registered for the given event. Always `false` when `exist` is `false`
`info`	array	Present only when a match is found. Describes which lookup strategy was used (e.g. `"Account match: email"`)

Account not found

JSON

{
  "code": 200,
  "data": {
    "id": 0,
    "exist": false,
    "event_exist": false
  },
  "response_id": "1700000000.12345"
}

Error Responses

HTTP Code	Condition	Error Message
400	`id` or `event_id` is missing	`Param is required: id` / `Param is required: event_id`
400	`event_id` is not a valid integer	`Param must be a integer: event_id`
400	`id` is empty	`Account ID is required`
400	Event not found	`Could not find an event with id = {event_id}`
403	Missing or invalid API key	`Forbidden`

Example Request — check by email

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/exists" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "id=john.doe@example.com" \
  -F "event_id=7"

Example Response — found and registered

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "exist": true,
    "event_exist": true,
    "info": ["Account match: email"]
  },
  "response_id": "1700000000.12345"
}

Example Response — account exists but not registered for this event

JSON

{
  "code": 200,
  "data": {
    "id": 12345,
    "exist": true,
    "event_exist": false,
    "info": ["Account match: email"]
  },
  "response_id": "1700000000.12345"
}