GET account/buyers | ExpoPlatform Helpdesk

GET `/api/v2/account/buyers`

Returns a paginated list of buyer participants registered for a given event. Only accounts assigned to a buyer category are returned.

Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/account/buyers

Query Parameters

Parameter	Type	Required	Default	Accepted Values / Format	Description
`event_id`	integer	Yes	—	Valid event ID	The event to retrieve buyer participants for
`limit`	integer	No	`100`	1–100	Number of results per page. Capped at `100`
`page`	integer	No	`1`	Any positive integer	Page number (1-based)

Response

Success Response (HTTP 200)

JSON

{
  "code": 200,
  "errors": null,
  "data": {
    "list": [ { ...account object... } ],
    "limit": 100,
    "page": 1,
    "total": 42
  },
  "response_id": "1700000000.12345"
}

Field	Type	Description
`list`	array	Array of full participant profile objects
`limit`	integer	The page size used
`page`	integer	The current page number
`total`	integer	Total number of buyer participants for this event

Each object in list contains the same full profile fields as GET /api/v2/account/get.

Error Responses

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

Example Request

Bash

curl -X GET "https://your-event-domain.com/api/v2/account/buyers?event_id=7&limit=50&page=1" \
  -H "Authorization: Bearer your_api_key_here"

Example Response

JSON

{
  "code": 200,
  "errors": null,
  "data": {
    "list": [
      {
        "id": 12345,
        "status": "ACTIVE",
        "first_name": "Jane",
        "last_name": "Smith",
        "email": "jane.smith@example.com",
        "company_name": "Acme Corp",
        "category_id": 8,
        "category_name": "Buyer"
      }
    ],
    "limit": 50,
    "page": 1,
    "total": 1
  },
  "response_id": "1700000000.12345"
}