# WaitlistSignups

> List one waitlist's signups with filter and sort. Read access, waitlists toolset, MCP tool get_waitlist_signups.

**Access:** [Read](https://developer.missin.co.uk/get-started/authentication.md#access-levels)

## Variables

| Variable | Type | Required | Accepts | Description |
|---|---|---|---|---|
| `filter` | `WaitlistSignupFilter` | no | Input object, below |  |
| `first` | `Int` | no | 32-bit integer. Default `200` |  |
| `orderBy` | `[WaitlistSignupOrderBy!]` | no | One of 17 values, see [WaitlistSignupOrderBy](https://developer.missin.co.uk/reference/input-types.md#waitlistsignuporderby). Default `["ROW_ID_DESC"]` | The method to use when ordering `WaitlistSignup`. |
| `waitlistId` | `UUID!` | yes |  | Checks for equality with the object’s `waitlistId` field. |

## Input types

A filter lists its fields by the type they take, and none of them is required.

### WaitlistSignupFilter

- `[WaitlistSignupFilter!]`: `and`, `or`
- `Boolean`: `customerByCustomerIdExists`
- [UUIDFilter](https://developer.missin.co.uk/reference/input-types.md#uuidfilter): `customerId`, `rowId`, `waitlistId`, `workspaceId`
- [StringFilter](https://developer.missin.co.uk/reference/input-types.md#stringfilter): `emailCanonical`, `emailNormalized`
- `WaitlistSignupFilter`: `not`
- `WaitlistSignupStatusFilter`: `status`

### WaitlistSignupStatusFilter

- `WaitlistSignupStatus` (One of `CONFIRMED`, `ERASED`, `PENDING_CONFIRMATION`, `UNSUBSCRIBED`): `equalTo`, `greaterThan`, `greaterThanOrEqualTo`, `lessThan`, `lessThanOrEqualTo`, `notEqualTo`
- `[WaitlistSignupStatus!]` (One of `CONFIRMED`, `ERASED`, `PENDING_CONFIRMATION`, `UNSUBSCRIBED`): `in`, `notIn`
- `Boolean`: `isNull`

## Call it

```bash curl
curl https://api.missin.co.uk/graphql/v1 \
  -H "Authorization: Bearer $MISSIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"operationName":"WaitlistSignups","variables":{"waitlistId":"00000000-0000-0000-0000-000000000000"},"extensions":{"persistedQuery":{"version":1,"sha256Hash":"203f03f798dde6c981e1be753a2e5502acdb9dc623703ad1b007ff98975b57a9"}}}'
```

## Document

```graphql
query WaitlistSignups($filter: WaitlistSignupFilter, $first: Int = 200, $orderBy: [WaitlistSignupOrderBy!] = [ROW_ID_DESC], $waitlistId: UUID!) { __typename allWaitlistSignups( condition: {waitlistId: $waitlistId} first: $first filter: $filter orderBy: $orderBy ) { __typename nodes { __typename confirmedAt createdAt email entryCount id incentiveGrantsByWaitlistSignupId { __typename nodes { __typename failReason id resolved status } } lastEntryAt marketingConsent rowId source status } totalCount } }
```

Source: https://developer.missin.co.uk/reference/waitlists/waitlist-signups