---
title: "Players by Search by Name"
method: GET
path: "/football/players/search/{name}"
tags: ["Players"]
---

# Players by Search by Name

`GET /football/players/search/{name}`

## Request

- Base URL: `https://api.sportmonks.com/v3`
- URL: `https://api.sportmonks.com/v3/football/players/search/{name}`
- Auth: one of:
  - API key in query parameter `api_token`
  - API key in header `Authorization`

This endpoint returns all the players that match your search query. The query returns only the players that have played matches in leagues that are part of your subscription. For more information, please visit:https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/players/get-players-by-search-by-name

[Sportmonks documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/players/get-players-by-search-by-name)

## Path parameters

- `name` string, required

## Query parameters

- `include` string
- `select` string[]
- `filters` string
- `locale` string
- `order` 'asc' | 'desc'
- `per_page` integer
- `page` integer

## Response `200`

Success.

- object
  - `data` Player[], required
    - `id` integer
    - `sport_id` integer
    - `country_id` integer
    - `nationality_id` integer, nullable
    - `city_id` integer, nullable
    - `position_id` integer, nullable
    - `detailed_position_id` integer, nullable
    - `type_id` integer, nullable
    - `common_name` string
    - `firstname` string
    - `lastname` string
    - `name` string
    - `display_name` string
    - `image_path` string
    - `height` integer, nullable
    - `weight` integer, nullable
    - `date_of_birth` string, nullable
    - `gender` string
    - `in_squad` boolean
  - `pagination` Pagination: Pagination metadata returned with collection responses.
    - `count` integer: Number of items in the current page.
    - `per_page` integer: Maximum items per page.
    - `current_page` integer: Current page number.
    - `next_page` string, nullable: URL of the next page, when available.
    - `has_more` boolean: True when more pages are available.
  - `subscription` SubscriptionInfo[]
    - `meta` SubscriptionMeta
      - `trial_ends_at` string, date-time, nullable
      - `ends_at` string, date-time, nullable
      - `current_timestamp` integer
      - `next_billing_cycle` string, nullable
    - `plans` SubscriptionPlan[]
      - `plan` string
      - `sport` string
      - `category` string
    - `add_ons` SubscriptionAddOn[]: Add-ons / trialing features for this account. Empty when none are attached.
      - `add_on` string: Add-on name; may include a trial-end suffix like ' - Trialing until 2026-05-31 13:19:52'.
      - `sport` string
      - `category` string: Add-on category (Predictions, Team rankings, Calls, …).
    - `widgets` SubscriptionWidget[]: Widget entitlements for this account. Empty when none are attached.
      - `widget` string: Widget name (e.g. 'Wesley van Rooij Widgets All').
      - `sport` string: Sport scope of the widget (e.g. 'Football').
  - `rate_limit` RateLimit: Rate-limit window metadata returned with every successful response.
    - `resets_in_seconds` integer
    - `remaining` integer
    - `requested_entity` string
  - `timezone` string, required

## Other responses

- `400`: Bad Request. Some part of the request is malformed.
- `401`: Unauthorized. The request is not authenticated (missing or invalid api_token).
- `403`: Forbidden. The endpoint or resource is not accessible from your subscription.
- `404`: Not Found. The endpoint or resource does not exist.
- `422`: Validation Error. Required parameters missing or malformed.
- `429`: Too Many Requests. Hourly request limit exceeded — see RateLimit metadata.
- `500`: Internal Server Error. An internal error has been logged for inspection.

---

[API](https://skmtc.dev/sportmonks/apis/sportmonks-football-api.md) - [All operations](https://skmtc.dev/sportmonks/apis/sportmonks-football-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportmonks/apis/sportmonks-football-api/revisions/c9d56fb26b94?raw)