Skip to main content
GET
/
v1
/
guests
List all guests
curl --request GET \
  --url https://{workspace}.attendu.com/api/v1/guests \
  --header 'x-api-key: <api-key>'
{
  "results": [
    {
      "_id": "<string>",
      "event": "<string>",
      "status": {
        "confirmation": 2,
        "attendance": 1,
        "declineMessage": null,
        "givenConsents": [],
        "visitedZones": [],
        "addMethod": "publicRegistration",
        "checkInMethod": "qrScan"
      },
      "properties": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "[email protected]",
        "lang": "en",
        "X62TkjiV": "My custom note",
        "yN9hzaCj": "1QLXYBlw",
        "Ybb48GO7": [
          "7bR7m2au",
          "BdwYyYmi"
        ],
        "ticketType": "QF78tnh3"
      },
      "_populated": {
        "properties": {
          "First name": "John",
          "Last name": "Doe",
          "Email": "[email protected]",
          "Language": "en",
          "Note": "My custom note",
          "Ticket type": "VIP",
          "Interests": [
            "Technology",
            "Business"
          ]
        },
        "status": {
          "confirmation": "Confirmed (+1)",
          "attendance": "Attended"
        }
      },
      "confirmedAt": "2023-11-07T05:31:56Z",
      "attendedAt": "2023-11-07T05:31:56Z",
      "starred": false,
      "extras": {
        "roommates": [
          "507f1f77bcf86cd799439011",
          "507f191e810c19729de860ea"
        ],
        "payment": {
          "isPaid": true,
          "paidAt": "2023-04-15T14:30:00Z",
          "stripePaymentIntent": "pi_3RJut1234567890",
          "stripeInvoice": "in_1RJutEIz1234567890",
          "usedPromoCodes": [
            {
              "id": "43oMGCex",
              "amount": 100,
              "code": "U2QWC8"
            }
          ]
        }
      }
    }
  ],
  "total": 123
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
event
string
required

Event ID to scope the guest list.

​
skip
integer

Number of records to skip for pagination.

Required range: x >= 0
Example:

0

​
limit
integer
default:20

Maximum number of records to return.

Required range: 1 <= x <= 100
Example:

20

​
search
string

Search term for filtering guests by first name, last name, or email.

Example:

"john"

​
email
string

Filter guests by exact email address match.

Example:

"[email protected]"

​
sortBy
string

Sort field and direction (field:asc|desc).

Example:

"lastName:asc"

​
filterBy
string

JSON-encoded filter criteria for guest properties.

Example:

"{\"status.confirmation\":1}"

Response

List of guests with pagination metadata.

​
results
object[]
​
total
integer

Total count of matching guests