> ## 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.

# Read member details

> Returns the core details (first and last name, email, phone, address, date of birth) as top-level properties and every other question on the membership form in customFields, each with its id, name and the answer as text. The caller must authorize its signed-in member to this membership.

> [!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/memberships/{membershipId}
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 memberships on them, owned
      by your organizer. Policies are billing contracts; a membership is one
      person 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: >-
      Organizer-owned products that can be purchased and allocated to
      participants. Imported products retain stable external identities.
  - 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: 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/memberships/{membershipId}:
    get:
      tags:
        - Membership
      summary: Read member details
      description: >-
        Returns the core details (first and last name, email, phone, address,
        date of birth) as top-level properties and every other question on the
        membership form in customFields, each with its id, name and the answer
        as text. The caller must authorize its signed-in member to this
        membership.
      parameters:
        - schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
          in: path
          name: membershipId
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MembershipDetails'
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - statusCode
                  - message
                properties:
                  code:
                    type: string
                    enum:
                      - MEMBERSHIP_RESOURCE_NOT_FOUND
                      - MEMBERSHIP_INVALID_REQUEST
                      - MEMBERSHIP_PORTAL_CONFIGURATION_REQUIRED
                      - MEMBERSHIP_BILLING_UNAVAILABLE
                      - MEMBERSHIP_FROZEN
                      - MEMBERSHIP_ALREADY_CANCELLED
                    description: >-
                      Stable error identifier. RESOURCE_NOT_FOUND covers missing
                      and foreign resources alike. INVALID_REQUEST covers
                      malformed input or fields that cannot be edited.
                      PORTAL_CONFIGURATION_REQUIRED requires account setup;
                      BILLING_UNAVAILABLE means billing cannot be resolved or
                      reached. FROZEN and ALREADY_CANCELLED are reserved for
                      future lifecycle writes.
                  statusCode:
                    type: integer
                  message:
                    type: string
components:
  schemas:
    MembershipDetails:
      title: MembershipDetails
      type: object
      properties:
        id:
          type: string
        firstName:
          type:
            - string
            - 'null'
        lastName:
          type:
            - string
            - 'null'
        emailAddress:
          type:
            - string
            - 'null'
          description: >-
            The account email. Read-only; staff move a membership from the
            dashboard.
        phone:
          anyOf:
            - $ref: '#/components/schemas/MembershipPhone'
            - type: 'null'
        address:
          anyOf:
            - $ref: '#/components/schemas/MembershipAddress'
            - type: 'null'
        dateOfBirth:
          type:
            - string
            - 'null'
          description: ISO date (YYYY-MM-DD). Null when none is recorded.
        customFields:
          type: array
          items:
            $ref: '#/components/schemas/MembershipCustomField'
      required:
        - id
        - firstName
        - lastName
        - emailAddress
        - phone
        - address
        - dateOfBirth
        - customFields
      additionalProperties: false
      description: >-
        Core details are top-level; every other question on the organiser's
        membership form is a custom field.
    MembershipPhone:
      title: MembershipPhone
      type: object
      properties:
        countryCode:
          type: string
          description: >-
            ISO 3166-1 alpha-2 country code, such as `DK` or `GB`; not a
            dialling code.
        number:
          type: string
          description: >-
            The number as the member entered it, which may be in national
            format, such as `07700900123` for `GB`. Combine it with
            `countryCode` using a phone-number library to call or text.
      required:
        - countryCode
        - number
      additionalProperties: false
    MembershipAddress:
      title: MembershipAddress
      type: object
      properties:
        line1:
          type:
            - string
            - 'null'
        line2:
          type:
            - string
            - 'null'
        city:
          type:
            - string
            - 'null'
        county:
          type:
            - string
            - 'null'
        postcode:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
      required:
        - line1
        - line2
        - city
        - county
        - postcode
        - country
      additionalProperties: false
    MembershipCustomField:
      title: MembershipCustomField
      type: object
      properties:
        id:
          type: string
          description: The form field id, as in a participant's `fields`.
        name:
          type: string
        value:
          type:
            - string
            - 'null'
          description: The member's answer as text; null when there is none.
      required:
        - id
        - name
        - value
      additionalProperties: false
      description: An answer to one custom question on the membership form.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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