Quickstart

V1 mirrors the API-Football request and response shape, so an existing integration usually only needs its base URL and key header changed.

cURL

curl -H "x-api-key: YOUR_KEY" \
  "https://api.kickoffapi.com/api/v1/fixtures?live=all"

Every response uses the same envelope:

200 OK

{ "get": "fixtures", "results": 146, "response": [ ... ] }

Authentication

Send your key in the x-api-key header on every request. Keys are created and revoked in your dashboard. A missing or disabled key returns 401.

Header

x-api-key: YOUR_KEY

Rate limits & errors

Your plan's request allowance is enforced per key. Exceeding it returns 429; retry after the window resets rather than retrying immediately.

Status	Meaning	What to do
`400`	A required parameter is missing or malformed	Check the endpoint's parameter table below
`401`	Missing, unknown or disabled key	Check the `x-api-key` header
`404`	No such endpoint	Compare the path against this page
`429`	Plan allowance exceeded	Back off and retry after the window
`500`	Something failed on our side	Retry once; if it persists, contact support

GET /api/v1/coachs

Coachs

Parameter	Type	Required
`id`	string	No
`team`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/status

Account status

Your account, current plan and today’s request count. Mirrors the API-Football /status endpoint, so an existing integration can read its quota without changes. firstname and lastname are always null — we do not collect names at signup. On an internal key, limit_day is null (no ceiling).

Parameter	Type	Required	Description
No parameters. The key in your request identifies the account.

EXAMPLE RESPONSE

200 OK

{
  "get": "status",
  "results": 1,
  "response": {
    "account": { "firstname": null, "lastname": null, "email": "[email protected]" },
    "subscription": { "plan": "Pro", "end": "2026-09-07T00:00:00.000Z", "active": true },
    "requests": { "current": 128, "limit_day": 10000 }
  }
}

GET /api/v1/countries

Countries

Parameter	Type	Required
`name`	string	No
`code`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures

Fixtures

Parameter	Type	Required
`id`	string	No
`ids`	string	No
`live`	string	No
`date`	string	No
`league`	string	No
`season`	string	No
`team`	string	No
`last`	string	No
`next`	string	No
`from`	string	No
`to`	string	No
`round`	string	No
`status`	string	No
`venue`	string	No
`timezone`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures/rounds

Fixture rounds

Every round in a league season, in the order they are played — so Regular Season - 10 follows Regular Season - 2 rather than sorting before it. Omit season and the league’s current season is used. Mirrors the API-Football /fixtures/rounds endpoint.

Parameter	Type	Required	Description
`league`	integer	Yes	League id.
`season`	integer	No	Defaults to the league’s current season.
`current`	boolean	No	`true` returns only the round of the most recently played fixture.

EXAMPLE RESPONSE

200 OK

{
  "get": "fixtures/rounds",
  "results": 38,
  "response": [
    "Regular Season - 1",
    "Regular Season - 2",
    "Regular Season - 3"
  ]
}

GET /api/v1/fixtures/events

Events

Parameter	Type	Required
`fixture`	string	Yes
`team`	string	No
`player`	string	No
`type`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures/headtohead

Head To Head

Parameter	Type	Required
`h2h`	string	Yes
`date`	string	No
`league`	string	No
`season`	string	No
`last`	string	No
`next`	string	No
`from`	string	No
`to`	string	No
`status`	string	No
`venue`	string	No
`timezone`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures/lineups

Lineups

Parameter	Type	Required
`fixture`	string	Yes
`team`	string	No
`player`	string	No
`type`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures/players

Players statistics

Parameter	Type	Required	Description
`fixture`	string	Yes
`team`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/fixtures/statistics

Statistics

Parameter	Type	Required
`fixture`	string	Yes
`team`	string	No
`type`	string	No
`half`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/injuries

Injuries

Parameter	Type	Required
`league`	string	No
`season`	string	No
`fixture`	string	No
`team`	string	No
`player`	string	No
`date`	string	No
`ids`	string	No
`timezone`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/leagues

Leagues

Parameter	Type	Required
`id`	string	No
`name`	string	No
`country`	string	No
`code`	string	No
`season`	string	No
`team`	string	No
`type`	string	No
`current`	string	No
`search`	string	No
`last`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/leagues/seasons

Seasons

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/odds

Odds

Parameter	Type	Required
`fixture`	string	No
`league`	string	No
`season`	string	No
`date`	string	No
`timezone`	string	No
`page`	string	No
`bookmaker`	string	No
`bet`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/odds/bets

Bets

Parameter	Type	Required	Description
`id`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/odds/bookmakers

Bookmakers

Parameter	Type	Required	Description
`id`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/odds/live

odds/live

Parameter	Type	Required
`fixture`	string	No
`league`	string	No
`bet`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players

Statistics

Parameter	Type	Required
`id`	string	No
`team`	string	No
`league`	string	No
`season`	string	No
`search`	string	No
`page`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/profiles

Profiles

Parameter	Type	Required
`player`	string	No
`search`	string	No
`page`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/seasons

Seasons

Parameter	Type	Required	Description
`player`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/squads

Squads

Parameter	Type	Required	Description
`team`	string	No
`player`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/teams

Teams

Parameter	Type	Required	Description
`player`	string	Yes

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/topassists

Top Assists

Parameter	Type	Required	Description
`league`	string	Yes
`season`	string	Yes

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/players/topscorers

Top Scorers

Parameter	Type	Required	Description
`league`	string	Yes
`season`	string	Yes

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/predictions

Predictions

Parameter	Type	Required	Description
`fixture`	string	Yes
`fixtureId`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/sidelined

Sidelined

Parameter	Type	Required
`player`	string	No
`players`	string	No
`coach`	string	No
`coachs`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/standings

Standings

Parameter	Type	Required
`league`	string	No
`season`	string	Yes
`team`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/teams

Teams information

Parameter	Type	Required
`id`	string	No
`name`	string	No
`league`	string	No
`season`	string	No
`country`	string	No
`code`	string	No
`venue`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/teams/countries

Teams countries

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/teams/seasons

Teams seasons

Parameter	Type	Required	Description
`team`	string	Yes

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/teams/statistics

Teams statistics

Parameter	Type	Required
`league`	string	Yes
`season`	string	Yes
`team`	string	Yes
`date`	string	No
`teamId`	string	No
`leagueId`	string	No
`year`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/timezone

Timezone

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/transfers

Transfers

Parameter	Type	Required	Description
`player`	string	No
`team`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/trophies

Trophies

Parameter	Type	Required
`player`	string	No
`players`	string	No
`coach`	string	No
`coachs`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

GET /api/v1/venues

Venues

Parameter	Type	Required
`id`	string	No
`name`	string	No
`city`	string	No
`country`	string	No
`search`	string	No

EXAMPLE RESPONSE

200 OK

{
  "response": [
    /* API Response Data */
  ]
}

V1 API Reference

Quickstart

Authentication

Rate limits & errors

Coachs

Account status

Countries

Fixtures

Fixture rounds

Events

Head To Head

Lineups

Players statistics

Statistics

Injuries

Leagues

Seasons

Odds

Bets

Bookmakers

odds/live

Statistics

Profiles

Seasons

Squads

Teams

Top Assists

Top Scorers

Predictions

Sidelined

Standings

Teams information

Teams countries

Teams seasons

Teams statistics

Timezone

Transfers

Trophies

Venues