Skip to main content
GET
/
pairs
List Pairs
curl --request GET \
  --url https://padelapi.org/api/pairs \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "self": "<string>",
      "name": "<string>",
      "category": "<string>",
      "status": "<string>",
      "points": 123,
      "first_match_at": "<string>",
      "last_match_at": "<string>",
      "players": [
        {
          "id": 123,
          "self": "<string>",
          "name": "<string>",
          "short_name": "<string>",
          "url": "<string>",
          "photo_url": "<string>",
          "category": "<string>",
          "nationality": "<string>",
          "ranking": "<string>",
          "points": 123,
          "height": 123,
          "side": "<string>",
          "birthplace": "<string>",
          "birthdate": "<string>",
          "age": "<string>",
          "links": "<string>",
          "updated_at": "<string>",
          "connections": {
            "matches": "<string>",
            "pairs": "<string>",
            "stats": "<string>"
          }
        }
      ],
      "connections": "<string>"
    }
  ],
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  },
  "meta": {
    "current_page": 123,
    "from": 123,
    "last_page": 123,
    "links": [
      {
        "url": "<string>",
        "label": "<string>",
        "active": true
      }
    ],
    "path": "<string>",
    "per_page": 123,
    "to": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

category
enum<string> | null

Category of the pair, either men or women.

Available options:
men,
women
after_date
string<date> | null

Date after which the pair has played a match in YYYY-MM-DD format. Pairs without matches in the range are excluded.

before_date
string<date> | null

Date before which the pair has played a match in YYYY-MM-DD format.

sort_by
enum<string> | null

Name of the parameter to sort the pairs by. Defaults to last_match_at (date of their most recent match together, desc).

Available options:
last_match_at,
first_match_at
page
integer
default:1

Response

Paginated set of PairResource

data
PairResource · object[]
required
meta
object
required