POST ​/api​/v3​/venue

Creates a venue record

Request

Example Request

{
  "venue": {
    "name": "The Palladium",
    "latitude": {
    },
    "longitude": {
    },
    "website_url": "http://example.com/foo.html",
    "facebook_page_url": "http://facebook.com/foo",
    "twitter_username": "@foo",
    "custom": true
  }
}

Example Parameters

  • venue: The venue object containing venue attributes.

    • Required: yes
    • name: The name of the venue.
      • Required: yes
      • Type: string
      • Example: The Palladium
    • latitude: The latitude of the venue location
      • Required: yes
      • Type: Float
      • Example: 34.7971938
    • longitude: The longitude of the venue location
      • Required: yes
      • Type: Float
      • Example: -122.4053625
    • website_url: A url to a website for the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/foo.html
    • facebookpageurl: A url to the venue's Facebook page
      • Required: no
      • Type:
        • null
        • string
      • Example: http://facebook.com/foo
    • twitter_username: The venue's Twitter user name
      • Required: no
      • Type:
        • null
        • string
      • Example: @foo
    • custom: Indicates that a missing venue was created by a band in order to add a tour date.
      • Required: no
      • Type: boolean

Response

Example Response

{
  "venue": {
    "id": 1,
    "name": "The Palladium",
    "address": "Los Angeles",
    "capacity": 100,
    "city": "Los Angeles",
    "description": "Featuring Magnifi",
    "province": "CA",
    "country": "USA",
    "latitude": {
    },
    "longitude": {
    },
    "station_title": "The Palladium Radio",
    "venue_banner_url": "http://example.com/foo/bar/venue.jpg",
    "website_url": "http://example.com/foo.html",
    "facebook_page_url": "http://facebook.com/123456",
    "twitter_username": "@brooklynbowl",
    "slug": "palladium-radio",
    "you_follow": true,
    "has_music": true
  }
}

Response Parameters

  • venue:

    • Required: no
    • id: The unique ID of the venue
      • Required: no
      • Type: integer
      • Example: 1
    • name: The name of the venue
      • Required: no
      • Type: string
      • Example: The Palladium
    • address: Address of the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: Los Angeles
    • capacity: Capacity of venue
      • Required: yes
      • Type: integer
      • Example: 100
    • city: The venue's city
      • Required: no
      • Type: string
      • Example: Los Angeles
    • description: description of venue
      • Required: no
      • Type:
        • null
        • string
      • Example: Featuring Magnifi
    • province: The venue's state or province
      • Required: no
      • Type: string
      • Example: CA
    • country: The venue's country
      • Required: no
      • Type: string
      • Example: USA
    • latitude: The latitude of the venue location
      • Required: no
      • Type: Float
      • Example: 34.7971938
    • longitude: The longitude of the venue location
      • Required: no
      • Type: Float
      • Example: -122.4053625
    • station_title: If a station is requested for this venue, this is the name of that playlist.
      • Required: no
      • Type: string
      • Example: The Palladium Radio
    • venuebannerurl: A url to an image that can be displayed for the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/foo/bar/venue.jpg
    • website_url: A url to a website for the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: http://example.com/foo.html
    • facebookpageurl: A url to a Facebook page of the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: http://facebook.com/123456
    • twitter_username: Twitter handle name of the venue
      • Required: no
      • Type:
        • null
        • string
      • Example: @brooklynbowl
    • slug: The unique slug for a venue.
      • Required: no
      • Type:
        • null
        • string
      • Example: palladium-radio
    • you_follow: Indicates if the current account has favorited/followed this venue.
      • Required: no
      • Type: boolean
      • Example: true
    • has_music: Indicates if venue has any music
      • Required: yes
      • Type: boolean
      • Example: true

Response Codes

Successful Response Codes

  • 201: A valid response

Failure Response Codes

  • 422: Indicates a bad request including validation errors.