> ## Documentation Index
> Fetch the complete documentation index at: https://partner-help.letsdothis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List the races linked to a seat

> Lists the races linked to this seat, oldest first, including past and canceled entries.

## How to use it

- Each entry has a `source`. `RESERVED_PLACE` is a place reserved for the member, such as a ballot entry, and the booking made from it. `MEMBER_BOOKING` is a race booked with this seat, such as a free member entry. More sources may be added.
- Each entry is one event, with `eventTitle` and `eventDate`. `booking` has the booking's status and race, and is `null` while a reserved place is unclaimed.
- Claim status applies to reserved places and is separate from the reservation and booking statuses.
- Ordinary bookings, and guest passes given to other people, aren't included.
- Reservation codes, participant details and billing data are never returned.

> [!NOTE]
>
> This endpoint is in beta: its request and response contract can still change while it's being developed.


## OpenAPI

````yaml /openapi.json get /v0/membership-seats/{seatId}/entries
openapi: 3.1.0
info:
  title: Let's Do This API
  version: 0.1.0
  description: >
    The full reference — getting started, pagination, error responses, rate
    limits and the changelog — lives at

    [partner-help.letsdothis.com/api-reference](https://partner-help.letsdothis.com/api-reference/overview).

    This page is the interactive OpenAPI view of the same specification.


    # Authentication


    Create an API key from **Settings** → **Credentials** in your Let's Do This
    account and send it as a bearer token:


    ```bash

    curl --request GET \
     --url "https://api.letsdothis.com/v0/participants" \
     --header "Authorization: Bearer YOUR-API-KEY"
    ```


    Keep the key secret: it identifies your organization, so do not ship it in a
    website or native app. If a key is exposed,

    revoke it from the same section and create a replacement.


    # OpenAPI schema


    Download the [OpenAPI schema](https://api.letsdothis.com/documentation/json)
    to use with Postman or an OpenAPI client

    generator.
servers:
  - url: https://api.letsdothis.com
    description: Production
  - url: https://api.staging.letsdothis.com
    description: Staging
security:
  - bearerAuth: []
tags:
  - name: Events
    x-group: Events
    description: Events that participants can register for.
  - name: EventOccurrences
    x-group: Event occurrences
    description: >-
      Event occurrences scoped to the organizer associated with your Public API
      credentials. Unlike the public Events catalog, results are limited to your
      own events.
  - name: Races
    x-group: Races
    description: >-
      Races within an event occurrence. An event occurrence may have one or more
      races, for example a 5K and a 10K within the same race day.
  - name: Tickets
    x-group: Tickets
    description: Tickets that are available for events.
  - name: BookingForms
    x-group: Booking forms
    description: >-
      Booking forms define the questions a booker answers when registering for a
      ticket. A ticket usually references a single booking form, so expect zero
      or one, while a booking form may be shared across multiple tickets.
  - name: BookingFormFields
    x-group: Booking form fields
    description: >-
      Booking form fields are the individual questions on a booking form — their
      type, label, options, and whether an answer is required. A field can be
      reused across multiple forms.
  - name: Bookings
    x-group: Bookings
    description: >-
      Bookings are the transaction record for a registration. A booking may
      contain one or more participants (entries).
  - name: Membership
    x-group: Memberships
    description: >-
      Membership schemes, purchased policies and the seats on them, owned by
      your organizer. Policies are billing contracts; a seat is one person's
      place on a policy.
  - name: Participant
    x-group: Participants
    description: Participants are users who successfully booked an event.
  - name: LineItem
    x-group: Line items
    description: Financial details related to individual items within transactions.
  - name: AddOns
    x-group: Add-ons
    description: >-
      Your add-on products, such as merchandise or extras, that participants buy
      with their entry. Imported products keep the ids you gave them.
  - name: DiscountCodes
    x-group: Discount codes
    description: >-
      Discount codes participants enter at checkout to reduce the price of a
      booking.
  - name: Credits
    x-group: Credits
    description: >-
      Credits are balances participants can spend at checkout, identified by
      their email address.
  - name: Referrals
    x-group: Referrals
    description: >-
      Referral programs, the referrers registered on them, and asynchronous
      imports of historical referrals.
  - name: Teams
    x-group: Teams
    description: >-
      Teams group participants of an event occurrence under a team program.
      Teams can be imported for participants whose bookings were imported.
  - name: Application
    x-group: Applications
    description: >-
      Applications are created when a user applies for tickets that are set up
      to require an application process, such as balloted or "Good For Age"
      entries.
  - name: Partner
    x-group: Partners
    description: >-
      Partners that were created by the organization who can have Reserved
      Entries assigned to them.
  - name: ReservedEntries
    x-group: Reserved entries
    description: >-
      Reserved Entries are entries that are reserved for a partner. After being
      assigned, the partner can then allocate these entries to participants.
  - name: Timing
    x-group: Timing
    description: >-
      Timing providers push bib numbers and bib-pack shipments back to Let's Do
      This for the startlist entries they received. Available to select timing
      partners only.
  - name: Identity
    x-group: API key
    description: >-
      What your API key can reach. Available to every key, including scoped
      ones.
paths:
  /v0/membership-seats/{seatId}/entries:
    get:
      tags:
        - Membership
      summary: List the races linked to a seat
      description: >-
        Lists the races linked to this seat, oldest first, including past and
        canceled entries.


        ## How to use it


        - Each entry has a `source`. `RESERVED_PLACE` is a place reserved for
        the member, such as a ballot entry, and the booking made from it.
        `MEMBER_BOOKING` is a race booked with this seat, such as a free member
        entry. More sources may be added.

        - Each entry is one event, with `eventTitle` and `eventDate`. `booking`
        has the booking's status and race, and is `null` while a reserved place
        is unclaimed.

        - Claim status applies to reserved places and is separate from the
        reservation and booking statuses.

        - Ordinary bookings, and guest passes given to other people, aren't
        included.

        - Reservation codes, participant details and billing data are never
        returned.
      parameters:
        - schema:
            type:
              - number
              - 'null'
            minimum: 1
            maximum: 500
            example: 100
          in: query
          name: page[size]
          required: false
          description: How many results to return per page, from 1 to 500. Defaults to 100.
        - schema:
            type:
              - string
              - 'null'
          in: query
          name: page[after]
          required: false
          description: Pass `page.next` from the previous response to get the next page.
        - schema:
            type:
              - string
              - 'null'
          in: query
          name: page[before]
          required: false
          description: >-
            Pass `page.prev` from the previous response to get the previous
            page.
        - schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
          in: path
          name: seatId
          required: true
          description: >-
            The id of a membership seat, one person's place on a policy, as List
            membership seats returns it.
      responses:
        '200':
          description: A page of the races linked to the seat.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PagedMembershipSeatEntries'
        '400':
          description: A query parameter is missing or malformed. `message` says which.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - statusCode
                  - message
                properties:
                  code:
                    type: string
                    enum:
                      - MEMBERSHIP_INVALID_REQUEST
                  statusCode:
                    type: integer
                    enum:
                      - 400
                  message:
                    type: string
        '404':
          description: Your organization has no membership seat with this id.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - statusCode
                  - message
                properties:
                  code:
                    type: string
                    enum:
                      - MEMBERSHIP_RESOURCE_NOT_FOUND
                  statusCode:
                    type: integer
                    enum:
                      - 404
                  message:
                    type: string
components:
  schemas:
    PagedMembershipSeatEntries:
      title: PagedMembershipSeatEntries
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/MembershipSeatEntry'
        page:
          $ref: '#/components/schemas/PageCursor'
      required:
        - data
        - page
      additionalProperties: false
    MembershipSeatEntry:
      title: MembershipSeatEntry
      type: object
      properties:
        id:
          type: string
        seatId:
          type: string
        source:
          $ref: '#/components/schemas/MembershipSeatEntrySource'
        claimStatus:
          type:
            - string
            - 'null'
          enum:
            - CLAIMED
            - UNCLAIMED
            - null
          description: Reserved places only; null for member bookings.
        reservationStatus:
          anyOf:
            - $ref: '#/components/schemas/MembershipSeatReservationStatus'
            - type: 'null'
          description: Reserved places only; null for member bookings.
        expiresAt:
          type:
            - string
            - 'null'
          description: When an unclaimed reserved place lapses; null for member bookings.
        eventId:
          type: string
        eventOccurrenceId:
          type: string
        eventTitle:
          type:
            - string
            - 'null'
        eventDate:
          type:
            - string
            - 'null'
          description: >-
            When the event starts: its earliest race. Null when no race has a
            date.
        booking:
          anyOf:
            - $ref: '#/components/schemas/MembershipSeatEntryBooking'
            - type: 'null'
          description: The member's booking; null while a reserved place is unclaimed.
      required:
        - id
        - seatId
        - source
        - claimStatus
        - reservationStatus
        - expiresAt
        - eventId
        - eventOccurrenceId
        - eventTitle
        - eventDate
        - booking
      additionalProperties: false
    PageCursor:
      title: PageCursor
      type: object
      properties:
        totalResults:
          type: number
          description: The total number of results available.
        first:
          type: string
          description: The cursor for the first page of results.
        last:
          type: string
          description: The cursor for the last page of results.
        prev:
          type: string
          description: The cursor for the previous page of results.
        next:
          type: string
          description: The cursor for the next page of results.
      required:
        - totalResults
        - first
        - last
        - prev
        - next
      additionalProperties: false
      description: >-
        Where you are in a paginated list.


        Pass `next` as `page[after]` to get the next page, or `prev` as
        `page[before]` to get the previous one. An empty cursor means there are
        no more pages in that direction. Treat cursors as opaque strings.
      example:
        totalResults: 506
        first: >-
          eyJpZCI6IjYzOTljMjAwMTVkNjBhZTNmZjI4ZjI0YyIsInVwZGF0ZWRBdCI6IjIwMjItMTItMTRUMTI6MzA6NTkuMjE3WiJ9
        last: >-
          eyJpZCI6IjY1NGNkZDIxZDlhMTU3ODdiNzFkMTM0YSIsInVwZGF0ZWRBdCI6IjIwMjMtMTEtMTNUMTU6MTE6MTIuNzI0WiJ9
        prev: ''
        next: >-
          eyJpZCI6IjY0NzBkNTkwM2RjOWE5OWJhMTA0Y2ZhYiIsInVwZGF0ZWRBdCI6IjIwMjMtMTEtMTNUMTU6MTE6MTIuNjE4WiJ9
    MembershipSeatEntrySource:
      title: MembershipSeatEntrySource
      type: string
      enum:
        - RESERVED_PLACE
        - MEMBER_BOOKING
      description: >-
        Where a seat's entry comes from: a place reserved for the member, such
        as a ballot entry, or a race booked with the seat, such as a free member
        entry. More sources may be added; skip entries whose source you don't
        handle.
    MembershipSeatReservationStatus:
      title: MembershipSeatReservationStatus
      type: string
      enum:
        - NOT_ALLOCATED
        - ALLOCATED
        - INVITATION_SENT
        - INVITATION_OPENED
        - COMPLETED
        - REVOKED
        - CANCELED
      description: >-
        Where the reserved place is in its lifecycle: not yet assigned
        (`NOT_ALLOCATED`), assigned to the member (`ALLOCATED`), invited
        (`INVITATION_SENT`, `INVITATION_OPENED`), booked (`COMPLETED`), or
        withdrawn (`REVOKED`, `CANCELED`). Use `claimStatus` and
        `booking.status` to tell whether the member actually holds an entry.
    MembershipSeatEntryBooking:
      title: MembershipSeatEntryBooking
      type: object
      properties:
        id:
          type: string
        status:
          type: string
          description: The booking's status, for example `CONFIRMED` or `CANCELLED`.
        race:
          anyOf:
            - $ref: '#/components/schemas/MembershipSeatEntryRace'
            - type: 'null'
          description: >-
            The race booked. A booking moved to another race in the event shows
            the race it's in now. Null when it can no longer be resolved.
      required:
        - id
        - status
        - race
      additionalProperties: false
    MembershipSeatEntryRace:
      title: MembershipSeatEntryRace
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        startDate:
          type:
            - string
            - 'null'
      required:
        - id
        - title
        - startDate
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.