GET ​/api​/v3​/venues​/export

An API for exporting venues. This API is only granted to select partners. If you need access to this, please get in touch.

Request

Example Request

{
  "page": 1,
  "per_page": 20,
  "since": "2013-08-13T20:51:22+00:00"
}

Example Parameters

  • page: The page number, starting at 1 (optional)

    • Required: no
    • Type: integer
    • Example: 1
  • per_page: The number of records to return in each page. Default is 100. Maximum is 1000.

    • Required: no
    • Type: integer
    • Example: 20
  • since: Provide this date to limit the results to only records modified since this date.

    • Required: no
    • Type: string
    • Format: date-time
    • Example: 2013-08-13T20:51:22+00:00

Response

Example Response

{
  "meta": {
    "page": 1,
    "total_pages": 6,
    "per_page": 20,
    "records": 107,
    "last_modified": "2013-08-13T20:51:22+00:00"
  },
  "venues": [
    {
      "id": 4,
      "name": "The Palladium",
      "address": "Los Angeles, CA, USA",
      "latitude": "34.0522",
      "longitude": "-118.2428",
      "city": "Los Angeles",
      "province": "CA",
      "country": "USA",
      "station_title": "The Palladium Radio",
      "venue_banner_url": "http://example.com/venue_banner.jpg",
      "slug": "palladium-radio"
    }
  ]
}

Response Parameters

  • meta: Metadata about the current response

    • Required: no
    • page: The current page number. Starts at 1.
      • Required: no
      • Type: integer
      • Example: 1
    • total_pages: The total number of pages to request.
      • Required: no
      • Type: integer
      • Example: 6
    • per_page: The number of records in each page.
      • Required: no
      • Type: integer
      • Example: 20
    • records: The total number of available records.
      • Required: no
      • Type: integer
      • Example: 107
    • last_modified: The max updated timestamp of the current page. You can use this date to limit the records returned the next time you request the export.
      • Required: no
      • Type: string
      • Format: date-time
      • Example: 2013-08-13T20:51:22+00:00
  • venues: The list of venues for the current page

    • Required: no
    • Type: array
    • Items

      • Required: no
      • id:

        • Required: no
        • Type: integer
        • Example: 4
      • name:

        • Required: no
        • Type: string
        • Example: The Palladium
      • address:

        • Required: no
        • Type: string
        • Example: Los Angeles, CA, USA
      • latitude:

        • Required: no
        • Type: string
        • Example: 34.0522
      • longitude:

        • Required: no
        • Type: string
        • Example: -118.2428
      • city:

        • Required: no
        • Type: string
        • Example: Los Angeles
      • province:

        • Required: no
        • Type: string
        • Example: CA
      • country:

        • Required: no
        • Type: string
        • Example: USA
      • station_title:

        • Required: no
        • Type: string
        • Example: The Palladium Radio
      • venuebannerurl:

        • Required: no
        • Type:
          • null
          • string
        • Example: http://example.com/venue_banner.jpg
      • slug: The unique slug for a venue.

        • Required: no
        • Type:
          • null
          • string
        • Example: palladium-radio

Response Codes

Successful Response Codes

  • 200:

Failure Response Codes