# Fandango API: Get theater showtimes > Gets a movie theater's films and showtimes on Fandango for a date, from the theater's name and its city or ZIP code. Each film lists its rating, runtime and showtimes grouped by format with ticket links; a date without listed showtimes returns no films. Unofficial. Not affiliated with or endorsed by Fandango. - Page: https://fous.com/methods/fandango.com/get-theater-showtimes - Method: `fandango.com/get_theater_showtimes`, version 1 - Website: fandango.com - Returns: theater name, address, Fandango link, date; movies with title, age rating, runtime, link and showtime groups (format, local time, ISO date-time, ticket link) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | no | `"2026-09-29"` | Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater's time zone. | | `theater` | string | yes | `"AMC Metreon 16"` | The theater name, such as AMC Lincoln Square 13. | | `location` | string | yes | `"San Francisco, CA"` | The city and state or ZIP code, such as New York, NY or 10023. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "date": "2026-09-29", "theater": "AMC Metreon 16", "location": "San Francisco, CA" } ``` Its output: ```json { "date": "2026-09-29", "movies": [ { "title": "Princess Mononoke - Studio Ghibli Fest 2026", "runtime": "2 hr 18 min", "age_rating": "PG", "movie_link": "https://www.fandango.com/princess-mononoke-studio-ghibli-fest-2026-245499/movie-overview", "showtime_groups": [ { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T19:00-07:00", "local_time": "7:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A00&from=mov_det_showtimes&source=desktop&mid=245499&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-451cfb34b1ef8b5a26ba221128a3ae77ced0a30e90fd91c841e77cc632ef3a68" }, { "date_time": "2026-09-29T20:00-07:00", "local_time": "8:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B20%3A00&from=mov_det_showtimes&source=desktop&mid=245499&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-52d07406bcc5d18f34b8e75d51004761144d0b1da860cba366a6bc38f52801ca" } ] } ] }, { "title": "Avengers Endgame: Encore (2026)", "runtime": "3 hr 5 min", "age_rating": "Not Rated", "movie_link": "https://www.fandango.com/avengers-endgame-encore-2026-246870/movie-overview", "showtime_groups": [ { "format": "Premium Format", "showtimes": [ { "date_time": "2026-09-29T14:00-07:00", "local_time": "2:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B14%3A00&from=mov_det_showtimes&source=desktop&mid=246797&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-46d45e7235c56100c90b0343d85d727d4f404f4a29497bfdcc2f1184f8f57aad" }, { "date_time": "2026-09-29T13:00-07:00", "local_time": "1:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B13%3A00&from=mov_det_showtimes&source=desktop&mid=246797&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-f441f4e739e103dce5084b3b91adc9a159ff8475f626ee2f2b76a0189ddb4177" } ] }, { "format": "3D", "showtimes": [ { "date_time": "2026-09-29T15:00-07:00", "local_time": "3:00 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B15%3A00&from=mov_det_showtimes&source=desktop&mid=246871&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-5717ddb4940b1d2ace5d020be02f025d2aa14440ff322f9c3e92effbefd4b470" } ] }, { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T19:15-07:00", "local_time": "7:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A15&from=mov_det_showtimes&source=desktop&mid=246870&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-36be26b723637a9242efa8af0674244b1ab1fa4981cc6b6800f806502efdcdfd" }, { "date_time": "2026-09-29T21:45-07:00", "local_time": "9:45 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B21%3A45&from=mov_det_showtimes&source=desktop&mid=246870&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-c3c575a466ca70109c9ee7c3f221d918473b03f64b8ff209540a7521dc965ea0" } ] } ] }, { "title": "Charlie Harper (2026)", "runtime": "1 hr 42 min", "age_rating": "R", "movie_link": "https://www.fandango.com/charlie-harper-2026-247310/movie-overview", "showtime_groups": [ { "format": "Standard", "showtimes": [ { "date_time": "2026-09-29T13:15-07:00", "local_time": "1:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B13%3A15&from=mov_det_showtimes&source=desktop&mid=247310&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-251583e0d92f41c04c4a2bf2ed1fc0ce33252bbe6d49e034e611402d934afce7" }, { "date_time": "2026-09-29T19:15-07:00", "local_time": "7:15 PM", "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A15&from=mov_det_showtimes&source=desktop&mid=247310&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-1d9bc3bdba8b0d45df25fe7d4038ab3421c22d7a903884e286d2e1b19737a962" } ] } ] } ], "address": "135 4th Street Suite #3000, San Francisco, CA 94103", "theater_name": "AMC Metreon 16", "fandango_link": "https://www.fandango.com/amc-metreon-16-aanem/theater-page" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fandango.com/get_theater_showtimes","input":{"date":"2026-09-29","theater":"AMC Metreon 16","location":"San Francisco, CA"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What's playing at Regal Union Square in New York, NY on 2026-03-14, and what are the showtimes? - Pull Fandango showtimes for Alamo Drafthouse South Lamar, 78704, this Friday 2025-11-07 with ticket links - Showtimes today at AMC Metreon 16 in San Francisco — I want to know which movies are in IMAX and their runtimes - Using fandango.com, list all films and screening times at Cinemark Tinseltown in Pflugerville, TX for December 20, 2025 - Can you check the movie schedule for Harkins Camelview at Fashion Square, Scottsdale AZ, on 2026-01-02? Include ratings and formats like Dolby or 3D. ## Input schema ```json { "type": "object", "required": [ "theater", "location" ], "properties": { "date": { "type": "string", "description": "Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater's time zone." }, "theater": { "type": "string", "description": "The theater name, such as AMC Lincoln Square 13." }, "location": { "type": "string", "description": "The city and state or ZIP code, such as New York, NY or 10023." } } } ``` ## Output schema ```json { "type": "object", "required": [ "theater_name", "address", "fandango_link", "date", "movies" ], "properties": { "date": { "type": "string", "format": "date" }, "movies": { "type": "array", "items": { "type": "object", "required": [ "title", "age_rating", "runtime", "movie_link", "showtime_groups" ], "properties": { "title": { "type": "string" }, "runtime": { "type": [ "string", "null" ], "description": "Runtime as hours and minutes." }, "age_rating": { "type": [ "string", "null" ] }, "movie_link": { "type": [ "string", "null" ] }, "showtime_groups": { "type": "array", "items": { "type": "object", "required": [ "format", "showtimes" ], "properties": { "format": { "type": "string" }, "showtimes": { "type": "array", "items": { "type": "object", "required": [ "local_time", "date_time", "ticket_link" ], "properties": { "date_time": { "type": "string", "description": "Local showtime as ISO 8601 with UTC offset." }, "local_time": { "type": "string", "description": "Local showtime as displayed in 12-hour time." }, "ticket_link": { "type": [ "string", "null" ], "description": "Fandango ticket link, if available." } }, "additionalProperties": false } } }, "additionalProperties": false } } }, "additionalProperties": false } }, "address": { "type": "string" }, "theater_name": { "type": "string" }, "fandango_link": { "type": "string" } }, "additionalProperties": false } ``` ## See more - [Fandango API: Get movie showtimes](https://fous.com/methods/fandango.com/get-movie-showtimes.md): Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links. - [Fandango API: List movies now playing or coming soon](https://fous.com/methods/fandango.com/list-now-playing.md): Lists Fandango movies now playing or coming soon in U.S. theaters, in Fandango's order, with release dates, age ratings, runtimes and Rotten Tomatoes scores when shown. - [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score. - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country. - [Box Office Mojo API: Get daily box office](https://fous.com/methods/boxofficemojo.com/get-daily-box-office.md): Returns the domestic US and Canada daily box office rankings for a date, or the latest reported day when no date is given. - [Ticketmaster API: Search events](https://fous.com/methods/ticketmaster.com/search-events.md): Finds upcoming Ticketmaster-listed concerts, sports, theater and other events by keyword, optionally by city, country, category and date range, with dates, venues, prices when shown and links. Partner-only listings without a Ticketmaster link are excluded; very large searches cover only the first 800 listings. - [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone. - [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks. - [All Fandango methods](https://fous.com/methods/fandango.com.md)