String docs
Site integrations

Regal

Regal (regmovies.com) cinemas across the US, each cinema's showtimes for a day with formats and accessibility attributes, and a showtime's seat map with each seat's availability.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

  • Site: regal
  • Version: 1.0.0
  • Reads from: regmovies.com
ActionDescriptionListed price
cinemasList Regal cinemas, optionally filtered by text, ZIP code or city, or sorted nearest first from a latitude,longitude. Each row has the theatre code showtimes takes, the address, coordinates, phone, time zone and page URL.Billed per request at your plan's rates
showtimesList one Regal cinema's showtimes for a day, every performance of every film: start time in the cinema's local offset, format (IMAX, 3D, 4DX, ScreenX, RPX), accessibility and other attributes, auditorium, rating, runtime, whether it is sold out, and its booking URL.Billed per request at your plan's rates
seatsRead one Regal showtime's seat map without starting a booking: every seat with its row, number, seating area and type, and whether it is available, sold or held. Prices are not included; Regal shows them only inside an order.Billed per request at your plan's rates

cinemas

List Regal cinemas, optionally filtered by text, ZIP code or city, or sorted nearest first from a latitude,longitude. Each row has the theatre code showtimes takes, the address, coordinates, phone, time zone and page URL.

POST https://request.usestring.ai/v1/integrations/regal/cinemas

Input

Unknown fields are rejected.

FieldTypeDescription
querystringText matched against each cinema's name, address, city and state, ignoring case, such as union square or Seattle.
postcodestringA US ZIP code or its leading digits; cinemas whose ZIP starts with it.
locationstringA latitude,longitude pair, which sorts cinemas nearest first, or a city or two-letter state matched like query.
limitintegerThe most cinemas to return, from 1 to 500; all that match by default. From 1 to 500.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
cinemaIdstringThe theatre code, which showtimes takes.
namestring—
addressstring | null—
citystring | null—
statestring | nullThe two-letter state or territory code.
postcodestring | null—
countrystringISO 3166-1 alpha-2: US, or GU and AS for the Guam and American Samoa theatres.
latitudenumber | null—
longitudenumber | null—
phonestring | null—
timeZonestring | nullThe theatre's IANA time zone, such as US/Eastern.
urlstring—
chainstring—

Example

curl https://request.usestring.ai/v1/integrations/regal/cinemas \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "new york",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "cinemaId": "1320",
    "name": "Regal Union Square Stadium 14",
    "address": "850 Broadway",
    "city": "New York",
    "state": "NY",
    "postcode": "10003",
    "country": "US",
    "latitude": 40.734,
    "longitude": -73.9912,
    "phone": "212-253-6266",
    "timeZone": "US/Eastern",
    "url": "https://www.regmovies.com/theatres/1320",
    "chain": "Regal"
  },
  {
    "cinemaId": "1335",
    "name": "Regal Battery Park Stadium 11",
    "address": "102 North End Ave.",
    "city": "New York",
    "state": "NY",
    "postcode": "10282",
    "country": "US",
    "latitude": 40.7147,
    "longitude": -74.0155,
    "phone": "212-945-4370",
    "timeZone": "US/Eastern",
    "url": "https://www.regmovies.com/theatres/1335",
    "chain": "Regal"
  },
  {
    "cinemaId": "1412",
    "name": "Regal Essex Crossing & RPX",
    "address": "129 Delancey Street",
    "city": "New York",
    "state": "NY",
    "postcode": "10002",
    "country": "US",
    "latitude": 40.7182,
    "longitude": -73.9881,
    "phone": "212-475-5768",
    "timeZone": "US/Eastern",
    "url": "https://www.regmovies.com/theatres/1412",
    "chain": "Regal"
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

showtimes

List one Regal cinema's showtimes for a day, every performance of every film: start time in the cinema's local offset, format (IMAX, 3D, 4DX, ScreenX, RPX), accessibility and other attributes, auditorium, rating, runtime, whether it is sold out, and its booking URL.

POST https://request.usestring.ai/v1/integrations/regal/showtimes

Input

Unknown fields are rejected.

FieldTypeDescription
cinemaIdstringRequired. A Regal theatre code from the cinemas action, such as 1320, or the cinema's regmovies.com theatre page URL.
datestringThe day to list, as YYYY-MM-DD; today at the cinema by default. Matches ^\d{4}-\d{2}-\d{2}$.
filmIdstringOnly this film's showtimes, by the filmId a row carries, such as HO00022769.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
showtimeIdstringThe theatre code and session number, which seats takes.
cinemaIdstring—
filmIdstringRegal's film code, shared by the film's formats.
filmTitlestring—
startTimestringRFC 3339, in the cinema's local time and offset.
formatstringThe presentation: 2D, 3D, IMAX, IMAX 3D, 4DX, ScreenX, RPX or D-BOX, combined as the site lists them.
attributesstring[]Other features the site lists for the performance, such as closed captions, audio described, subtitled, recliner seating or laser.
screenstring | nullThe auditorium number.
bookingUrlstring—
soldOutbooleanTrue when the site has stopped selling the performance.
ratingstring | nullThe MPAA rating, such as PG-13.
runtimeMinutesinteger | null—

Example

curl https://request.usestring.ai/v1/integrations/regal/showtimes \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cinemaId": "1320"
  }'

data starts with these rows:

[
  {
    "showtimeId": "1320-313856",
    "cinemaId": "1320",
    "filmId": "HO00022769",
    "filmTitle": "You Can See Everything",
    "startTime": "2026-10-31T09:00:00-04:00",
    "format": "2D",
    "attributes": ["closed captions", "audio described", "Stadium Seating"],
    "screen": "8",
    "bookingUrl": "https://experience.regmovies.com/select-tickets?site=1320&id=313856",
    "soldOut": false,
    "rating": "R",
    "runtimeMinutes": 175
  },
  {
    "showtimeId": "1320-313820",
    "cinemaId": "1320",
    "filmId": "HO00020435",
    "filmTitle": "Street Fighter",
    "startTime": "2026-10-31T09:00:00-04:00",
    "format": "ScreenX",
    "attributes": ["closed captions", "audio described", "No Passes", "Stadium Seating"],
    "screen": "3",
    "bookingUrl": "https://experience.regmovies.com/select-tickets?site=1320&id=313820",
    "soldOut": false,
    "rating": "PG-13",
    "runtimeMinutes": 119
  },
  {
    "showtimeId": "1320-313835",
    "cinemaId": "1320",
    "filmId": "HO00021952",
    "filmTitle": "Klara and the Sun",
    "startTime": "2026-10-31T09:05:00-04:00",
    "format": "2D",
    "attributes": ["closed captions", "audio described", "Stadium Seating"],
    "screen": "4",
    "bookingUrl": "https://experience.regmovies.com/select-tickets?site=1320&id=313835",
    "soldOut": false,
    "rating": "PG-13",
    "runtimeMinutes": 117
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

seats

Read one Regal showtime's seat map without starting a booking: every seat with its row, number, seating area and type, and whether it is available, sold or held. Prices are not included; Regal shows them only inside an order.

POST https://request.usestring.ai/v1/integrations/regal/seats

Input

Unknown fields are rejected.

FieldTypeDescription
showtimeIdstringRequired. A showtimeId from the showtimes action, such as 1320-140718, or a regmovies.com booking URL carrying site and id.

Output

data is an array of rows, one per result. Each row has:

FieldTypeDescription
showtimeIdstring—
seatIdstringThe row letter and seat number as the site prints them on a ticket, such as C4.
rowstring | null—
numberstring—
areastring | nullThe seating area's name, such as Standard Seating.
typestringstandard, or the area's kind when the site names one: premium, recliner, vip or dbox.
statusstringavailable, sold, reserved (held by the cinema), or unavailable: a space the site will not sell on its own, which includes wheelchair and companion places.

Example

curl https://request.usestring.ai/v1/integrations/regal/seats \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "showtimeId": "1320-313834"
  }'

data starts with these rows:

[
  {
    "showtimeId": "1320-313834",
    "seatId": "L1",
    "row": "L",
    "number": "1",
    "area": "Standard Seating",
    "type": "standard",
    "status": "available"
  },
  {
    "showtimeId": "1320-313834",
    "seatId": "L2",
    "row": "L",
    "number": "2",
    "area": "Standard Seating",
    "type": "standard",
    "status": "available"
  },
  {
    "showtimeId": "1320-313834",
    "seatId": "L3",
    "row": "L",
    "number": "3",
    "area": "Standard Seating",
    "type": "standard",
    "status": "available"
  }
]

Requests and billing

  • Requests: 1 Web Access request per call.
  • Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.