> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4casters.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get participants

> List teams, players, and futures sides

Returns a deduplicated list of participants — teams, players, futures sides — across the exchange. Use `participantID` values from this endpoint as the `side` field when placing `moneyline` or `spread` orders.

## Request

`GET /exchange/getParticipants`

<ParamField query="active" type="string">
  When `active=true`, restrict the response to participants of games starting in the future. When `active=false` (or omitted), return participants across all games.
</ParamField>

<CodeGroup>
  ```bash curl theme={null}
  curl "https://api.4casters.io/exchange/getParticipants?active=true" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</CodeGroup>

## Response

<ResponseField name="data.participants" type="array">
  <Expandable title="Participant">
    <ResponseField name="participantID" type="string">Participant id. Use as `side` when placing moneyline / spread orders.</ResponseField>

    <ResponseField name="longName" type="string" />

    <ResponseField name="shortName" type="string" />

    <ResponseField name="league" type="string" />

    <ResponseField name="sport" type="string" />
  </Expandable>
</ResponseField>

### Example

<CodeGroup>
  ```json JSON theme={null}
  {
    "data": {
      "participants": [
        {
          "participantID": "6021801d14a2fe0012fa0c62",
          "longName":      "Harold Varner III",
          "shortName":     "Varner",
          "league":        "PGA",
          "sport":         "golf"
        }
      ]
    }
  }
  ```
</CodeGroup>


## OpenAPI

````yaml GET /exchange/getParticipants
openapi: 3.1.0
info:
  title: 4casters REST API
  version: 1.0.0
  description: >-
    Public REST API for the 4casters peer-to-peer betting exchange. Use this API
    to manage your account, query the orderbook and games, and place / edit /
    cancel orders.


    All responses (unless noted otherwise) are JSON envelopes of the form `{
    "data": ... }`.
  contact:
    name: 4casters
    url: https://4casters.io
servers:
  - url: https://api.4casters.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Login and account session management
  - name: User
    description: Read account info, bets, and orders
  - name: Orders
    description: Place, edit, look up, and cancel orders
  - name: Markets
    description: Browse leagues, games, participants, and orderbooks
  - name: Affiliate
    description: Affiliate / referral commission
paths:
  /exchange/getParticipants:
    get:
      tags:
        - Markets
      summary: Get participants
      description: >-
        Return a deduplicated list of participants (teams, players, futures
        sides). When `active=true`, only participants of games starting in the
        future are returned.
      parameters:
        - name: active
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
          description: >-
            When `true`, only return participants of games starting in the
            future.
      responses:
        '200':
          description: Participants list
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      participants:
                        type: array
                        items:
                          $ref: '#/components/schemas/ParticipantSummary'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ParticipantSummary:
      type: object
      properties:
        participantID:
          type: string
        longName:
          type: string
        shortName:
          type: string
        league:
          type: string
        sport:
          type: string
  responses:
    Unauthorized:
      description: Missing or invalid auth token
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass your auth token in the `Authorization` header. The `Bearer` prefix
        is optional; the server also accepts a signed `auth` cookie or a `token`
        field in the request body.

````