example-data.com
Menu
Browse docs and collections

matchmaking

matchmaking

Page 2 of 21.

Overview

Request

curl example

curl -sS \
  "https://example-data.com/api/v1/matchmaking?limit=25"

JavaScript example

const res = await fetch(
  "https://example-data.com/api/v1/matchmaking?limit=25"
);
const { data, meta } = await res.json();

TypeScript example

// Download once: mkdir -p types && curl -o types/matchmaking.d.ts https://example-data.com/types/matchmaking.d.ts
import type { Matchmaking, ListEnvelope } from "./types/matchmaking";

const res = await fetch(
  "https://example-data.com/api/v1/matchmaking?limit=25"
);
const { data, meta } = (await res.json()) as ListEnvelope<Matchmaking>;

Python example

import requests

res = requests.get(
    "https://example-data.com/api/v1/matchmaking",
    params={"limit": 25},
)
data = res.json()

Response

{
  "data": [
    {
      "id": 25,
      "userId": 50,
      "candidateUserId": 17,
      "matchScorePercent": 73,
      "commonInterests": [
        "Languages",
        "Yoga"
      ],
      "status": "matched",
      "createdAt": "2026-03-08T16:54:15.780Z"
    },
    {
      "id": 26,
      "userId": 158,
      "candidateUserId": 113,
      "matchScorePercent": 73,
      "commonInterests": [
        "Fitness",
        "Languages",
        "Photography",
        "Movies"
      ],
      "status": "pending",
      "createdAt": "2025-08-17T13:13:07.336Z"
    },
    {
      "id": 27,
      "userId": 19,
      "candidateUserId": 126,
      "matchScorePercent": 45,
      "commonInterests": [
        "Yoga"
      ],
      "status": "liked",
      "createdAt": "2026-05-05T11:17:42.077Z"
    }
  ],
  "meta": {
    "page": 2,
    "limit": 24,
    "total": 500,
    "totalPages": 21
  },
  "links": {
    "self": "/api/v1/matchmaking?page=2&limit=24",
    "first": "/api/v1/matchmaking?page=1&limit=24",
    "last": "/api/v1/matchmaking?page=21&limit=24",
    "next": "/api/v1/matchmaking?page=3&limit=24",
    "prev": "/api/v1/matchmaking?page=1&limit=24"
  }
}