Skip to content
Atom Tickets Partner API

Venue Examples

Get Venues by Location

Section titled “Get Venues by Location”

Find venues near Santa Monica, CA.

Request

Section titled “Request”
Terminal window
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venue/details/byLocation?lat=34.0195&lon=-118.4912&radius=50&pageSize=2' \
  -H 'x-api-key: {AtomPartnerApiKey}'

Response

Section titled “Response”
{
  "venueDetails": [
    {
      "venue": {
        "id": "C00110921804",
        "name": "AMC Loews Broadway 4",
        "address": {
          "line": "1441 Third Street Promenade",
          "city": "Santa Monica",
          "state": "CA",
          "postal": "90401",
          "lat": 34.014801025390625,
          "lon": -118.49500274658203
        },
        "properties": {
          "supportsConcessions": true,
          "supported": true
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00110921804",
        "atomVenueId": "1341"
      },
      "kmDistance": 0.628527332801801
    },
    {
      "venue": {
        "id": "C00401723167",
        "name": "AMC Santa Monica 7",
        "address": {
          "line": "1310 3rd Street",
          "city": "Santa Monica",
          "state": "CA",
          "postal": "90401",
          "lat": 34.016693115234375,
          "lon": -118.49755859375
        },
        "properties": {
          "supportsConcessions": true,
          "supported": true
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00401723167",
        "atomVenueId": "44608"
      },
      "kmDistance": 0.6647355560508852
    }
  ],
  "pageInfo": {
    "page": 1,
    "pageSize": 2,
    "totalPages": 52
  }
}

Get Venues by IDs

Section titled “Get Venues by IDs”

Look up a specific venue with distance calculation.

Request

Section titled “Request”
Terminal window
curl -X POST \
  https://api-beta.atomtickets.com/partner/v1/venue/details/byIds \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {AtomPartnerApiKey}' \
  -d '{
    "ids": ["C0057070265"],
    "location": {
      "lat": 34.0195,
      "lon": -118.4912
    }
  }'

Response

Section titled “Response”
{
  "venueDetails": [
    {
      "venue": {
        "id": "C0057070265",
        "name": "Regal LA Live & 4DX",
        "address": {
          "line": "1000 West Olympic Boulevard",
          "city": "Los Angeles",
          "state": "CA",
          "postal": "90015",
          "lat": 34.031402587890625,
          "lon": -118.46971130371094
        },
        "properties": {
          "supportsConcessions": false,
          "supported": false
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C0057070265",
        "atomVenueId": "20263"
      },
      "kmDistance": 2.383671824436259
    }
  ]
}

Search Venues by Name

Section titled “Search Venues by Name”

Search for AMC theaters near Santa Monica.

Request

Section titled “Request”
Terminal window
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venue/details/search?term=amc&lat=34.0195&lon=-118.4912&radius=50&pageSize=2' \
  -H 'x-api-key: {AtomPartnerApiKey}'

Response

Section titled “Response”
{
  "venueDetails": [
    {
      "venue": {
        "id": "C00110921804",
        "name": "AMC Loews Broadway 4",
        "address": {
          "line": "1441 Third Street Promenade",
          "city": "Santa Monica",
          "state": "CA",
          "postal": "90401",
          "lat": 34.014801025390625,
          "lon": -118.49500274658203
        },
        "properties": {
          "supportsConcessions": true,
          "supported": true
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00110921804",
        "atomVenueId": "1341"
      },
      "kmDistance": 0.628527332801801
    },
    {
      "venue": {
        "id": "C00401723167",
        "name": "AMC Santa Monica 7",
        "address": {
          "line": "1310 3rd Street",
          "city": "Santa Monica",
          "state": "CA",
          "postal": "90401",
          "lat": 34.016693115234375,
          "lon": -118.49755859375
        },
        "properties": {
          "supportsConcessions": true,
          "supported": true
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00401723167",
        "atomVenueId": "11729"
      },
      "kmDistance": 0.6647355560508852
    }
  ],
  "pageInfo": {
    "page": 1,
    "pageSize": 2,
    "totalPages": 10
  }
}

Get Venue by Vendor ID

Section titled “Get Venue by Vendor ID”

Map a vendor venue ID to an Atom venue.

Request

Section titled “Request”
Terminal window
curl -X GET \
  'https://api-beta.atomtickets.com/partner/v1/venues/byVendorVenueId/0001' \
  -H 'x-api-key: {AtomPartnerApiKey}'

Response

Section titled “Response”
{
  "venueDetails": [
    {
      "venue": {
        "id": "C00889608713",
        "name": "Flix Brewhouse - Des Moines",
        "address": {
          "line": "3800 Merle Hay Road",
          "city": "Des Moines",
          "state": "IA",
          "postal": "50310",
          "lat": 41.629539489746094,
          "lon": -93.69798278808594
        },
        "properties": {
          "supportsConcessions": true,
          "supported": true
        },
        "venueUrl": "http://rw-beta.atomtickets.com/theaters/redirect/C00889608713",
        "atomVenueId": "7364"
      }
    }
  ]
}