// Handball API quick start

Every call goes to https://api.handballapi.com/v1/... with your key in a header.

curl -H "Authorization: Bearer YOUR_KEY" https://api.handballapi.com/v1/results/yesterday

Every answer has the same two parts: data (a list or one object) and meta (counts, paging and timing).

{"data": [{"id": "mt_8kq2v7xd", "date_utc": "2026-10-06T18:00:00Z", "status": "finished",
  "competition": {"id": "cp_3m9t1bra", "name": "Liga NLB", "country": "si", "season": "2026/27"},
  "home": {"team_id": "tm_5h2c8wqe", "name": "RK Celje", "goals": 31, "ht": 15},
  "away": {"team_id": "tm_0d7r4kna", "name": "RD Riko Ribnica", "goals": 27, "ht": 13}}],
 "meta": {"count": 1, "next_cursor": null, "page": 1, "per_page": 100, "total": 1, "total_pages": 1,
  "next_page": null, "prev_page": null, "date": "2026-10-06", "took_ms": 6}}

The ids above are examples of the shape. Take a real match id from any list and ask for the match itself, or its player lines:

curl -H "Authorization: Bearer YOUR_KEY" https://api.handballapi.com/v1/matches/mt_8kq2v7xd
curl -H "Authorization: Bearer YOUR_KEY" https://api.handballapi.com/v1/matches/mt_8kq2v7xd/players