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 |
|---|---|---|---|
|
|
integer |
Yes |
The ID of the event to query deleted participants for |
Query Parameters
|
Parameter |
Type |
Required |
Default |
Accepted Values / Format |
Description |
|---|---|---|---|---|---|
|
|
integer |
No |
|
1–1000 |
Number of items per page |
|
|
integer |
No |
|
Any positive integer |
Page number (1-based) |
|
|
integer |
No |
— |
Unix timestamp |
When provided, returns only accounts deleted on or after this timestamp |
Response
Success Response (HTTP 200)
{
"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 |
|---|---|---|
|
|
array of integers |
Internal account IDs of participants removed from this event |
|
|
integer |
Page size used |
|
|
integer |
Current page number |
|
|
integer |
Total number of matching deleted records |
|
|
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 |
Validation error |
|
404 |
Event not found |
(HTTP 404) |
|
403 |
Missing or invalid API key |
|
Example Request
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
{
"code": 200,
"errors": null,
"data": {
"list": [10023, 10487, 11902],
"limit": 500,
"page": 1,
"total": 3,
"last_page": 1
},
"response_id": "1700000000.12345"
}