Api Docs

GET https://www.lebtivity.com/api/v1/events

Returns an array of events along with each event's details. The result can be filtered based on the parameters below.

Parameters

api_key (required): Your api key

since (optional):

  • Type: DateTime
  • Format: YYYY-MM-DDTHH:II:SS
  • Description: Only send the created/modified events since a specific date.
  • Example: ?since=2013-06-01T19:00:00

limit (optional):

  • Type: Integer
  • Default: 50
  • Maximum: 200
  • Description: Limit the number of events to a specific number.
  • Example: ?limit=100

offset (optional):

  • Type: Integer
  • Default: 0
  • Description: Start the results from a specific number and skip the previous ones.
  • Example: ?offset=20

sort (optional):

  • Type: String
  • Possible values: popular | time
  • Default: popular
  • Description: Sort the events based on either popularity or time.
  • Example: ?sort=time

event_tag (optional):

  • Type: Mixed: String or Integer
  • Default: none
  • Description: Filter the events by tag. Pass an integer to filter by tag id, or a string to filter by tag slug.
  • Example: ?event_tag=1 or ?event_tag=music-concerts

from_date (optional):

  • Type: Date
  • Format: YYYY-MM-DD
  • Default: none
  • Description: Find the events that occur after a given date.
  • Example: ?from_date=2013-01-01

to_date (optional):

  • Type: Date
  • Format: YYYY-MM-DD
  • Default: none
  • Description: Find the events that occur before a given date.
  • Example: ?to_date=2013-01-01

status (optional):

  • Type: String
  • Possible values: any | active | cancelled
  • Default: any
  • Description: Filter events based on status. Events are either `active` or `cancelled`.
  • Example: ?status=active

Example Request:

https://www.lebtivity.com/api/v1/events?api_key=8373dsS339SA&limit=1&event_tag=music-concerts


{
	"events":[{
		"id": "3",
		"slug": "red-hot-chili-peppers-live",
		"name": "Red Hot Chili Peppers live",
		"excerpt": "Get ready for a new dimension in live entertainment!\r\nRed Hot Chili Peppers, America's coolest and most exciting band are coming...",
		"location": "Event Concert Venue",
		"location_lat": "33.8924",
		"location_lng": "35.5106",
		"status": "active",
		"created": "2012-05-07T15:22:09",
		"modified": "2013-05-09T16:43:52",
		"url": "http:\/\/www.lebtivity.com\/event\/red-hot-chili-peppers-live",
		"image": "http:\/\/www.lebtivity.com\/img\/content\/red-hot-chili-peppers-live.jpg",
		"full_image": "http:\/\/www.lebtivity.com\/img\/original\/red-hot-chili-peppers-live.jpg",
		"event_dates": [{
			"date": "2012-09-06",
			"start_time": "20:30:00",
			"end_time": "23:30:00"
		}],
		"event_tags": [{
			"id": "4",
			"slug": "music-concerts",
			"name": "Music"
		}]

	}],
	"meta": {
		"count": 1,
		"total_count": 2375
	}
}



GET https://www.lebtivity.com/api/v1/events/:id

Returns the event that matches the provided id.

Parameters

api_key (required): Your api key

Example Request:

https://www.lebtivity.com/api/v1/events/100?api_key=8373dsS339SA


{
	"event": {
		"id": "100",
		"slug": "photo-trip",
		"name":"Photo Trip",
		"excerpt": "There's plenty of parking around and you can park your car there for the day for free...",
		"location": "Photo Studio",
		"location_lat": "33.8924",
		"location_lng": "35.5106",
		"status": "active",
		"created": "2012-05-08T16:52:49",
		"modified": "2012-05-11T19:59:19",
		"url": "http:\/\/www.lebtivity.com\/event\/photo-trip",
		"image": "http:\/\/www.lebtivity.com\/img\/content\/photo-trip.jpg",
		"full_image": "http:\/\/www.lebtivity.com\/img\/original\/photo-trip.jpg",
		"event_dates": [{
			"date": "2012-05-20",
			"start_time": "09:00:00",
			"end_time": "18:00:00"
		}],
		"event_tags": [
			{
				"id": "2",
				"slug": "sports-outdoor",
				"name": "Sports & Outdoor"
			},
			{
				"id": "3",
				"slug": "arts-culture",
				"name": "Arts & Culture"
			}
		]

	}
}