GET All States

Returns all states available within your subscription.

https://api.sportmonks.com/v3/football/states

NameRequired?Description

api_token

YES

Another option is to provide the API token in the header.

Your unique API token. Ex. ?api_token=YOUR_TOKEN

include

NO

Enrich the API response with more data by using includes. Ex. &include=participants;events

select

NO

filters

NO

Filter the API response on multiple related entities. There are static filters and dynamic filters.​ Please find the possibilities in the Static and Dynamic Filter tab.

locale

NO

Filters

https://api.sportmonks.com/v3/my/filters/entity?api_token=YOUR_TOKEN

Pagination

YES

Parameters

ParameterRequiredDescriptionExample

order

No

Returns states ordered by id (asc or desc). Defaults to asc

&order=desc

per_page

No

The amount of results to return per page (max 50.). Defaults to 25.

&per_page=30

page

No

You can paginate using the has_more parameter to determine if you can still propagate through the results.

&page=2

Include depth

You can use a total of 0 nested includes on this endpoint

Include options

none

Get an overview and explanation of all the fields returned in the API response. The related entities for the transfers' endpoints are:

Postman

We also offer detailed postman documentation with examples and a complete up-to-date version of all our endpoints. Below is a button that lets your fork the collection or import it.

Code Example

require "uri"
require "net/http"

url = URI("https://api.sportmonks.com/v3/football/states?api_token=YOUR_TOKEN")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Last updated