{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"75d39eba-254f-4e9a-9128-55e85bfe2611","name":"Ticketing API","description":"Welcome to the [Ticketing API](https://docs.api.eventbrain.net) documentation.\n\nThe Ticketing API allows you to sell or buy events in a simple, programmatic way using conventional HTTP requests.\n\nThe API documentation will start with a general overview about the design and technology that has been implemented, followed by reference information about specific endpoints.\n\n# HTTP Statuses\n\nAlong with the HTTP methods that the API responds to, it will also return standard HTTP statuses, including error codes.\n\nIn the event of a problem, the status will contain the error code, while the body of the response will usually contain additional information about the problem that was encountered.\n\nIn general, if the status returned is in the 200 range, it indicates that the request was fulfilled successfully and that no error was encountered.\n\nReturn codes in the 400 range typically indicate that there was an issue with the request that was sent. Among other things, this could mean that you did not authenticate correctly, that you are requesting an action that you do not have authorization for, that the object you are requesting does not exist, or that your request is malformed.\n\nIf you receive a status in the 500 range, this generally indicates a server-side problem. This means that we are having an issue on our end and cannot fulfill your request currently.\n\n# Responses\n\nWhen a request is successful, a response body will typically be sent back in the form of a JSON object. An exception to this is when a DELETE request is processed, which will result in a successful HTTP 204 status and an empty response body.\n\nInside of this JSON object, the resource root that was the target of the request will be set as the key. This will be the singular form of the word if the request operated on a single object, and the plural form of the word if a collection was processed.\n\nThe value of these keys will generally be a JSON object for a request on a single object and an array of objects for a request on a collection of objects.\n\n# Pagination\n\nWhen pagination is enabled, the response headers includes the pagination data. By default, 10 objects are returned per page.\n\nYou can request a different pagination limit or force pagination by appending `?per_page=` to the request with the number of items you would like per page. For instance, to show only five results per page, you could add `?per_page=5` to the end of your query. The maximum number of results per page is 100.\n\n- **X-Page**: The number of the current page\n    \n- **X-Per-Page**: The number of objets to returned per page.\n    \n- **X-Total**: The number of total objects\n    \n\n# Rate Limits\n\nThe number of requests that can be made through the API is currently limited to 5,000 per hour per OAuth token.\n\nThe rate limiting information is contained within the response headers of each request. The relevant headers are:\n\n- **RateLimit-Limit**: The number of requests that can be made per hour.\n    \n- **RateLimit-Remaining**: The number of requests that remain before you hit your request limit. See the information below for how the request limits expire.\n    \n- **RateLimit-Reset**: This represents the time when the oldest request will expire. The value is given in Unix epoch time. See below for more information about how request limits expire.  \n    As long as the RateLimit-Remaining count is above zero, you will be able to make additional requests.\n    \n\nThe way that a request expires and is removed from the current limit count is important to understand. Rather than counting all of the requests for an hour and resetting the `RateLimit-Remaining` value at the end of the hour, each request instead has its own timer.\n\nThis means that each request contributes toward the `RateLimit-Remaining` count for one complete hour after the request is made. When that request's timer runs out, it is no longer counted towards the request limit.\n\nThis has implications on the meaning of the `RateLimit-Reset` header as well. Because the entire rate limit is not reset at one time, the value of this header is set to the time when the oldest request will expire.\n\nKeep this in mind if you see your `RateLimit-Reset` value change, but not move an entire hour into the future.\n\nIf the `RateLimit-Remaining` reaches zero, subsequent requests will receive a 429 error code until the request reset has been reached. You can see the format of the response in the examples.\n\n# Cross Origin Resource Sharing\n\nIn order to make requests to the API from other domains, the API implements Cross Origin Resource Sharing (CORS) support.\n\nCORS support is generally used to create AJAX requests outside of the domain that the request originated from. This is necessary to implement projects like control panels utilizing the API. This tells the browser that it can send requests to an outside domain.\n\nThe procedure that the browser initiates in order to perform these actions (other than `GET` requests) begins by sending a \"preflight\" request. This sets the Origin header and uses the `OPTIONS` method. The server will reply back with the methods it allows and some of the limits it imposes. The client then sends the actual request if it falls within the allowed constraints.\n\nThis process is usually done in the background by the browser, but you can use curl to emulate this process using the example provided. The headers that will be set to show the constraints are:\n\n- Access-Control-Allow-Origin: This is the domain that is sent by the client or browser as the origin of the request. It is set through an Origin header.\n    \n- Access-Control-Allow-Methods: This specifies the allowed options for requests from that domain. This will generally be all available methods.\n    \n- Access-Control-Expose-Headers: This will contain the headers that will be available to requests from the origin domain.\n    \n- Access-Control-Max-Age: This is the length of time that the access is considered valid. After this expires, a new preflight should be sent.\n    \n- Access-Control-Allow-Credentials: This will be set to true. It basically allows you to send your OAuth token for authentication.\n    \n\nYou should not need to be concerned with the details of these headers, because the browser will typically do all of the work for you.\n\n# Interfaces\n\nAn interface is a representation of a company's sales channel. All your tickets, products and operations will be processed through the selected interface.\n\nIn order to select an interface you must include the `X-Interface` header in all your requests, containing the id of your selected interface. If you do not include this header, we will assign a default interface for you. You can check which interface your requests are being processed through by checking the `X-Interface` header present in all our responses.\n\nWe strongly recommend including an interface in all your requests. Having a default interface selected by us may not be the behavior you are looking for, since interfaces determine which events and carts your users will have access to.\n\n# Scopes\n\nThe API manages access through various scopes: public, buy, sell, and admin. The public scope is mandatory and provides public reading access while safeguarding sensitive data. The buy scope offers write access and basic selling capabilities, making it suitable for third-party applications that require limited access to specific cart-related actions, such as payments, cart history, and user registration. The sell scope allows for comprehensive selling privileges, including access to sensitive data and cart-related actions beyond those available with basic selling access. Finally, the admin scope enables access to management-related tasks, including courtesies, validations, and data management.\n\nThe sell and admin scopes are specifically intended for the client credentials flow, reflecting their reliance on user dependencies. In contrast, the public and buy scopes are compatible with both the client and password credentials flow, offering flexibility in access and authentication methods.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"4964145","team":121469,"collectionId":"75d39eba-254f-4e9a-9128-55e85bfe2611","publishedId":"RWguwc5F","public":true,"publicUrl":"https://ticketing-api.docs.myticketplus.com","privateUrl":"https://go.postman.co/documentation/4964145-75d39eba-254f-4e9a-9128-55e85bfe2611","customColor":{"top-bar":"FF1313","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"MyTicketplus - Ticketing API Reference"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/d539939f-349c-4f21-9ab7-d46011fedaf4/MzAyMTk3MTYucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":"https://content.pstmn.io/d539939f-349c-4f21-9ab7-d46011fedaf4/MzAyMTk3MTYucG5n","colors":{"top-bar":"FF1313","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.10.1","publishDate":"2024-05-15T16:28:53.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"MyTicketplus - Ticketing API Reference","description":""},"logos":{"logoLight":"https://content.pstmn.io/d539939f-349c-4f21-9ab7-d46011fedaf4/MzAyMTk3MTYucG5n","logoDark":"https://content.pstmn.io/d539939f-349c-4f21-9ab7-d46011fedaf4/MzAyMTk3MTYucG5n"}},"statusCode":200},"environments":[{"name":"(Ticketing API) Example","id":"0b4744b5-f176-47f0-ba7a-5e3c9bf91af6","owner":"4964145","values":[{"key":"site_url","value":"https://channel.com","enabled":true},{"key":"api_url","value":"https://api.channel.com","enabled":true},{"key":"access_token_url","value":"{{api_url}}/auth/token","enabled":true},{"key":"client_id","value":"{{your_client_id}}","enabled":true},{"key":"client_secret","value":"{{your_client_secret}}","enabled":true},{"key":"username","value":"{{user@mail.com}}","enabled":true},{"key":"password","value":"{{secret}}","enabled":true},{"key":"new_password","value":"{{new_password}}","enabled":true},{"key":"access_token","value":"{{your_access_token}}","enabled":true},{"key":"refresh_token","value":"{{your_refresh_token}}","enabled":true},{"key":"scope","value":"{{scopes}}","enabled":true},{"key":"interface_id","value":"{{interface_id}}","enabled":true},{"key":"event_id","value":"{{event_id}}","enabled":true},{"key":"map_id","value":"{{map_id}}","enabled":true},{"key":"cart_id","value":"{{cart_id}}","enabled":true},{"key":"job_id","value":"{{job_id}}","enabled":true},{"key":"code","value":"{{code}}","enabled":true},{"key":"seat_id","value":"{{seat_id}}","enabled":true},{"key":"ticket_id","value":"{{ticket_id}}","enabled":true},{"key":"qr_code","value":"{{qr_code}}","enabled":true},{"key":"sale_detail_id","value":"{{sale_detail_id}}","enabled":true},{"key":"user_id","value":"{{user_id}}","enabled":true},{"key":"user_email","value":"john.doe@mail.com","enabled":true},{"key":"user_first_name","value":"John","enabled":true},{"key":"user_last_name","value":"Doe","enabled":true},{"key":"country_id","value":"46","enabled":true},{"key":"state_id","value":"530","enabled":true},{"key":"address_id","value":"{{address_id}}","enabled":true},{"key":"guest_id","value":"{{guest_id}}","enabled":true},{"key":"plan_id","value":"{{plan_id}}","enabled":true},{"key":"plan_setting_id","value":"{{plan_setting_id}}","enabled":true},{"key":"subscription_id","value":"{{subscription_id}}","enabled":true},{"key":"resources","value":"interfaces,currencies","enabled":true}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/b79659c6ac031a01999a3d1f027338d1975f4ccb9518470ce2c435b3a05bafff","favicon":"https://res.cloudinary.com/postman/image/upload/v1658159514/team/mpu7otzylsxqxmx1jv5h.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"(Ticketing API) Example","value":"4964145-0b4744b5-f176-47f0-ba7a-5e3c9bf91af6"}],"canonicalUrl":"https://ticketing-api.docs.myticketplus.com/view/metadata/RWguwc5F"}