Events / ID Lookup
Name | Events / ID Lookup |
|---|---|
Description | Look up the TEvo event id given another event source and id |
Type | GET |
URL | /v9/events/id_lookup |
API|User | |
No |
Long Description
This endpoint allows you to lookup the TEvo event id given an event id from another POS or Marketplace. The TEvo event id is a requirement to create inventory using the Inventory API.
The event source list has many options, but mapping to TEvo event ids will not always be present or known. The larger external sources will have higher hit rates for the corresponding TEvo event id.
Request Parameters
Parameters
Name | Description | Type | Presence | Location |
|---|---|---|---|---|
| ID of the event on the external source system | Integer | Required | Query |
| The source system where the | String Enum - AXS
- GAMETIME
- GO_TICKETS
- LOGITIX
- MLB_BALLPARK
- PACIOLAN
- POSNEXT
- PROVENUE
- SEATGEEK
- SKYBOX
- STUBHUB
- STUBHUB_INTERNATIONAL
- TESSITURA
- TICKPICK
- TICKET_NETWORK
- TICKET_UTILS
- TICKETMASTER_PRIMARY
- TICKETMASTER_RESALE
- TIX_TRACK
- TIXSTOCK
- TRADEDESK
- TRUE_TICKETS
- VIAGOGO
- VIVID
- VIVENU | Required | Query |
Responses
HTTP Code | Meaning | Description |
|---|---|---|
200 | OK | TEvo Event ID successfully found and returned. |
400 | Bad Request | Validation error. Check input fields and formats. A detailed error message is included in the response body. |
401 | Unauthorized | Authentication failed or missing credentials. |
404 | Not Found | Resource not found for any of the provided identifiers. |
500 | Internal Server Error | An unexpected error occurred on the server. |
Examples
Request | Response |
|---|---|
|
{
"event_id_source":"TEVO",
"event_id":3160868
}
|
|
{
"errors":
[
{
"code":"not_found",
"message":"No Tevo event id mapping found for the given event_id: 8675309 and event_id_source: VIVID"
}
]
} |
|
{
"errors":
[
{
"code":"invalid_params",
"message":"event_id_source must be one of: AXS, GAMETIME, GO_TICKETS, LOGITIX, MLB_BALLPARK, PACIOLAN, POSNEXT, PROVENUE, SEATGEEK, SKYBOX, STUBHUB, STUBHUB_INTERNATIONAL, TESSITURA, TICKPICK, TICKET_NETWORK, TICKET_UTILS, TICKETMASTER_PRIMARY, TICKETMASTER_RESALE, TIX_TRACK, TIXSTOCK, TRADEDESK, TRUE_TICKETS, VIAGOGO, VICTORY_LIVE, VIVID, VIVENU"
}
]
} |