/zones

GET /zones

This request returns a list of zones.

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

Request example

GET /v2/zones HTTP/1.1
Host: api.lionsclubs.ch

Response example

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

[
    {
        "id": 1,
        "name": "Zone Name #1",
        "...": "...",
        "clubs": [
            {
                "id": 1,
                "name": "Club Name #1",
                "...": "..."
            }
        ]
    },
    {
        "id": 2,
        "name": "Zone Name #2",
        "...": "...",
        "clubs": [
            {
                "id": 6,
                "name": "Club Name #6",
                "...": "..."
            }
        ]
    }
]

GET /zones/id

This request returns the zone with a given identifier.

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

Request example

GET /v2/zones/id HTTP/1.1
Host: api.lionsclubs.ch

Response example

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{
    "id": id,
    "name": "Zone Name",
    "...": "...",
    "clubs": [
        {
            "id": 1,
            "name": "Club Name #1",
            "...": "..."
        }
    ]
}

GET /zones/id/committee restricted

This request returns the committee of the zone with the given identifier.

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

Request example

GET /v2/zones/id/committee HTTP/1.1
Host: api.lionsclubs.ch
X-Authorization: access-token
Optional parameters
Name Type Description
locale string de, fr, ... to get localized function names. Defaults to English.
year int Lions Year of the committee. Bound to range 1917 – 2023. Defaults to current Lions Year.

Response example

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{
    "success": true,
    "groups": [
        {
            "name": "Executive board",
            "members": [
                {
                    "function": "Zone President",
                    "id": 7,
                    "firstName": "John",
                    "middleName": "",
                    "lastName": "Doo",
                    "fullName": "John Doo",
                    "active": true,
                    "photo": "",
                    "club": 123
                },
                {
                    "...": "..."
                }
            ]
        }
    ]
}