> For the complete documentation index, see [llms.txt](https://developer.perculus.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.perculus.com/v2-en/services/attendee-management/attande-filter.md).

# Searching Attendees

{% hint style="info" %}
If you like to see all attendees belonging to a session, you can achieve this by not sending any parameters to the request.
{% endhint %}

Available parameters:

| Parameter        | Type    | Description                                                                          |
| ---------------- | ------- | ------------------------------------------------------------------------------------ |
| user\_id         | string  | GUID of the user                                                                     |
| attendance\_code | string  | Attendance code of the participant                                                   |
| name             | string  | Name of the participant                                                              |
| surname          | string  | Surname of the participant                                                           |
| email            | string  | Email of the participant                                                             |
| role             | string  | Role of the participant([see](/v2-en/accepted-formats/roles.md) for possible values) |
| mobile           | string  | Mobile of the participant                                                            |
| page\_size       | integer | Page size                                                                            |
| page\_number     | integer | Page number                                                                          |

Example request:

{% tabs %}
{% tab title="CURL" %}

```bash
curl -L -X POST 'https://<DOMAIN>/api/groups/xapi/session/:SESSION_GUID/attendee/search' \
-H 'Content-Type: application/json' \
-d '{
    "name": "John"
}'
```

{% endtab %}

{% tab title="Python" %}

```python
client.attendees.search_attendees("<SESSION_ID>", {
        name: "John"
    });
```

{% endtab %}
{% endtabs %}

Example response:

```json
    {
        "session_id": "994A39B6-DB42-4368-902A-2F9C01EE7B3F",
        "user_id": "",
        "user_guid": null,
        "attendee_id": "503738",
        "attendance_code": "27A9E30B-48C3-4933-9E15-6752D686AB51",
        "name": "John",
        "surname": "Doe",
        "email": "doe@example.com",
        "role": "e",
        "mobile": null,
        "creation_date": "2024-10-18T21:39:39.000233+03:00",
        "updating_date": "2024-10-18T21:39:39.000233+03:00",
        "operation": null
    }
```