Search Submitted Events

Search events submitted by your organization.

For example, you can use this to display a list of events submitted via Loop Links within your application to your users. See also the Events API documentation for more detail on many of the parameters mentioned below.

Request

GET https://api.predicthq.com/v1/loop/events
import requests

response = requests.get(
    url="https://api.predicthq.com/v1/loop/events",
    headers={
      "Authorization": "Bearer $ACCESS_TOKEN",
      "Accept": "application/json"
    },
    params={
        "phq_review": "approved"
    }
)

print(response.json())
Example response

Below is an example response:

{
  "count": 1,
  "events": [
    {
      "event_id": "tae8Mie8keiceicoMae2ie",
      "link_id": "ber7ntO0ZHuFVCfrSNsN",
      "create_dt": "2023-02-16T00:52:11.112355+00:00",
      "update_dt": "2023-05-09T02:05:51.695054Z",
      "version": 1,
      "phq_review": "approved",
      "org_review": "pending",
      "phq_auto_approved": false,
      "event": {
        "title": "Hotel A event",
        "description": "The 2023 edition of Hotel A festival.",
        "category": "festivals",
        "state": "active",
        "metadata": [
          {
            "maximum_attendance": 5000
          },
          {
            "attendance": 3215
          }
        ],
        "dates": {
          "fixed_date": {
            "start_date": "2023-06-02",
            "end_date": "2023-06-04"
          }
        },
        "labels": [
          "festival",
          "food",
          "music"
        ],
        "lat": "38.901544",
        "lon": "-119.7030036",
        "address": "859 U.S. Highway 395 North",
        "formatted_address": "859 U.S. Highway 395 North\nGardnerville, Nevada 89410\nUnited States of America",
        "city": "Gardnerville",
        "region": "Nevada",
        "postcode": "89410",
        "country": "US",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -119.703022,
            38.9012446
          ]
        }
      }
    }
  ]
}

Query Parameters

q (string, optional)

Full-text search of event information. E.g. ?q=hotel+a


Comma-separated list of link ids. Allows you to filter for events submitted via a specific Loop Link ID. E.g. ?link_id=m4Dk4g4DRA8Yqbp2PC54


event_id (string, optional)

Comma-separated list of event IDs. Allows you to retrieve specific events. E.g. ?event_id=5uRg7CqGu7DTtu4Rfk


user_id (string, optional)

Comma-separated list of user IDs that submitted the event. E.g. ?user_id=hw8Dsmv4Djg


state (string, optional)

Comma separated list of event states. Possible values: active, predicted, cancelled, postponed, archived.


category (string, optional)

Comma separated list of event categories. E.g. ?category=expos,festivals


label (string, optional)

Comma separated list of event labels. E.g. ?label=community,food,music


country (string, optional)

Comma separated list of country codes. E.g. ?country=NZ,US


start.* (string, optional)

The date from and/or to the event starts. Must be used with suffixes lt, lte, gt or gte. E.g. ?start.gt=2023-03-04&start.lte=2023-05-01


end.* (string, optional)

The date from and/or to the event ends. Must be used with suffixes lt, lte, gt or gte E.g. ?end.gt=2023-03-04&end.lte=2023-05-01


active.* (string, optional)

The date from and/or to the event is active. Must be used with suffixes lt, lte, gt or gte. E.g. ?active.gt=2023-03-04&active.lte=2023-05-01


created.* (string, optional)

The date from and/or to the event has been created. Must be used with suffixes lt, lte, gt or gte. E.g. ?created.gt=2023-03-04&created.lte=2023-05-01


updated.* (string, optional)

The date from and/or to the event was last updated. Must be used with suffixes lt, lte, gt or gte. E.g. ?updated.gt=2023-03-04&updated.lte=2023-05-01


private.include (string, optional, defaults to false)

Whether or not to include private events. Rejected & pending events will always be private. Possible values:

  • true: private and public events

  • false only public events

  • only: only private events

E.g ?private.include=only


org_review (string, optional)

Filter for submitted events approved, rejected or yet to be reviewed by the your Org. Possible values: pending, approved, rejected. E.g ?org_review=approved


phq_review (string, optional)

Filter for submitted events approved, rejected or yet to be reviewed by PredictHQ. Possible values: pending, approved, rejected. E.g ?phq_review=approved


sort (string, optional, defaults torelevance,-updated)

Comma-separated list of sort options. Prefix the field name with - for reverse order (e.g., -created). Possible values**:**

  • created

  • updated

  • version

  • relevance

E.g. ?sort=-updated


limit (number, optional, defaults to10)

The maximum number of results to return. E.g. ?limit=10


offset (number, optional, defaults to 0)

The number of results to skip. E.g. ?offset=20


Response

Response Fields

Submitted Event Response Fields

Guides

Below are some guides relevant to this API:

Last updated

© 2024 PredictHQ Ltd