> For the complete documentation index, see [llms.txt](https://docs.sync.comake.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sync.comake.io/api-reference/events.md).
# Events
## Get Events
## Get a list of deduplicated events
`POST` `https://acvb.standard.storage/api/custom/events`
Gets a list of deduplicated events updated or created since a date. Requires a Bearer token in the Authorization header.
Example request using curl:
`curl -X POST --header "Authorization: Bearer abc123.mytoken" https://acvb.standard.storage/api/custom/events --data '{"updated_since":"2022-08-28T01:05:42.008Z"}'`
#### Request Body
| Name | Type | Description |
| ------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| updated\_since\* | string | The date to get events modified after in simplified extended ISO format ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)), which is always 24 or 27 characters long (`YYYY-MM-DDTHH:mm:ss.sssZ` or `±YYYYYY-MM-DDTHH:mm:ss.sssZ`, respectively). The timezone is always zero UTC offset, as denoted by the suffix `Z`. Eg. `2022-08-29T16:43:50.161Z` |
| page | integer | The page of results to get.
Default: 0
|
| page\_size | integer | How many results to get per page.
Default: 50
Maximum: 500
|
| start\_after | string | A date to filter for events that start after. Must be supplied in simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ, respectively). The timezone is always zero UTC offset, as denoted by the suffix Z.
Eg. 2022-08-29T16:43:50.161Z
|
| start\_before | string | A date to filter for events that start before. Must be supplied in simplified extended ISO format (ISO 8601), which is always 24 or 27 characters long (YYYY-MM-DDTHH:mm:ss.sssZ or ±YYYYYY-MM-DDTHH:mm:ss.sssZ, respectively). The timezone is always zero UTC offset, as denoted by the suffix Z.
Eg. 2022-08-29T16:43:50.161Z
|
| location | string | A URI of a location entity from the graph to filter by only events at that location.
Eg.
|
| only\_external\_updates | boolean | If true, only updates to events synced from 3rd party sources will be compared with the `updated_since` parameter to determine if they should show up in the results. This is useful when you don't want the API to respond based on updates to your own data. If your data has been deduplicated with the data from 3rd party source, it will still be included in the unified results. |
{% tabs %}
{% tab title="200 Retrieved events successfully" %}
A sucessful response will contain a JSON object containing:
**page**: number - The page which was retrieved.
**has\_next\_page**: boolean - Whether there are more results than the previous retrieved pages or not.
**data**: array - The list of Deduplicated Event results.
```json
{
"page": 0,
"has_next_page": false,
"data": [
{
"id": "https://acvb.standard.storage/data/42b65406-68a7-41f2-9846-58635a30f734",
"updatedAt": "2023-04-27T22:16:27.978Z",
"createdAt": "2023-04-27T22:16:27.950Z",
"integrations": [
"https://acvb.standard.storage/integrations/SeatGeek",
"https://acvb.standard.storage/integrations/Ticketmaster"
],
"name": "John Fogerty",
"description": "",
"startDate": "2023-07-27T00:00:00.000Z",
"accessStart": "2023-04-19T00:00:00.000Z",
"accessEnd": "2023-07-27T04:00:00.000Z",
"dateConfirmed": true,
"timeConfirmed": true,
"maximumPrice": 2398,
"minimumPrice": 82,
"averagePrice": 266,
"listingCount": 165,
"eventStatus": "EventScheduled",
"categories": [
{
"identifier": "13",
"name": "Music & Concerts"
}
],
"keywords": [
"concert",
"Undefined",
"Rock",
"Pop",
"Music"
],
"sourceIds": [
{
"integration": "https://acvb.standard.storage/integrations/SeatGeek",
"id": "6003263"
},
{
"integration": "https://acvb.standard.storage/integrations/Ticketmaster",
"id": "vvG1zZ9IryMKRy"
}
],
"urls": [
{
"integration": "https://acvb.standard.storage/integrations/SeatGeek",
"url": "https://seatgeek.com/john-fogerty-tickets/atlanta-georgia-cadence-bank-amphitheatre-at-chastain-park-2023-07-26-8-pm/concert/6003263"
},
{
"integration": "https://acvb.standard.storage/integrations/Ticketmaster",
"url": "https://concerts.livenation.com/john-fogerty-atlanta-georgia-07-26-2023/event/0E005E87B9DD3BF9"
}
],
"images": [
{
"contentUrl": "https://s1.ticketm.net/dam/a/38e/d6bfd9e3-bb2a-4f8b-a7b5-2bfd3ed2338e_RETINA_PORTRAIT_16_9.jpg",
"height": 360,
"representativeOfPage": true,
"width": 640,
"integration": "https://acvb.standard.storage/integrations/Ticketmaster"
},
{
"contentUrl": "https://s1.ticketm.net/dam/a/38e/d6bfd9e3-bb2a-4f8b-a7b5-2bfd3ed2338e_CUSTOM.jpg",
"height": 225,
"representativeOfPage": true,
"width": 305,
"integration": "https://acvb.standard.storage/integrations/Ticketmaster"
},
],
"location": {
"id": "https://acvb.standard.storage/data/293028ec-2fec-4a45-910d-939e19f54858",
"updatedAt": "2023-04-05T22:11:28.580Z",
"createdAt": "2023-03-14T02:08:34.476Z",
"sourceIds": [
{
"integration": "https://acvb.standard.storage/integrations/SeatGeek",
"id": "293"
},
{
"integration": "https://acvb.standard.storage/integrations/Ticketmaster",
"id": "KovZpZAEkAaA"
}
],
"urls": [
{
"integration": "https://acvb.standard.storage/integrations/SeatGeek",
"url": "https://seatgeek.com/venues/cadence-bank-amphitheatre-at-chastain-park/tickets"
}
],
"name": "Cadence Bank Amphitheatre at Chastain Park",
"latitude": "33.8766",
"longitude": "-84.396",
"telephone": "No number available for the Box Office 404-233-2227 - To purchase season tickets for Rock/Pop series.",
"integrations": [
"https://acvb.standard.storage/integrations/SeatGeek",
"https://acvb.standard.storage/integrations/Ticketmaster"
],
"address": {
"streetAddress": "4469 Stella Dr Atlanta, GA 30342",
"postalCode": "30342",
"addressRegion": "Georgia",
"addressLocality": "Atlanta",
"addressCountry": "US"
},
"images": [
{
"contentUrl": "https://s1.ticketm.net/dbimages/22723v.jpg",
"height": 115,
"representativeOfPage": true,
"width": 205,
"integration": "https://acvb.standard.storage/integrations/Ticketmaster"
}
]
},
}
]
}
```
{% endtab %}
{% tab title="400 Bad Request - Incorrectly formatted parameters" %}
{% endtab %}
{% tab title="401 Permission denied - Invalid Authorization token" %}
{% endtab %}
{% tab title="402 Permission deined - Invalid Authorization header" %}
{% endtab %}
{% endtabs %}