Getting List Of Federations

We use federations to categorize international tournaments like FIFA World Cup and UEFA Champions League. Here we example how our football API works when it comes to federations.


Endpoint:

In our football api there are 2 types of owners of teams and competitions: one of them is countries for which you can read in their documentation page and the other one is federations for which you can read in this page. It is very simple to get the list of all federations in our api. All you need to do is call the URL bellow. The football federations API endpoint is very simple and does not have any additional parameters or filters. In this example, we have used the demo api key and secret pair. If you login in, you will see all examples with your own api key and api secret.

GET:

Response:

The response contains the following information, for every federation element in the list. The same rules apply for the JSON, XML objects and the CSV columns. In the table bellow we explain the response data and following is an example JSON response.

NameTypeExampleDescription
idnumber2the id of the federation which you can use as filters in other sequential requests.
namestringUEFAthe name of the federation.

{
    "success": true,
    "data": {
        "federation": [
            {
                "id": "4",
                "name": "AFC"
            },
            {
                "id": "3",
                "name": "CAF"
            },
            {
                "id": "5",
                "name": "CONCACAF"
            }
        ]
    }
}

Latest Federations:

In the table bellow, we are showing the latest federations that our football api supports with their IDs so you can use them directly without the need of calling the API. Although, we try to keep our documentation up to date, we might forget to update this table to the latest, so you can always consult the API as it is going to give you the actual information.

IdShort NameLong Name
1FIFAFédération Internationale de Football Association
2UEFAUnion of European Football Associations
3CAFConfédération Africaine de Football
4AFCAsian Football Confederation
5CONCACAFConfederation of North, Central American and Caribbean Association Football
6CONMEBOLConfederación Sudamericana de Fútbol
7OFCOceania Football Confederation
8IOCInternational Olympic Committee