All Collections
Integrations
Eventive API
Sample API integration guides
Sample API integration guides

Common use cases for the Eventive API.

Theo Patt avatar
Written by Theo Patt
Updated over a week ago

The guides below just scratch the surface of what's possible with the Eventive API. Please get in touch for more specific details about the many additional capabilities of the Eventive API.

Custom schedule

Resources used

  • Events

HTTP requests

GET /event_buckets/{event-bucket-id}/events

Commonly used parameters:

  • upcoming_only : only fetch upcoming events

  • token : pass a logged-in customer's token in order to include data about purchased tickets and passes available to use for each event

Sample response

(truncated for brevity)

{
  "events": [
    ...
    {
      "id": "5a1cebde1883f10014df3a81",
      "event_bucket": "5a1ceb2a1883f10014df39d6",
      "timezone": "America\/Chicago",
      "name": "Missing People",
      "description": "<p>MISSING PEOPLE follows Martina Batan, the director of a prominent New York gallery, who investigates her brother&#39;s long unsolved murder while obsessively collecting and researching the art and life of the late Roy Ferdinand, a self-taught artist from New Orleans. Ferdinand&#39;s work covered dark themes including the hardscrabble life on the streets. When Martina uncovers new information about the murder, the inevitable collision of these parallel narratives leads to a chain of dramatic events.<\/p>",
      "short_description": "MISSING PEOPLE follows Martina Batan, the director of a prominent New York gallery, who investigates her brother&#39;s long unsolved murder while obsessively collecting and researching the art and life of the late Roy Ferdinand, a self-taught artist from New Orleans.",
      "venue": {
        "id": "5a1cebde1883f10014df3a72",
        "name": "Regal Cinemas 2",
        "color": "#8d95ff",
        "use_reserved_seating": false
      },
      "start_time": "2018-10-08T00:00:00.000Z",
      "end_time": "2018-10-08T01:00:00.000Z",
      "visibility": "visible",
      "hide_tickets_button": false,
      "passholder_ticket_required": true,
      "standalone_ticket_sales_enabled": true,
      "sales_disabled_unless_coupon": false,
      "trailer_url": "",
      "tags": [
        {
          "id": "5a1ceb9d1883f10014df39f7",
          "name": "Documentary Feature",
          "color": "#3697ff"
        }
      ],
      "tickets_available": true,
      "ticket_buckets": [
        {
          "id": "5a1cebde1883f10014df3a82",
          "name": "General Admission",
          "price": 1000,
          "processing_fee": null,
          "final_price": null,
          "unlimited": false,
          "quantity": 100,
          "quantity_sold": 1,
          "quantity_scanned": 0,
          "quantity_remaining": 99,
          "public": true,
          "pass_adjusted": {
            "5a31fedc4064520014615ccc": {
              "errors": [
                "This pass has already been used to reserve a ticket to this event. Passes may not be used to reserve more than one ticket to an event."
              ],
              "quantity_available": 0,
              "price": 1000,
              "processing_fee": null,
              "final_price": null
            }
          }
        }
      ],
      "public_url": "https:\/\/funfilmfest.eventive.org\/schedule\/5a1cebde1883f10014df3a81",
      "updated_at": "2017-11-28T04:53:50.742Z",
      "person": {
        "ticket_count": 1,
        "has_more_passes": false,
        "total_passes_available": 1,
        "passes": [
          {
            "pass_bucket": {
              "name": "Fun Film Pass",
              "code": "fun_film_pass",
              "order_message": "Quick order {{quantity}} {{tickets}} with pass \"{{pass}}\" ({{price}})..."
            },
            "id": "5a31fedc4064520014615ccc",
            "name": "My Fun Pass",
            "created_at": "2017-12-14T04:32:28.029Z",
            "is_applicable": false,
            "errors": [
              "This pass has already been used to reserve a ticket to this event. Passes may not be used to reserve more than one ticket to an event."
            ],
            "uses": 1
          }
        ]
      },
      "images": {},
      "rules": []
    },
    ...
  ]
}

Custom film guide

Resources used

  • Films

HTTP requests

GET /event_buckets/{event-bucket-id}/films

Sample response

{
  "films": [
    ...
    {
      "id": "5a20e969d14bfd0014eda1b1",
      "event_bucket": "5a1ceb2a1883f10014df39d6",
      "name": "The Real Artists",
      "sort_key": "Real Artists, The",
      "short_description": "Sophia Baker just scored her dream interview at a world-famous animation studio. But she soon learns all is not as she expected behind the curtain.",
      "description": "<p>Sophia Baker just scored her dream interview at a world-famous animation studio. But she soon learns all is not as she expected behind the curtain.<\/p>",
      "cover_image": "https:\/\/eventive.imgix.net\/1512106350214f664491ea7c0f6c4ce91.jpg",
      "poster_image": "https:\/\/eventive.imgix.net\/15121063484727fe3d4888abdb1a34d7c.jpg",
      "trailer_url": "",
      "details": {
        "year": "2017",
        "runtime": "12",
        "country": "USA"
      },
      "credits": {
        "director": "Cameo Wood"
      },
      "tags": [
        {
          "id": "5a20e969d14bfd0014eda1ad",
          "name": "Narrative Short",
          "color": "#fffc36"
        }
      ],
      "created_at": "2017-12-01T05:32:25.858Z",
      "updated_at": "2017-12-01T05:36:59.936Z"
    },
    ...
  ]
}
Did this answer your question?