Get Start Times
get_start_timesGive trail (required without a partner key). The start times of a trail with the permits left for visitors at each one (as the trail page shows them: a number from 6 up, "few" at 1 to 5, "full" at 0), and a book_url per open start time that opens Reserve on madeira.fun at that time. Today up to 119 days ahead: give trail and date, or from and to (up to 14 days per call). Further ahead, up to 365 days: one trail and one date per call. Start times that have already begun today are never listed. Rate limited; a partner key (Authorization: Bearer mfk_...) gives higher limits, longer ranges and every trail at once (omit trail).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Last day of a range (YYYY-MM-DD, a Madeira calendar date). | |
| date | No | One day (YYYY-MM-DD, a Madeira calendar date). | |
| from | No | First day of a range (YYYY-MM-DD, a Madeira calendar date). | |
| trail | No | The trail: its seo_slug from list_permit_trails (preferred), a code such as "PR 18", "PR18" or "PS PR1", or a name such as "Levada do Rei". Accents are ignored. Required, except for a partner key asking for every trail. |