BPT USA | BPT Canada | BPT UK | BPT Europe  
The first and only fair-trade ticketing company!
   

Brown Paper Tickets API Documentation


Push Feeds

    Push Feeds
 

Pull Feeds

  Event Information
    Event List
    Event Details
    Date Details
  Sales Information
    General Sales
    Event Sales
    Order List
  Client Information
    Account Information
    Sub Account Information
  Tool Information
    Printer Information
    Tool Information
 

Portals

  Submit Event
    Create Event
    Add Date
    Add Price
  Update Event
    Change Event
    Change Date
    Change Price
  Submit Order
    Submit Order
    Cart Contents
    Cart Value
  Client Accounts
    Create Client Account
    Edit Client Account
  Sub Accounts
    Create Sub Account
    Delete Sub Account
    Manage Sub Account Tools
  

Add Date


URL: https://www.brownpapertickets.com/api/adddate.html
 
Description: This portal is used to add dates to an event. This portal must be used immediately after creating a new event and before using the Add Price portal. It may also be used to add dates to already existing events. When used for this second purpose, it can be considered an "Update Event" portal.
 
Inputs:
l - Login name for your Brown Paper Tickets account.
 
p - Password for your Brown Paper Tickets account.
 
e_number - Brown Paper Tickets' unique event tracking number. The event's e_number is returned when creating a new event and can also be found using the Event List feed.
 
begin_time - This is the start date and time for the date. This should be in the format "MON-DD-YYYY 24:00".
 
end_time - This is the end date and time for the date. This should be in the format "MON-DD-YYYY 24:00".
 
sales_end - This is the day and time at which sales will end for this date. This should be in the format "MON-DD-YYYY 24:00". It is recommended that sales end no more than 24 hours and no less than 2 hours before the event's begin_time.
 
max_sales - This is the quantity of tickets available for this date. Use 0 for unlimited sales.
 
Optional
physical - Toggles the availability of physical shipped tickets. Values may be "t" or "f". Defaults to "t". (Optional)
 
pos - Toggles the availability of physical point-of-sale tickets. Values may be "t" or "f". Defaults to "t". (Optional)
 
willcall - Toggles the availability of willcall tickets. Values may be "t" or "f". Defaults to "t". (Optional)
 
Outputs: Returns a plain text 4-character result code and additional information when available. Follows the format: "Code:xxxx:Additional Information:" where "xxxx" is the result code. The possible 4 character codes are listed below.

1111 - Required variables are missing
 
2222 - Unknown error while fetching event info from DB
 
3333 - Event does not belong to user
 
4444 - Event can no longer be updated
 
9999 - Unknown error while posting info to DB
 
0000:E_NUMBER:DATE_ID - Success. Includes the event's e_number, the unique event tracking ID provided to each event, followed by the date's date_id, the unique tracking ID provided to each date.