GET participants/{eventId}/deletedList

GET /api/v2/participants/{eventId}/deletedList

Returns a paginated list of account IDs that have been removed from a given event. Supports filtering by timestamp to retrieve only recently deleted records — ideal for keeping an external system in sync.


Authentication

Authorization: Bearer <your_api_key>

Endpoint

GET /api/v2/participants/{eventId}/deletedList

Path Parameters

Parameter

Type

Required

Description

eventId

integer

Yes

The ID of the event to query deleted participants for


Query Parameters

Parameter

Type

Required

Default

Accepted Values / Format

Description

limit

integer

No

1000

1–1000

Number of items per page

page

integer

No

1

Any positive integer

Page number (1-based)

timestamp

integer

No

Unix timestamp

When provided, returns only accounts deleted on or after this timestamp


Response

Success Response (HTTP 200)

JSON
{
  "code": 200,
  "errors": null,
  "data": {
    "list": [10023, 10487, 11902],
    "limit": 1000,
    "page": 1,
    "total": 3,
    "last_page": 1
  },
  "response_id": "1700000000.12345"
}

Field

Type

Description

list

array of integers

Internal account IDs of participants removed from this event

limit

integer

Page size used

page

integer

Current page number

total

integer

Total number of matching deleted records

last_page

integer

Last available page number

Note: The response contains account IDs only — not full profile objects. Use the IDs to delete or archive the corresponding records in your own system.


Error Responses

HTTP Code

Condition

Error Message

400

Invalid limit, page, or timestamp

Validation error

404

Event not found

(HTTP 404)

403

Missing or invalid API key

Forbidden


Example Request

Bash
curl -X GET "https://your-event-domain.com/api/v2/participants/7/deletedList?timestamp=1700000000&limit=500&page=1" \
  -H "Authorization: Bearer your_api_key_here"

Example Response

JSON
{
  "code": 200,
  "errors": null,
  "data": {
    "list": [10023, 10487, 11902],
    "limit": 500,
    "page": 1,
    "total": 3,
    "last_page": 1
  },
  "response_id": "1700000000.12345"
}