Skip to content
datasportsAPI

No. 07 · Court & net · Fixture sport

HandballTwo halves, every goal in order.

Club and national-team handball: live scores by half, events, lineups and full standings.

07Court & net
Handball11 endpoints · fixtures

Scouting report

What you get for Handball

Handball scores come split by half, with the incidents in order (goals, converted seven-metre throws, two-minute suspensions and cards) and both lineups for covered competitions.

League tables include every group the competition runs, and the best-players endpoint ranks each side's standouts by goals scored.

First request

Every handball match in play, one call.

The live board filtered to handball: each match with its score, status and clock. The same request in four forms; pick yours.

  1. 1Create a key in the dashboard. Free gives you 1,000 requests a day during the beta.
  2. 2Put it in DATASPORTSAPI_API_KEY so the SDKs and the dsa command find it.
  3. 3Call /v2/livescores?sport=handball.
curl -H "Authorization: Bearer dsa_live_…" \
  "https://api.datasportsapi.com/v2/livescores?sport=handball"

The catalog

Handball, endpoint by endpoint

Its own detail first, then the shared spine every fixture sport answers on. Each row opens the endpoint’s reference page.

All 116 endpoints

Where handball goes deeper

1 endpoint with detail specific to the sport.

The shared spine

10 endpoints that behave the same for every fixture sport.

  1. GETLive scores/v2/livescoresReturns every live fixture across all sports, or a single sport’s in-play board when ?sport= is given.All plans
  2. GETFixtures by date/v2/fixturesLists the fixtures that start on a given UTC date.All plans
  3. GETFixture/v2/fixtures/{id}Everything we hold on one fixture.All plans
  4. GETEvents/v2/fixtures/{id}/eventsThe match’s incidents in chronological order, oldest first: goals, cards, substitutions, period markers and added-time announcements.All plans
  5. GETStatistics/v2/fixtures/{id}/statisticsTeam statistics for the match, organised by period and by category.All plans
  6. GETHead to head/v2/fixtures/{id}/h2hThe two teams’ head-to-head record as tallied by the source, seen from this fixture’s home / away point of view.All plans
  7. GETStandings/v2/leagues/{id}/standingsLeague tables for a single season.All plans
  8. GETTeam/v2/teams/{id}Returns a team’s profile — sport, country, venue, colours, logo, gender, whether it is a club or a national team, kind (team / individual / pair), manager and founding date (foundedOn, pres…All plans
  9. GETLeague/v2/leagues/{id}Returns a league’s profile: its tier (where it sits in the national pyramid), gender, the reigning champion with its title count, the clubs holding the most titles, the divisions directly a…All plans
  10. GETSearch/v2/searchA single search over teams (individual competitors included), players, managers, referees, leagues, fixtures, venues, racing series and races.All plans

What comes back

Lineups, as served

The documented sample is a football lineup. Handball fills the same fields (players, positions, match statistics) for covered leagues.

GET/v2/fixtures/{id}/lineupsAll plans

Sample from the docs, trimmed with …

GET /v2/fixtures/{id}/lineups
{ "data": { "confirmed": true,
    "home": { "formation": "4-2-3-1", "players": [
      { "player": { "id": 3772, "name": "David Raya", "slug": "david-raya", "shortName": "D. Raya", "image": "…" },
        "position": "goalkeeper", "positionCode": "G", "jerseyNumber": "1", "substitute": false, "captain": false,
        "heightCm": 187, "dateOfBirth": "1995-09-15", "country": { "code": "ES", "name": "Spain", "flag": "…" },
        "marketValue": { "amount": 25000000, "currency": "EUR" },
        "rating": 7.1, "avgRating": 6.94, "ratingVersions": { "original": 7.1, "alternative": 7.3 }, "star": null, "battingOrder": null,
        "statistics": { "minutesPlayed": 90, "passes": 34, "accuratePasses": 29, "saves": 2, "touches": 41, … } }, … ],
      "missing": [ { "player": { … }, "availability": "out", "reason": "injury", "description": "Knee Injury",
                     "expectedReturnAt": "2026-11-02T00:00:00.000Z" } ] },
    "away": { … } } }

Handball is one query string away.

Swap ?sport=handball for any other fixture sport and the same code keeps working. Free key, no card.