Get Waitlist Member

Retrieve one signup from a waitlist.

The member must belong to that waitlist, the waitlist must belong to this store, and its product must still exist. The body is a single member object, the same shape as a member list item, including custom_field_answers.

Request

GET /waitlists/{id}/members/{memberId}

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Waitlist UUID.
memberId	string	Yes	Signup UUID.

Example Request

curl -X GET "https://cart.easy.tools/api/v1/waitlists/550e8400-e29b-41d4-a716-446655440000/members/7c9e6679-7425-40de-944b-e07fc1f90ae7" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Response

Success Response (200)

Returns one signup. This is the item from Get Waitlist Members, with no items wrapper. A signup with no answers returns "custom_field_answers": {}.

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "full_name": "Ada Lovelace",
  "terms_accepted": true,
  "joined_at": "2026-09-01T11:00:00+00:00",
  "custom_field_answers": {
    "company": "Analytical Engines",
    "newsletter": true
  }
}

Response Fields

Field reference: Waitlist Member object.

Field	Type	Nullable	Description
id	string	No	Signup UUID.
email	string	No	Signup email.
first_name	string	Yes	First name. Null when the signup did not include one.
last_name	string	Yes	Last name. Null when the signup did not include one.
full_name	string	Yes	First and last name joined with a space, trimmed. Null only when both names are empty.
terms_accepted	boolean	No	Whether the signup accepted the terms.
joined_at	string	No	When the person first signed up (ISO 8601).
custom_field_answers	object	No	Answers submitted with the signup, keyed by the custom field name. {} when there are no answers.

Error Responses

Bad Request (400)

Returned when id or memberId is not a UUID.

{
  "message": "Invalid waitlist ID"
}

A malformed memberId uses the member message:

{
  "message": "Invalid waitlist member ID"
}

Not Found Error (404)

Returned when the waitlist does not exist in this store, when its product no longer exists, or when the signup does not belong to that waitlist.

{
  "message": "Waitlist with ID 8d5c2e19-4f76-4a3b-9c14-1e6b55a40d3f not found"
}

A waitlist that exists, with a signup id that is not on it:

{
  "message": "Waitlist member with ID 9e6d3f2a-5b87-4c4c-8d25-2f7c66b51e40 not found"
}

Unauthorized Error (401)

{
  "message": "Unauthenticated."
}

Forbidden Error (403)

Returned when your API key has not been granted access to the requested store.

{
  "message": "You do not have API access to the requested store."
}

Rate Limit Error (429 Too Many Requests)

Returned when you exceed the rate limit. The Retry-After response header gives the number of seconds to wait.

{
  "message": "Too many requests. Please retry after 60 seconds."
}