OSMCAL API (2.2)

Download OpenAPI specification:Download

Events

Retrieve list of upcoming events

query Parameters

in	string Example: in=de Limit returned events to a given country. The country should be specified as ISO 3166-1 alpha-2 code.

header Parameters

Accept-Language	string Example: pt-BR The user's locale. This will cause human-readable dates to be localized.
Client-App	string Example: osmcal-widget/1.0.0 Please send some kind of identification of your app, so we can find out easier who you are, if need be.

Responses

Response samples

200

Content type

application/json

[{"name": "Mapping Party #23",
"url": "https://osmcal.org/event/23/",
"date": {"start": "2020-05-24T12:00:00+09:00",
"end": "2020-05-24T14:00:00+09:00",
"human": "24th May 12:00–14:00",
"human_short": "24th May",
"whole_day": false
},
"location": {"short": "Osaka, Japan",
"detailed": "Tosabori-dori, Chuo, Osaka, Japan",
"coords": [135.5023,
34.6931
],
"venue": "Cool Pub"
},
"cancelled": true
}
]

Retrieve list of past events

query Parameters

in	string Example: in=de Limit returned events to a given country. The country should be specified as ISO 3166-1 alpha-2 code.

header Parameters

Accept-Language	string Example: pt-BR The user's locale. This will cause human-readable dates to be localized.
Client-App	string Example: osmcal-widget/1.0.0 Please send some kind of identification of your app, so we can find out easier who you are, if need be.

Responses

Response samples

200

Content type

application/json

[{"name": "Mapping Party #23",
"url": "https://osmcal.org/event/23/",
"date": {"start": "2020-05-24T12:00:00+09:00",
"end": "2020-05-24T14:00:00+09:00",
"human": "24th May 12:00–14:00",
"human_short": "24th May",
"whole_day": false
},
"location": {"short": "Osaka, Japan",
"detailed": "Tosabori-dori, Chuo, Osaka, Japan",
"coords": [135.5023,
34.6931
],
"venue": "Cool Pub"
},
"cancelled": true
}
]

Retrieve list of upcoming events Deprecated

Retrieve list of upcoming events

query Parameters

in	string Example: in=Germany Limit returned events to a given country

Responses

Response samples

200

Content type

application/json

[{"name": "Mapping Party #23",
"url": "https://osmcal.org/event/23/",
"date": {"start": "2020-05-24 12:00:00",
"end": "2020-05-24 14:00:00",
"human": "24th May 12:00–14:00",
"whole_day": false
},
"location": {"short": "Osaka, Japan",
"detailed": "Tosabori-dori, Chuo, Osaka, Japan",
"coords": [135.5023,
34.6931
],
"venue": "Cool Pub"
},
"cancelled": true
}
]

Retrieve list of past events Deprecated

Retrieve list of past events

query Parameters

in	string Example: in=Germany Limit returned events to a given country

Responses

Response samples

200

Content type

application/json

[{"name": "Mapping Party #23",
"url": "https://osmcal.org/event/23/",
"date": {"start": "2020-05-24 12:00:00",
"end": "2020-05-24 14:00:00",
"human": "24th May 12:00–14:00",
"whole_day": false
},
"location": {"short": "Osaka, Japan",
"detailed": "Tosabori-dori, Chuo, Osaka, Japan",
"coords": [135.5023,
34.6931
],
"venue": "Cool Pub"
},
"cancelled": true
}
]