API Documentation (2.0.7)

Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Mock server

https://docs.goalise.com/_mock/apireference/openapi/

Goalise API Server

https://api.goalise.com/api/v2/

Countries

Countries

Operations

Leagues

Leagues

Operations

Matches

Matches

Operations

Teams

Teams

Operations

Players

Players

Operations

Transfers

Transfers

Operations

Venues

Venues

Operations

Predictions

Predictions

Operations

News

News

Operations

Get news categories

Request

Security
bearerAuth
curl -i -X GET \
  https://docs.goalise.com/_mock/apireference/openapi/news-categories \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news categories

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination info if applicable

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {},
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by category

Request

Returns a paginated list of news by category id

Security
bearerAuth
Query
idintegerrequired

Filter by category ID

Example: id=3
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-category?id=3&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination details for paginated responses

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by league

Request

Returns a paginated list of news by league id

Security
bearerAuth
Query
idintegerrequired

Filter by league ID

Example: id=618
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-league?id=618&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination details for paginated responses

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by team

Request

Returns a paginated list of news by team id

Security
bearerAuth
Query
idintegerrequired

Filter by team ID

Example: id=69
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-team?id=69&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination details for paginated responses

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Get news by date

Request

Returns a paginated list of news by date

Security
bearerAuth
Query
datestringrequired

Date (format: Y-m-d)

Example: date=2025-03-01
pageinteger

Page number

Example: page=1
curl -i -X GET \
  'https://docs.goalise.com/_mock/apireference/openapi/news-by-date?date=2025-03-01&page=1' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List of news

Bodyapplication/json
statusstring
Example: "success"
paginationobject or null

Pagination details for paginated responses

errorsobject or null
Example: null
responseArray of objects or null
Response
application/json
{
  "status": "success",
  "pagination": {
    "total_count": 10,
    "page_size": 10,
    "page_count": 1,
    "current_page": 1
  },
  "errors": null,
  "response": [
    { … }
  ]
}

Odds

Odds

Operations