Interactive API Documentation

OAuth 2.0 Flow: Select OAuth 2.0 Flow

Existing Client Credentials: Manual Input

API Key:

App/Key: Select Application Key Manually provide key information

Shared Secret:

Client ID:

Client Secret: Authorize

Client ID: Get Access Token

Client ID:

Client Secret:

---

Username:

Password: Get Access Token

Client ID:

Client Secret: Get Access Token

Authorization Code: Get Access Token

Access Token:

Username:

Password:

Username:

Binary Security Token:

Username:

Password:

• backstage v1

  • List Methods
  • Expand Methods

  • GET exampleMethod /reviews/reviews

    Mobile Main

    Parameter	Value	Type	Description
    ids		string	Movie Ids

  • GET example2Method /movieclips/mobile/main

    Mobile Main

    Parameter	Value	Type	Description
    ids		string	Movie Ids

• backstage ssl

  • List Methods
  • Expand Methods

  • GET ReviewList /reviews/reviews

    Reviews List

    Parameter	Value	Type	Description
    ids		string	Movie Ids

  • GET Mobile Main /movieclips/mobile/main

    Mobile Main - used by movie clips mobile apps

    Parameter	Value	Type	Description
    ids		string	Movie Ids

  • GET Review /reviews/reviews/185792

    Reviews

    Parameter	Value	Type	Description
    ids		string	Movie Ids

  • GET Movie-Reviews /v1/movies/:movie-id/reviews

    Get Movie review information

    Parameter	Value	Type	Description
    :movie-id		string	Movie Ids

• dataviz v1

  • List Methods
  • Expand Methods

  • GET dataviz

    Parameter	Value	Type	Description
    count		int
    dvm		string
    where		string
    when		string

• Theater Methods

  • List Methods
  • Expand Methods

  • GET Theaters by Postal Code Search

    This operation returns an ordered list of theaters that are playing near the postal code specified.

    Parameter	Value	Type	Description
    op	theatersbypostalcodesearch	string	To invoke this operation, this must always be set to the requested operation
    postalcode		string	The postal code to search against. This can either be a U.S. postal code or a Canadian postal code.
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'. If this parameter is not supplied then the country is derived from the postal code.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

  • GET Theaters by City/State Search

    This operation returns an ordered list of theaters that are playing near the city/state specified.

    Parameter	Value	Type	Description
    op	theatersbycitystatesearch	string	To invoke this operation, this must always be set to the requested operation
    city		string	The city to search against. This value should be URL encoded to accommodate any punctuation.
    state		string	The state or province to search against. This value can be the two-letter state or province abbreviation or the complete spelling of the state or province.
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'. If this parameter is not supplied then the country is derived from the postal code.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

  • GET Theaters by Lat/Lon Search

    This operation returns an ordered list of theaters that are playing within the latitude/longitude/radius specified.

    Parameter	Value	Type	Description
    op	theatersbylatlonsearch	string	To invoke this operation, this must always be set to the requested operation
    lat		float	The latitude coordinate in floating point notation
    lon		float	The longitude coordinate in floating point notation
    radius		int	The search radius (in miles). The value must be greater than 0 and less than or equal to 250.
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    gzip		bool	Set to true to indicate that the response should be gzip compressed.

  • GET Theaters by Movie Postal Code Search

    This operation returns an ordered list of theaters that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	theatersbymoviepostalcodesearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    postalcode		string	The postal code to search against. This can either be a U.S. postal code or a Canadian postal code.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    date		string	The date by which to restrict the search.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.

  • GET Theaters by Movie City/State Search

    This operation returns an ordered list of theaters that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	theatersbymoviecitystatesearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    city		string	The city to search against. This value should be URL encoded to accommodate any punctuation.
    state		string	The state or province to search against. This value can be the two-letter state or province abbreviation or the complete spelling of the state or province.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    date		string	The date by which to restrict the search.
    istms		string	Set to true if the movie id parameter is being passed as a TMS ID. If this is not supplied, then the movieid is assumed to be a Fandango movie id.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.

  • GET Theaters by Movie Lat/Lon Search

    This operation returns an ordered list of theaters that are playing a specific movie near the lat/lon/radius specified.

    Parameter	Value	Type	Description
    op	theatersbymovielatlonsearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    lat		float	The latitude coordinate in floating point notation
    lon		float	The longitude coordinate in floating point notation
    radius		int	The search radius (in miles). The value must be greater than 0 and less than or equal to 250.
    date		string	The date by which to restrict the search. The format for the date is: MM-DD-YYYY [MM is nthe 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    iswired		string	Set to 'true' if the result should only contain wired theaters.
    istms		string	Set to true if the movie id parameter is being passed as a TMS ID. If this is not supplied, then the movieid is assumed to be a Fandango movie id.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

• Movie Methods

  • List Methods
  • Expand Methods

  • GET Movies by Postal Code Search

    This operation returns an ordered list of movies that are playing near the postal code specified.

    Parameter	Value	Type	Description
    op	moviesbypostalcodesearch	string	To invoke this operation, this must always be set to the requested operation
    postalcode		string	The postal code to search against. This can either be a U.S. postal code or a Canadian postal code.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of movie detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    genre		string	The genre by which to filter the results.
    rating		string	The rating by which to filter the results.
    startletter		string	The rating by which to filter the results.
    cast		int	The number of cast members to retrieve (default is 3 at verbosity level 4, and 5 at verbosity levels 1, 2, and 3.)
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Movies by City/State Search

    This operation returns an ordered list of movies that are playing near the city/state specified.

    Parameter	Value	Type	Description
    op	moviesbycitystatesearch	string	To invoke this operation, this must always be set to the requested operation
    city		string	The city to search against. This value should be URL encoded to accommodate any punctuation.
    state		string	The state or province to search against. This value can be the two-letter state or province abbreviation or the complete spelling of the state or province.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of movie detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    genre		string	The genre by which to filter the results.
    rating		string	The rating by which to filter the results.
    startletter		string	The rating by which to filter the results.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Movies by Lat/Lon Search

    This operation returns an ordered list of movies that are playing within the latitude/longitude/radius specified.

    Parameter	Value	Type	Description
    op	moviesbylatlonsearch	string	To invoke this operation, this must always be set to the requested operation
    lat		float	The latitude coordinate in floating point notation
    lon		float	The longitude coordinate in floating point notation
    radius		int	The search radius (in miles). The value must be greater than 0 and less than or equal to 250.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of movie detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    genre		string	The genre by which to filter the results.
    rating		string	The rating by which to filter the results.
    startletter		string	The rating by which to filter the results.
    cast		int	The number of cast members to retrieve (default is 3 at verbosity level 4, and 5 at verbosity levels 1, 2, and 3.)
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

• Showtime Methods

  • List Methods
  • Expand Methods

  • GET Performances by Movie Postal Code Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbymoviepostalcodesearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    postalcode		string	The postal code to search against. This can either be a U.S. postal code or a Canadian postal code.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    showdaterange		bool	Set to true to get the first and last available showdate for this search. Default is false.
    metacriticlevel		int	Indicates the amount of metacritic detail to return. The valid values for this operation are: 1 - minimum detail, 2 - medium detail, 3 - heavy detail. If an invalid value is passed or if this parameter is not set then no metacritic data is returned.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Movie City/State Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbymoviecitystatesearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    city		string	The city to search against. This value should be URL encoded to accommodate any punctuation.
    state		string	The state or province to search against. This value can be the two-letter state or province abbreviation or the complete spelling of the state or province.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    showdaterange		bool	Set to true to get the first and last available showdate for this search. Default is false.
    metacriticlevel		int	Indicates the amount of metacritic detail to return. The valid values for this operation are: 1 - minimum detail, 2 - medium detail, 3 - heavy detail. If an invalid value is passed or if this parameter is not set then no metacritic data is returned.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Movie Lat/Lon Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbymovielatlonsearch	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie id for the movie to search. Or, if the tmsid parameter is set to 'true', the TMS id for the movie to search
    lat		float	The latitude coordinate in floating point notation
    lon		float	The longitude coordinate in floating point notation
    radius		int	The search radius (in miles). The value must be greater than 0 and less than or equal to 250.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    showdaterange		bool	Set to true to get the first and last available showdate for this search. Default is false.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Postal Code Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbypostalcodesearch	string	To invoke this operation, this must always be set to the requested operation
    postalcode		string	The postal code to search against. This can either be a U.S. postal code or a Canadian postal code.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by City/State Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbycitystatesearch	string	To invoke this operation, this must always be set to the requested operation
    city		string	The city to search against. This value should be URL encoded to accommodate any punctuation.
    state		string	The state or province to search against. This value can be the two-letter state or province abbreviation or the complete spelling of the state or province.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    country		string	The two-letter ISO country code with which this postal code is associated. For U.S., this would be the string 'us'. For Canada, this would be 'ca'.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Lat/Lon Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbylatlonsearch	string	To invoke this operation, this must always be set to the requested operation
    lat		float	The latitude coordinate in floating point notation
    lon		float	The longitude coordinate in floating point notation
    radius		int	The search radius (in miles). The value must be greater than 0 and less than or equal to 250.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Theater Search

    This operation returns an ordered list of theaters and their performances that are playing a specific movie near the postal code specified.

    Parameter	Value	Type	Description
    op	performancesbytheatersearch	string	To invoke this operation, this must always be set to the requested operation
    theaterid		string	The Fandango ID of the theater whose showtimes to retrieve. If the istms attribute has a value of "true" then the theater id is considered the TMS ID of the theater.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    istms		bool	Set to 'true' if the movie id parameter is being passed as a TMS ID.
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    showdaterange		bool	Set to true to get the first and last available showdate for this search. Default is false.
    metacriticlevel		int	Indicates the amount of metacritic detail to return. The valid values for this operation are: 1 - minimum detail, 2 - medium detail, 3 - heavy detail. If an invalid value is passed or if this parameter is not set then no metacritic data is returned.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Performances by Theater List

    This operation returns a list of performances for a list of theaters.

    Parameter	Value	Type	Description
    op	performancesbytheaterlist	string	To invoke this operation, this must always be set to the requested operation
    theaterids		string	The TMS ID of the theater whose showtimes to retrieve. Note, only TMS IDs are supported with this call. Separate multiple theater IDs with commas.
    date		date	The date by which to restrict the search.By default, the current date is used and is computed by using the time zone of the postal code that is being searched against. The format for the date is: MM-DD-YYYY [MM is the 2-digit month number (01 – 12), DD is the 2-digit day number (01 – 31), YYYY is the 4-digit year (e.g. 2012)]
    pagesize		int	The number of results to return. This can be any positive integer. If a number less than or equal to 0, or a non-number is passed, or if this is not supplied, then all results will be returned.
    page		int	The page number of results to return. This can be any integer greater than or equal to 0. If this parameter is not supplied then the first page of results is returned by default.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    showdaterange		bool	Set to true to get the first and last available showdate for this search. Default is false.
    metacriticlevel		int	Indicates the amount of metacritic detail to return. The valid values for this operation are: 1 - minimum detail, 2 - medium detail, 3 - heavy detail. If an invalid value is passed or if this parameter is not set then no metacritic data is returned.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.

  • GET Amenity Lookup

    This method returns a list of all amenities in the Fandango system that may be returned with responses from any of the showtime methods.
    Partners can use this method to improve performance of their application by retrieving and caching all available showtime amenities and then use the amenity ID returned in the showtime method responses to determine the amenity information to display.

    Parameter	Value	Type	Description
    op	amenitylookup	string	To invoke this operation, this must always be set to the requested operation

• Editorial Methods

  • List Methods
  • Expand Methods

  • GET Editorial List Lookup

    The content that Fandango presents on its web site such as "Movies Opening this Week" and "Behind the Screens Commentary" are examples of editorial content that is created by Fandango. This content is useful for partners that want to supplement their existing user interfaces with Fandango exclusive content.

    Parameter	Value	Type	Description
    op	editoriallookupbylistname	string	To invoke this operation, this must always be set to the requested operation
    listname	ComingSoon NowPlaying OpeningThisWeek FanBuzz FandangoFive MostPopularPeople	string	The name of the list to retrieve.
    verbosity		int	Indicates the amount of theater detail to return in the response. The valid values for this operation are: '0' – (default) minimum verbosity, '1' – medium verbosity, or '2' – maximum verbosity. If an invalid value is passed or if this parameter is not set, then verbosity is assumed to be 0.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

• City Search Method

  • List Methods
  • Expand Methods

  • GET City Search

    The City Search operation returns a list of cities that are similar to the given city string. Partners use this operation to display a list of cities from which a user can select a specific city to proceed with another operation.

    Parameter	Value	Type	Description
    op	citysearch	string	To invoke this operation, this must always be set to the requested operation
    city		string	The city string to search against. This value should be URL encoded to accommodate any punctuation.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

• Video Lookup Method

  • List Methods
  • Expand Methods

  • GET Video Lookup

    The Video Lookup operation returns the playlist URL for a video or all videos related to a movie.

    Parameter	Value	Type	Description
    op	videolookup	string	To invoke this operation, this must always be set to the requested operation
    movieid		int	The Fandango movie ID for the movie to search. Or, if the istms parameter is set to “true”, the TMS id for the movie to search.
    sourceid		int	The source id for the video to search. (Required if requesting a single video for a movie.)
    providerid		int	The provider id for the video to search. (Required if requesting a single video for a movie.)
    datarate		int	The datarate of the videos to retrieve. The default datarate is 750.
    istms		bool	Set to true if the movie id parameter is being passed as a TMS ID. If this is not supplied, then the movieid is assumed to be a Fandango movie id.
    verbosity		int	The amount of movie detail to return. A higher value returns more movie information. Valid values: 0 to 3.
    echo		bool	Set to 'true' if the request parameters should be echoed as part of the response.
    assert		string	Set to 'true' to have FRDI test your request without actually executing it.

• Content Search Method

  • List Methods
  • Expand Methods

  • GET Content Search

    The content search operation will search through different repositories of data to find movies, people, and theaters based on text

    Parameter	Value	Type	Description
    op	contentsearch	string	To invoke this operation, this must always be set to the requested operation
    repos	all movies people theaters	string	The type of repository to search
    q		string	The text to search against

• autocomplete v2

  • List Methods
  • Expand Methods

  • GET list autocomplete v2 /autocomplete/v2

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    searchText		string
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	Zip code of the user's location
    limit		number	Number of items to return

• geolocation v2 countries states cities

  • List Methods
  • Expand Methods

  • GET getCity /geolocation/v2/countries/{country}/states/{state}/cities/{city}

    Parameter	Value	Type	Description
    {country}		string	2-Letter country code
    {state}		string	State code
    {city}		string	Name of city

• geolocation v2 countries postalcodes

  • List Methods
  • Expand Methods

  • GET getPostalCode /geolocation/v2/countries/{country}/postalcodes/{postalcode}

    Parameter	Value	Type	Description
    {country}		string
    {postalcode}		string

• movies v2

  • List Methods
  • Expand Methods

  • GET list movies v2 /movies/v2

    Parameter	Value	Type	Description
    type		string	movie type
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	Zip code of the user's location
    radius		number	Search radius in miles around the user's location
    limit		integer	Number of items to return. Used in pagination.
    offset		integer	Offset index of the first item to return. Used in pagination.

  • GET get movies v2 /movies/v2/{movieId}

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    {movieId}		string	The ID of the movie

• movies v2 display-dates

  • List Methods
  • Expand Methods

  • GET list movies v2 display-dates /movies/v2/{movieId}/display-dates

    Parameter	Value	Type	Description
    {movieId}		string	Movie ID
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	Zip code of the user's location
    radius		number	Search radius in miles around the user's location
    startDateTime		string	Start datetime (ISO-8601) for the display date range. Defaults to UTC now.
    endDateTime		string	End datetime (ISO-8601) for the display date range. Defaults to no end datetime.

• movies v2 showtime-groupings

  • List Methods
  • Expand Methods

  • GET getMovieShowtimeGroupings /movies/v2/{movieId}/showtime-groupings

    Parameter	Value	Type	Description
    {movieId}		string	Movie Id
    startDisplayDate		string
    endDisplayDate		string	End display date. Defaults to start display date.
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	Zip code of the user's location
    radius		number	Search radius in miles around the user's location

• showtimes v2

  • List Methods
  • Expand Methods

  • GET list showtimes v2 /showtimes/v2

    Parameter	Value	Type	Description
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	Zip code of the user's location
    radius		number	Search radius in miles around the user's location
    startDateTime		string	Start datetime (ISO-8601) for the showtime datetime range
    endDateTime		string	End datetime (ISO-8601) for the showtime datetime range. Defaults to the end of the day from the startDateTime value
    movieTitle		string	Filter showtimes by movie title
    theaterName		string	Filter showtimes by theater name
    offset		integer	Offset index of the first item to return. Used in pagination.
    limit		integer	Number of items to return. Used in pagination.

• theaters v2

  • List Methods
  • Expand Methods

  • GET list theaters v2 /theaters/v2

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    latitude		number	Latitude of the user's location
    longitude		number	Longitude of the user's location
    zipCode		string	zipCode
    radius		number	Search radius in miles around the user's location
    isTicketing		string	Filter by ticketing or non-ticketing theaters
    limit		integer	Number of items to return. Used in pagination.
    offset		integer	Offset index of the first item to return. Used in pagination.

  • GET get theaters v2 /theaters/v2/{theaterId}

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    {theaterId}		string	The ID of the theater

• theaters v2 display-dates

  • List Methods
  • Expand Methods

  • GET list theaters v2 display-dates /theaters/v2/{theaterId}/display-dates

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    {theaterId}		string	The ID of the theater
    startDateTime		string	Start datetime (ISO-8601) for the display date range. Defaults to UTC now.
    endDateTime		string	End datetime (ISO-8601) for the display date range. Defaults to no end datetime.

• theaters v2 showtime-groupings

  • List Methods
  • Expand Methods

  • GET list theaters v2 showtime-groupings /theaters/v2/{theaterId}/showtime-groupings

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    {theaterId}		string	The ID of the theater
    startDisplayDate		string	Start display date for the showtime date range.
    endDisplayDate		string	End display date for the showtime date range. Defaults to start display date.

• Ticketing Methods

  • List Methods
  • Expand Methods

  • POST Purchase theaters/FANDB/movies/85888/showtimes/2016-07-28T10:20:00/transactions

    used to test a purchase call

    Parameter	Value	Type	Description
    email		string
    payments		array

  • GET Showtime theaters/FANDB/movies/161416/showtimes/2016-07-20T11:50:00
  • GET TicketSelection
  • GET UserError

• backstage ssl

  • List Methods
  • Expand Methods

  • GET Availability /showtimes/v1/showtimeId/seat-map/availability/

    Reviews List

    Parameter	Value	Type	Description
    showtimeId		string	Showtime Id

• offers

  • List Methods
  • Expand Methods

  • POST offers

    Parameter	Value	Type	Description
    TargetLocation		string

• reason-codes v1

  • List Methods
  • Expand Methods

  • GET reasoncodes /reason-codes/v1

    Get list of reasons for return

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload

• transactions v1 refund

  • List Methods
  • Expand Methods

  • POST create transactions v1 refund /transactions/v1/{transactionId}/refund

    Refund a transaction

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    {transactionId}		string	Pass a value for looking up transaction

    Request Body

• transactions v1

  • List Methods
  • Expand Methods

  • GET search /transactions/v1

    Search for transactions to refund

    Parameter	Value	Type	Description
    Accept	application/json	string	Content type of the response payload
    email		string	Customer's email address to search
    confirmationCode		string	Customer's confirmation number for ticket purchase
    chainSiteId		string	This is the chain's site Id and is required if the caller is a theater
    offset		integer	Record to start search from
    limit		integer	Number of records to return per request
    transactionCutoffDate		string	The date limit for the current search