---
title: "Search the player directory"
method: GET
path: "/api/v1/players/search"
tags: ["Players"]
---

# Search the player directory

`GET /api/v1/players/search`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/players/search`
- Auth: HTTP bearer

Authenticated typeahead over active roster players. Name contains q (case-insensitive); names that start with q come first, then alphabetical.

## Query parameters

- `q` string, required
- `sport` 'hockey' | 'basketball' | 'soccer' | 'football' | 'baseball' | 'other'
- `limit` integer

## Response `200`

{ success, data: { players } }

- object
  - `success` boolean
  - `data` object
    - `players` object[], required
      - `id` string, required
      - `name` string, required
      - `teamName` string, nullable, required: Linked team's name, else the player's own team text.
      - `sport` string, nullable, required: Sports-catalog slug of the team's league.
      - `imageUrl` string, nullable, required

## Other responses

- `400`: VALIDATION_ERROR — bad q, sport or limit
- `401`: Authentication required
- `500`: INTERNAL_ERROR

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/players/search/get.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
