The Fienta API facilitates the integration of event and ticket management features into your applications. This documentation covers essential aspects such as the API’s base URL, handling of common responses and time, methods for authentication, and details on both public and private endpoints related to events and tickets. It also includes references for data types used by the API and information on webhooks.
The base URL for Fienta’s API is https://fienta.com/api/v1
Authorization fails due to an invalid token or no permission to access the requested resource.
Body
Examples
Authorization fails due to an invalid token
{
"errors": [
{
"code": 401,
"user_message": "Unauthorized access",
"internal_message": "authorization_failed"
}
]
}No permission to access the queried resource
{
"errors": [
{
"code": 401,
"user_message": "Unauthorized access",
"internal_message": "unauthorized_access_to_resource"
}
]
}Too many API requests made within one minute by the user or from an IP. The limit is 80 requests per minute.
Body
Examples
{
"errors": [
{
"code": 429,
"user_message": "Too many requests, please slow down the request.",
"internal_message": "too_many_requests"
}
],
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"retry_after": 80
}Authentication
Get the current server date, time and timezone values.
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Timestamp returned successfully",
"internal_message": "timestamp_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
}
}Our public API can be used by anyone to read public non-private events.
Authentication
Retrieves all public (non-private) events. By default, only events that have not yet ended are returned. A maximum of 1000 events is returned per request; to retrieve more, use the page parameter.
Note: There may be a delay of up to one minute before newly created events are available.
Request parameters
Returns only events that start at or after the specified time.
Returns only events that end at or after the specified time. Defaults to the current time.
Specifies the preferred locale for event data (title, description, etc.) in ISO 639-1 format. If the requested locale is unavailable, a fallback language is used. Defaults to “en”.
Same as the “locale” parameter but events without the requested locale are not returned.
Two-letter country code (ISO 3166-1 alpha-2) in which the event takes place. When not specified, events from all countries are returnd.
City or locality of the events. When used with “locale_strict”, it will match the name only in the specified locale. Otherwise matches the name in any of the event’s languages.
Only events which belong to requested category are returned.
Comma separated list of event organiser ID-s. Only events by the requested organisers are returned.
Name of event series
Venue or the location of the events. Exact matches only. When used with “locale_strict”, it will match the name only in the specified locale. Otherwise matches the name in any of the event’s languages.
Use “page” parameter to enable paging results.
Number of events returned per page when using “page” parameter.
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"count": 1,
"events": [
{
"id": 10,
"title": "Happy event",
"starts_at": "2018-09-22 00:00:00",
"ends_at": "2018-10-22 23:59:59",
"duration_string": "Sat 22. September - Mon 22. October 2018",
"sale_status": "salesEnded",
"attendance_mode": "offline",
"venue": "Sydney Opera House",
"address": "1600 Pennsylvania Ave., Washington, D.C., 20500",
"address_postal_code": "10151",
"description": "Lorem ipsum<br>\\n superma lex",
"url": "https://fienta.com/happy-event",
"buy_tickets_url": "https://fienta.com/happy-event",
"image_url": "https://fienta.com/uploads/12456.jpg",
"series_id": "happy-event",
"organizer_name": "Great Events Ltd",
"organizer_phone": "1 800 1234 5678",
"organizer_email": "hello@greatevents.com",
"organizer_id": 4567,
"categories": [
""
]
}
]
}There are two ways to get the token:
- Organiser account level API key can be found using Fienta’s user interface from Settings > Integration.
- User level key can be retrieved via the API using Authenticate call.
Authentication
On successful authentication returns the API token to use for authorization in API request headers.
Request headers
Request body
Examples
{
"email": "myemail@domainname.com",
"password": "mypassword"
}Responses
Body
The API token to use for authorization of API requests that require it
Expiration date and time for the token
The user ID the token is tied to. May be null if the token is tied to a specific organizer or an event instead.
Examples
{
"success": {
"code": 200,
"user_message": "Authenticated successfully",
"internal_message": "authenticated_successfully"
},
"token": {
"token": "TOKENSTRING",
"expires_at": null,
"user_id": 1
}
}{organizer_id}/eventsAuthentication
Returns organizers the given API token has access to.
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Organizers returned successfully",
"internal_message": "organizers_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"organizers": [
{
"id": 4,
"name": "Organizer Company Name Ltd."
}
]
}{organizer_id}/eventsAuthentication
Get all events of the organizer specified by organizer_id.
Path variables
Request parameters
Retrive events which start at specified time or later.
Retrive events which end at specified time or later.
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"events": [
{
"id": 10,
"title": "Happy event",
"starts_at": "2018-09-22 00:00:00",
"ends_at": "2018-10-22 23:59:59",
"duration_string": "Sat 22. September - Mon 22. October 2018",
"sale_status": "onSale",
"attendance_mode": "online",
"venue": "Sydney Opera House",
"address": "1600 Pennsylvania Ave., Washington, D.C., 20500",
"description": "Lorem ipsum<br>\\n superma lex",
"url": "https://fienta.com/happy-event",
"buy_tickets_url": "https://fienta.com/happy-event",
"image_url": "https://fienta.com/uploads/12456.jpg",
"organizer_name": "Great Events Ltd",
"organizer_phone": "1 800 1234 5678",
"organizer_email": "hello@greatevents.com",
"organizer_id": 4567
}
]
}{event_id}{event_id}{event_id}Authentication
Path variables
ID of the event
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"data": {
"id": 10,
"organizer_id": 10101,
"starts_at": "2022-10-05T14:00:00+03:00",
"ends_at": "2022-10-31T17:00:00+02:00",
"sale_status": "onSale",
"is_published": true,
"is_public": true,
"attendance_mode": "mixed",
"image_url": "https://fienta.com/cf/img/?width=1070&format=jpeg&v=1732711840&file=/uploads/2024/11/112274/112274-en-241127025040.jpg",
"image_small_url": "https://fienta.com/cf/img/?width=690&format=jpeg&v=1732711840&file=/uploads/2024/11/112274/112274-en-241127025040.jpg",
"accent_color": "#1047F8",
"categories": ["festival", "music"],
"url": "https://fienta.com/happy-event",
"buy_tickets_url": "https://fienta.com/happy-event",
"translations": {
"en": {
"title": "Happy event",
"description": "Lorem ipsum<br>\\n superma lex",
"duration_string": "Wed 5. October at 14:00 - Mon 31. October 2022 at 17:00 EEST",
"notes_about_time": "Doors open at 9.30",
"venue": "Sydney Opera House",
"online_location": "Zoom",
"address": {
"street": "1600 Pennsylvania Ave.",
"city": "Washington",
"county": "District of Columbia",
"postal_code": "20500",
"country_code": "us"
},
"organizer": {
"name": "Great Events Ltd",
"phone": "1 800 1234 5678",
"email": "hello@greatevents.com"
}
}
},
"created_at": "2020-07-23T11:15:58+03:00",
"updated_at": "2020-07-23T11:15:58+03:00"
}
}Authentication
Get all events for which you are authorized to access using your bearer token.
Request parameters
Only events which start after the requested time are returned. Defaults to current time.
The preferred locale for the event data (title, description, …) in ISO639-1 format. Fallback language is returned when the event does not have the requested locale.
Same as the “locale” parameter but events without the requested locale are not returned.
Comma separated list of event organiser ID-s. Only events by the requested organisers are returned.
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"data": [
{
"id": 10,
"organizer_id": 10101,
"starts_at": "2022-10-05T14:00:00+03:00",
"ends_at": "2022-10-31T17:00:00+02:00",
"sale_status": "salesNotStarted",
"is_published": true,
"is_public": true,
"attendance_mode": "offline",
"image_url": "https://fienta.com/cf/img/?width=1070&format=jpeg&v=1732711840&file=/uploads/2024/11/112274/112274-en-241127025040.jpg",
"image_small_url": "https://fienta.com/cf/img/?width=690&format=jpeg&v=1732711840&file=/uploads/2024/11/112274/112274-en-241127025040.jpg",
"accent_color": "#1047F8",
"categories": ["festival", "music"],
"url": "https://fienta.com/happy-event",
"buy_tickets_url": "https://fienta.com/happy-event",
"translations": {
"en": {
"title": "Happy event",
"description": "Lorem ipsum<br>\\n superma lex",
"duration_string": "Wed 5. October at 14:00 - Mon 31. October 2022 at 17:00 EEST",
"notes_about_time": "Doors open at 9.30",
"venue": "Sydney Opera House",
"online_location": "Zoom",
"address": {
"street": "1600 Pennsylvania Ave.",
"city": "Washington",
"county": "District of Columbia",
"postal_code": "20500",
"country_code": "us"
},
"organizer": {
"name": "Great Events Ltd",
"phone": "1 800 1234 5678",
"email": "hello@greatevents.com"
}
}
},
"created_at": "2020-07-23T11:15:58+03:00",
"updated_at": "2020-07-23T11:15:58+03:00"
}
]
}{event_id}Authentication
Path variables
ID of the event
Request headers
Request body
Event published status
Data for events with attendance_mode set to ‘mixed’ or ‘online’. Not visible when attendance_mode is ‘offline’.
Redirect customer to redirect_url when online event starts
URL where to redirect
Examples
{
"is_published": true,
"online_event": {
redirect_to_url: true,
redirect_url: "https://www.example.com"
}
}Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Ticket updated successfully",
"internal_message": "ticket_updated_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
}
}{event_id}/tickets/{ticket_code}/{ticket_code}/{event_id}/tickets/Authentication
Path variables
ID of the event
Request parameters
Return only tickets that have been updated after the specified date/time (either a Unix timestamp in seconds or a date/time string accepted by the PHP strtotime function)
The registration form data provided by the ticket holder is omitted by default for reducing data size and optimising database performance. To add the “attendee” object, add “attendees” parameter.
Marketing data of the order. Contains referrer and UTM parameters.
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"tickets": [
{
"id": 123456,
"event_id": 12345,
"order_id": 123345,
"code": "4LO4A3T8IH",
"status": "USED",
"used_at": "2020-03-01 15:35:11",
"created_at": "2020-02-01 13:24:48",
"updated_at": "2020-02-01 13:24:48",
"validated_by": 12345,
"ip": "192.168.1.2",
"order_email": "john@smidth.com",
"order_phone": "+1234567890",
"contents_html": "<h1>1 x Regular ticket</h1><h1>2 x Student ticket</h1><h2>John</h2><h2>Smith</h2>",
"nametag_html": "<!DOCTYPE html><html><body><p>Name: John</p><p>Surname: Smith</p></body></html>",
"qty": 1,
"rows": [
{
"ticket_type": {
"id": 1234,
"title": "Early bird ticket",
"attendance_mode": "online"
},
"attendee": {
"first_name": "John",
"last_name": "Smidth",
"full_name": "John Smidth",
"email": "john.smidth@buyer.com",
"some_other_form_field": "Vegan food please"
}
}
],
"marketing_data": {
"referrer": "https://www.facebook.com/",
"utm_source": "facebook",
"utm_medium": "cpc",
"utm_campaign": "spring_promo",
"utm_term": "discount_event",
"utm_content": "banner_ad_1",
"discount_code": "vip123"
}
}
]
}Examples
Get tickets for event with ID 10 that were updated after 2018-05-06 15:19:27
GET http://fienta.localhost/api/v1/events/10/tickets/?updated_after=1525619967 HTTP/1.1
Authorization: Bearer APITOKEN{ticket_code}/Authentication
Path variables
Code of the ticket
Request parameters
The registration form data provided by the ticket holder is omitted by default for reducing data size and optimising database performance. To add the “attendee” object, add “attendees” parameter.
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"ticket": {
"id": 123456,
"event_id": 12345,
"order_id": 123345,
"code": "4LO4A3T8IH",
"status": "UNUSED",
"used_at": "2020-03-01 15:35:11",
"created_at": "2020-02-01 13:24:48",
"updated_at": "2020-02-01 13:24:48",
"validated_by": 12345,
"ip": "192.168.1.2",
"order_email": "john@smidth.com",
"order_phone": "+1234567890",
"contents_html": "<h1>Check ticket type and amount from ticket</h1>",
"nametag_html": "<!DOCTYPE html><html><body><p>Name: John</p><p>Surname: Smith</p></body></html>",
"qty": 1,
"rows": [
{
"ticket_type": {
"id": 1234,
"title": "Regular ticket",
"attendance_mode": "online"
},
"attendee": {
"first_name": "John",
"last_name": "Smidth",
"full_name": "John Smidth",
"email": "john.smidth@buyer.com",
"some_other_form_field": "Vegan food please"
}
}
],
"marketing_data": {
"referrer": "https://www.facebook.com/",
"utm_source": "facebook",
"utm_medium": "cpc",
"utm_campaign": "spring_promo",
"utm_term": "discount_event",
"utm_content": "banner_ad_1",
"discount_code": "vip123"
}
}
}{ticket_code}/Authentication
Path variables
Code of the ticket
Request headers
Request body
One of the following: USED, UNUSED, REFUND_REQUESTED
Date and time the ticket was validated
IP address string
Examples
{
"status": "USED",
"used_at": "2018-04-06 22:27:21"
}{
"status": "UNUSED",
"used_at": null
}Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Ticket updated successfully",
"internal_message": "ticket_updated_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
}
}{event_id}/ticket-types{event_id}/ticket-typesAuthentication
Path variables
ID of the event
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Events returned successfully",
"internal_message": "events_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"data": [
{
"id": 10123,
"event_id": 10,
"price": "10.00",
"currency": "EUR",
"ticket_limit": 50,
"tickets_sold": 25,
"tickets_pending": 1,
"vat": 20,
"visible_start": "2020-07-23T11:15:58+03:00",
"visible_end": "2020-07-23T11:15:58+03:00",
"visible_code": "secret123",
"attendance_mode": "online",
"is_donation": "false",
"donation_suggested_price": "",
"translations": {
"en": {
"title": "Regular ticket"
}
},
"created_at": "2020-07-23T11:15:58+03:00",
"updated_at": "2020-07-23T11:15:58+03:00"
}
]
}{event_id}/custom-fields{event_id}/custom-fieldsAuthentication
Path variables
ID of the event
Request headers
Responses
Body
Examples
{
"success": {
"code": 200,
"user_message": "Custom fields returned successfully",
"internal_message": "custom_fields_returned_successfully"
},
"time": {
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
},
"data": [
{
"id": 1010,
"event_id": 10,
"name": "full-name-1010",
"type": "text",
"required": "false",
"unique": "false",
"applies_to": "order",
"sort_order_group": 2,
"sort_order": 1,
"translations": {
"en": {
"label": "John Smith",
"input_label": "",
"help_text": "Please enter your full name"
}
},
"created_at": "2022-10-18T16:27:50+03:00",
"updated_at": "2022-10-18T16:27:50+03:00"
}
]
}Unix timestamp (seconds since January 1st 1970)
Date formatted in PHP date format “Y-m-D”
Time formatted in PHP date format “H:i:s”
Full datetime string
Timezone identifier string
Timezone abbreviation
Difference to Greenwich time (GMT) in hours
Examples
{
"timestamp": 1525436423,
"date": "2018-05-04",
"time": "15:20:23",
"full_datetime": "2018-05-04T15:20:23+03:00",
"timezone": "Europe/Tallinn",
"timezone_short": "EEST",
"gmt": "+0300"
}ID of the event
Title of the event
Date and time of the start of the event
Date and time of the ending of the event
A human readable event duration string
Indicates whether the tickets can be bought.
Whether the event takes place at the venue (“offline”) is virtual (“online”) or is hybrid (“mixed”)
Name of the physical venue for real-life events
Address of the venue without country name
Post index of the venue
Description of the event, may contain HTML tags
URL of the event page in Fienta
URL where the tickets are sold. As Fienta allows listing events which sell tickets on other platforms, this may point elsewhere but in most cases the value is just the same as “url”. The value can be also empty, in case the event is public and free and tickets are not sold at all.
URL of the event hero image
URL of the smaller version of the event hero image
A string attribute that associates events belonging to a series. This attribute is always set, even if there are no other events in the same series.
Name of the organizer
Phone number of the organizer, may be empty
Contact email of the organizer, always filled
ID of the organiser of the event
Up to 3 categories the event belongs to
["festival", "music", "spirituality"]["music", "film"]Examples
{
"id": 10,
"title": "Happy event",
"starts_at": "2018-09-22 00:00:00",
"ends_at": "2018-10-22 23:59:59",
"duration_string": "Sat 22. September - Mon 22. October 2018",
"sale_status": "soldOut",
"attendance_mode": "mixed",
"venue": "Sydney Opera House",
"address": "1600 Pennsylvania Ave., Washington, D.C., 20500",
"description": "Lorem ipsum<br>\\n superma lex",
"url": "https://fienta.com/happy-event",
"buy_tickets_url": "https://fienta.com/happy-event",
"image_url": "https://fienta.com/uploads/12456.jpg",
"series_id": "happy-event",
"organizer_name": "Great Events Ltd",
"organizer_phone": "1 800 1234 5678",
"organizer_email": "hello@greatevents.com",
"organizer_id": 4567
}Newer and more detailed version of Event data object
ID of the event
ID of the event organizer
Start date and time of the event
End date and time of the event
Whether the tickets can be bought
Whether event is published
Whether event is public or private
Whether the event takes place at the venue (“offline”) is virtual (“online”) or is hybrid (“mixed”)
URL of the event hero image
URL of the event hero image (small)
Accent color used on ticket sales page
Array of up to 3 of categories defined on event
["music", "festival", "art"]URL of the event page in Fienta
URL where the tickets are sold. As Fienta allows listing events which sell tickets on other platforms, this may point elsewhere but in most cases the value is just the same as “url”. The value can be also empty, in case the event is public and free and tickets are not sold at all.
Translatable fields for each locale used by event
Locale abbreviation
Title of the event
Description of the event, may contain HTML tags
A human readable event duration string
Additional notes about time
Name of the physical venue for real-life events
Name of the platform for online and hybrid events
Address
Street name and house number
City
County or region
Postal code
Country code
Organizer contacts
Organizer name
Organizer phone number
Organizer email
Date and time of event creation
Date and time of event update
Event ticket
ID of the ticket
ID of the event the ticket belongs to
ID of the purchase order the ticket was bought with
Code of the ticket which is used for validation. This code is visible on the ticket and usually also represented as QR code.
Date and time the ticket was validated at, “null” if not yet validated
Date and time the ticket was created at
Date and time the ticket was last changed at, this includes status changes
ID of the user who validated the ticket, “null” if not yet validated
IP address of the user who validated the ticket, empty if not yet validated
Email address of buyer
Phone number of buyer
Ticket contents HTML, for displaying on scanner:
- Ticket row quantity x Ticket type, between <h1> tags
- Attendee-based Order custom field values, marked with ‘Display on scanner’, between <h2> tags
Or, in case of a third-party ticket (has only code, no order_id and no ticket_rows), appropriate translation.
Name tag HTML for sending to printer. Filled with Attendee-based Order custom fields values when Event’s nametag_html template has been entered.
Total quantity of visitors on the Ticket. This has usually value of 1, except for compound tickets which is experimental feature currently.
ID of the ticket type
Title of the ticket type
Whether the ticket is valid at the venue (“offline”) only online (“online”) or for both (“mixed”)
Built in custom field value, if added to the form by event organiser
Built in custom field value, if added to the form by event organiser
Combined first and last name, built in custom field value, if added to the form by event organiser
Built in custom field value, if added to the form by event organiser
All ticket/attendee based form fields are listed similarly here as attributes
Referrer URL
Examples
{
"id": 123456,
"event_id": 12345,
"order_id": 123345,
"code": "4LO4A3T8IH",
"status": "UNUSED",
"used_at": "2020-03-01 15:35:11",
"created_at": "2020-02-01 13:24:48",
"updated_at": "2020-02-01 13:24:48",
"validated_by": 12345,
"ip": "192.168.1.2",
"order_email": "john@smidth.com",
"order_phone": "+1234567890",
"contents_html": "<h1>Check ticket type and amount from ticket</h1>",
"nametag_html": "<!DOCTYPE html><html><body><p>Name: John</p><p>Surname: Smith</p></body></html>",
"qty": 1,
"rows": [
{
"ticket_type": {
"id": 1234,
"title": "Early bird ticket",
"attendance_mode": "offline"
},
"attendee": {
"first_name": "John",
"last_name": "Smidth",
"full_name": "John Smidth",
"email": "john.smidth@buyer.com",
"some_other_form_field": "Vegan food please"
}
}
],
"marketing_data": {
"referrer": "https://www.facebook.com/",
"utm_source": "facebook",
"utm_medium": "cpc",
"utm_campaign": "spring_promo",
"utm_term": "discount_event",
"utm_content": "banner_ad_1",
"discount_code": "vip123"
}
}ID of the ticket type
ID of the event
Price
Currency
Number of tickets set as a limit for this ticket type
Number of tickets sold from this ticket type
Number of tickets pending
VAT % that applies to this ticket type
Date and time when sale of ticket type will start
Date and time when sale of ticket type will stop
Ticket type will be hidden in ticket sales page until this code is entered. Ticke type is always visible if empty.
Incicates how the buyer of the ticket can access to the event
Indicates if ticket type is a donation
Price displayed as default price in the donation amount input
Locale abbreviation
Title
Date and time of ticket type creation
Date and time of ticket type update
ID of the custom field
ID of the event
Name of the custom field
Type of the custom field
Whether the field is mandatory to fill
Whether the field value has to be unique in context of this event
Whether the field is shown for each ticket or once per order
Group in which the custom field is displayed on the screen
Custom field’s display position within sort_order_group
Translatable fields for each locale used by event
Locale abreviation
Field input label or a question for radio buttons and checkboxes
Field input label for radio buttons and checkboxes
Informational text displayed under the field
Creation time of custom field
Update time of custom field
Registration data provided by the buyer or attendee. Each attribute-value pair corresponds to the actual custom form field defined via Fienta’s UI for the particular event. The data below is just example and does not apply to all events.
Fienta has three webhooks which can be turned on by the event organiser on Settings > Integrations page.
These trigger on
Triggers when a ticket is bought or attendee has registered to a free event.
Unique id of the order.
Order status. Has always value “COMPLETED” when order completion webhook is triggered.
Language in which the user made the purhase or registraion.
Contact email address which was entered by the buyer or attendee.
Contact phone number which was entered by the buyer or attendee.
Whether the buyer or attendee signed up for event organiser’s mailinglist.
Time of payment or registration completion.
Total amount paid in cents.
VAT percentage, inluded in total amount.
Discount code used during the checkout. This object is returned only if a code was used by the buyer.
ID of the discount.
Discount code string entered by the buyer.
Array of tickets
Ticket code, in most cases embeded in QR code.
Ticket price in cents.
Specific tickets within specific ticket code. In majority of cases, only one row is returned as one ticket code refers to one ticket type. However this is not the case for compound tickets.
Quantity, usually has value of 1.
URL of event hero image, can be emtpy string.
Additional notes about event time.
Human friendly representaion of event date and time.
Examples
{
"id": 1234,
"status": "COMPLETED",
"locale": "en",
"buyer": {
"email": "john@smidth.com",
"phone": "081 3888 382",
"mailinglist_subscribe": true
},
"payment": {
"time": "2020-06-03T14:26:07+03:00",
"total": 2000,
"vat_percent": 20,
"currency": "EUR"
},
"discount": {
"id": 56789,
"code": "86FYL"
},
"tickets": [
{
"code": "W753PV85CP",
"price": 2000,
"rows": [
{
"ticket_type": {
"id": "48482",
"title": "Regular ticket",
"qty": "1"
},
"attendee": {
"full_name": "John Smidth",
"first_name": "John",
"last_name": "Smidth"
}
}
]
}
],
"event": {
"id": 3834,
"title": "Die Hard 2",
"url": "https://fienta.com/en/die-hard",
"image_url": "https://fienta.com/uploads/3834.jpg",
"starts_at": "2020-11-14T19:00:00+02:00",
"ends_at": "2020-11-14T20:10:00+02:00",
"time_description": "Doors open at 18:30",
"duration_string": "Sat 14. November 2020 at 19:00 - 20:10",
"venue": {
"name": "Noblessner movie theatre",
"address": "Oak street 3, London",
"country_code": "uk"
},
"organizer": {
"name": "Smidth Events Ltd",
"phone": "081 38484 28484",
"email": "john@smidthevents.com"
}
}
}Triggers when registration form is submitted after initial purchase.
Array of tickets
Ticket code, in most cases embeded in QR code.
Specific tickets within specific ticket code. In majority of cases, only one row is returned as one ticket code refers to one ticket type. However this is not the case for compound tickets.
Quantity, usually has value of 1.
Examples
{
"ticket": [
{
"code": "W753PV85CP",
"rows": [
{
"ticket_type": {
"id": "48482",
"title": "Regular ticket",
"qty": "1"
},
"attendee": {
"mail": "john@smidth.com",
"name": "John Smidth",
"country": "Sweden"
}
}
],
"event": {
"id": 10,
"title": "Happy event",
"starts_at": "2018-09-22 00:00:00",
"ends_at": "2018-10-22 23:59:59",
"duration_string": "Sat 22. September - Mon 22. October 2018"
}
}
]
}Triggers when a ticket status is marked as USED. This can be done using Fienta’s mobile app, over web interface or via an API call.
URL of event hero image, can be emtpy string.
Additional notes about event time.
Human friendly representaion of event date and time.
Language in which the user made the purhase or registraion.
Referrer which lead to the purchase or registration. Event organiser has to use ?ref parameter when referring to the event URL in Fienta for this to have value.
Whether the buyer or attendee signed up for event organiser’s mailinglist.
Examples
{
"code": "0O1TVHPTMU",
"status": "USED",
"validated_at": "2020-06-03T14:24:55+03:00",
"rows": [
{
"ticket_type": {
"ticket_type_id": 360,
"title": "Regular ticket",
"qty": 1
}
}
],
"event": {
"id": 147,
"title": "Conference \"Birth Words\"",
"url": "https://fienta.com/en/sunnisonad",
"image_url": "https://fienta.com/uploads/147.jpg",
"starts_at": "2020-11-14T19:00:00+02:00",
"ends_at": "2020-11-14T20:10:00+02:00",
"time_description": "",
"duration_string": "Sat 14. November 2020 at 19:00 - 20:10",
"venue": {
"name": "Noblessner",
"address": "Tööstuse 48 Tallinn",
"country_code": "ee"
},
"organizer": {
"name": "Korraldaja nimi",
"phone": "",
"email": "test@testkorraldaja.ee"
}
},
"order": {
"id": 240784,
"status": "COMPLETED",
"locale": "en",
"ref": "close",
"buyer": {
"email": "rene@fienta.com",
"phone": "",
"mailinglist_subscribe": true
}
}
}