🎾 Partidos

Partidos asignados.

[GET] /v1/matches

Parámetros de consulta:

Parámetro Tipo Rango Por defecto Descripción
page integer min_numeric: 1 1 Número de la página de resultados de los partidos.
orderBy string contains: [created_at, updated_at] created_at Campo de ordenamiento de los partidos.
sortBy string contains: [asc, desc] desc Modo de ordenamiento de los partidos.
registration_category_id string exact_len: 36 null Identificador de la categoría de inscripción de los partidos (ver).
match_category_id string exact_len: 36 null Identificador de la categoría de las rondas de los partidos (ver).
match_status_id string exact_len: 36 null Identificador del estatus de juego de los partidos (ver).
is_active boolean contains: [yes/no, on/off, 1/0, true/false] null Filtrar los partidos por estatus de actividad.

Ejemplo:

curl -X GET \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: API_KEY' \
  http://localhost:8080/v1/matches?page=2&orderBy=created_at&sortBy=desc&registration_category_id=cba89529-0ba9-49e4-85ad-83e63c8e9d7e&match_category_id=dc19c9bf-4339-4ed2-a603-5b2dd1058a6&match_status_id=29d4b630-468f-4dcc-b775-5bad0b796a89&is_active=true

Respuesta de la petición:

{
  "data": [
    {
      "id": "fd73aa9c-fac8-4761-a6ba-12c674612929",
      "is_active": 1,
      "created_at": "2025-03-18 14:41:31",
      "updated_at": "2025-03-18 14:41:31",
      "registration_category": {
        "id": "76d95a95-0fa3-4d58-a8ce-031a1db25b3c",
        "name": "open",
        "description": "Libre"
      },
      "match_category": {
        "id": "6c7f2686-7b40-47ff-b5b5-cbd52c6cea89",
        "name": "qualifier",
        "description": "Clasificación"
      },
      "match_status": {
        "id": "29d4b630-468f-4dcc-b775-5bad0b796a89",
        "name": "scheduled",
        "description": "Programado"
      }
    },
    {
      "id": "097c1b44-1bed-40fe-b522-ced60e91c185",
      "is_active": 1,
      "created_at": "2025-03-18 14:41:31",
      "updated_at": "2025-03-18 14:41:31",
      "registration_category": {
        "id": "76d95a95-0fa3-4d58-a8ce-031a1db25b3c",
        "name": "open",
        "description": "Libre"
      },
      "match_category": {
        "id": "6c7f2686-7b40-47ff-b5b5-cbd52c6cea89",
        "name": "qualifier",
        "description": "Clasificación"
      },
      "match_status": {
        "id": "29d4b630-468f-4dcc-b775-5bad0b796a89",
        "name": "scheduled",
        "description": "Programado"
      }
    },
    ...
  ],
  "status": 200,
  "pagination": {
    "page": 1,
    "limit": 8,
    "total": 6,
    "count": 48,
    "offset": 0
  },
  "description": "Information about all the matches with pagination"
}