Introduction

Welcome to the Legacy 1Ticket API!

Authentication

1Ticket uses API keys to allow access to the API. To request an API key, email the support team at support@1ticket.com.

1Ticket expects for the API key to be included in all API requests to the server in a header that looks like the following:

x-api-token: YOUR_API_TOKEN

/api

The api is a collection of tools to access core 1Ticket data.

GET /v2/getpdf/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/getpdf/?rid=16990019',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/getpdf/?rid=16990019 \
  -H 'x-api-token: YOUR_API_TOKEN'

{
  "result":
  {
    "status": "success",
    "message": "",
    "messageid": ""
  },
  "output":
  [
    {
      "seats":
      [
        {
          "seatid": "55847443",
          "status": "live",
          "haspdf": "",
          "obstructions": [ ],
          "ticketstock": "eticket",
          "printdate": "",
          "1ticketid": "16990019",
          "seatnumber": "35",
          "section": "SEC H",
          "row": "2",
          "pdfguid": "{ABCD1234-AAAA-4C4B-AA04-8A31212A3AAA}",
          "barcode": "1353136914970530",
          "pdfurl": "http://balance.1ticket.com/pdf/{ABCD1234-AAAA-4C4B-AA04-8A31212A3AAA}"

        }
      ]
    }
  ]
}

Description

Get PDF and barcode data for a specific purchase group.

HTTP Request

GET https://1ticket.com/api/v2/getpdf/?rid={rid}

Headers

Key	Required	Description
x-api-token	Yes	Your API token

URL Query Parameters

Parameter	Required	Description
rid	Yes	1Ticket ID of group

GET /v2/purchases/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/purchases/',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/purchases/ \
  -H 'x-api-token: YOUR_API_TOKEN'

{
  "result": {
    "status": "success",
    "message": "",
    "messageid": ""
  },
  "output": [{
    "purchases": [{
      "rid": 17016286,
      "event": {
        "name": "Sugarland",
        "venue": "Smart Financial Centre",
        "datetime": "7/11/2018 7:00:00 PM",
        "eventid_1ticket": "5E71DE58CABCDEF7EAAB8BCB8B44123F",
        "eventid_primary": "",
        "printdelay_hours": ""
      },
      "purchasing_account": {
        "account_username": "test@test.com",
        "account_id": "",
        "account_id_1ticket": "123456"
      },
      "purchaseorders": {
        "ticketutils": "7654",
        "skybox": "9876",
        "ticketnetwork": "1234",
        "posnext": "10102"
      },
      "disclosures": [45, 22, 88],
      "marketplace": {
        "marketplace": "Ticket Evolution",
        "marketplaceid": "201"
      },
      "receipt": {
        "confirmation_number": "2712824-1234567",
        "confrmation_number_1ticket": "2712824-1234567",
        "confirmation_region": "TEVO",
        "pricecode": "",
        "cost_group": "65.34",
        "cost_perseat": "33",
        "face_perseat": "33",
        "seen_emailreceipt": false,
        "seen_onlinereceipt": false,
        "creditcard": "",
        "buyer_name": "",
        "purchasedate": "6/15/2018"
      },
      "attributes": {
        "refund": "true"
      },
      "items": {
        "section": "309",
        "row": "H",
        "section_original": "309",
        "row_original": "H",
        "seat_first": "5",
        "seat_last": "6",
        "quantity": "2",
        "stock": "eticket"
      },
      "haspdf": false,
      "datelastseen": "6/15/2018 7:55:41 PM",
      "datefirstseen": "6/15/2018 7:55:41 PM"
    },
    {
      "rid": 17190790,
      "event": {
        "name": "Sugarland",
        "venue": "Smart Financial Centre",
        "datetime": "7/11/2018 7:00:00 PM",
        "eventid_1ticket": "5E71DE58CABCDEF7EAAB8BCB8B44123F",
        "eventid_primary": "",
        "printdelay_hours": ""
      },
      "purchasing_account": {
        "account_username": "test@test.com",
        "account_id": "",
        "account_id_1ticket": "123456"
      },
      "marketplace": {
        "marketplace": "Ticket Evolution",
        "marketplaceid": "201"
      },
      "receipt": {
        "status": "active",
        "confirmation_number": "2755735-1231231",
        "confrmation_number_1ticket": "2755735-1231231",
        "confirmation_region": "TEVO",
        "pricecode": "",
        "cost_group": "64",
        "cost_perseat": "32",
        "face_perseat": "32",
        "seen_emailreceipt": false,
        "seen_onlinereceipt": false,
        "creditcard": "",
        "buyer_name": "",
        "purchasedate": "7/10/2018"
      },
      "attributes": {
        "refund": "unknown"
      },
      "items": {
        "section": "302",
        "row": "H",
        "section_original": "302",
        "row_original": "H",
        "seat_first": "1",
        "seat_last": "2",
        "quantity": "2",
        "stock": "eticket"
      },
      "haspdf": false,
      "rotating_barcodes": true,
      "datelastseen": "7/10/2018 6:11:17 PM",
      "datefirstseen": "7/10/2018 6:11:17 PM"
    }]
  }]
}

Description

Search all purchases in your 1Ticket account. Data returned is the equivalent of what is found on 1ticket.com/purchases.

HTTP Request

GET https://1ticket.com/api/v2/purchases/

Headers

Key	Required	Description
x-api-token	Yes	Your API token

URL Query Parameters

Parameter	Required	Description
rid	No	1Ticket ID of group
datefirstseen	No	date 1Ticket first saw purchase (mm/dd/yyyy). Also accepts >=mm/dd/yyyy and <=mm/dd/yyyy
eventdate	No	date of an event (mm/dd/yyyy)
eventdatestart	No	start date of an event date range. requires "eventdateend" as well (mm/dd/yyyy)
purchasedate	No	date an order was purchased (mm/dd/yyyy)
eventname	No	name of an event (will match as wildcard, ie %[eventname]%)
venuename	No	name of a venue (will match as wildcard, ie $[venuename]%)
confirmationnumber	No	confirmation number of purchase (ex: 12-34567 for Ticketmaster). does NOT include region code
confirmationregion	No	region code of purchase. "null" represents no region code
purchasedatestart	No	start date of a purchase date range. requires "purchaseenddate" as well (mm/dd/yyyy)
poid	No	POS purchase order ID. Note: only returns listings where 1Ticket has created the PO or mapped a ticket group to your POS. Can accept multiple POIDs in a comma-seprated list
ccdigits	No	Last four digits of credit card used for purchase. Note: only works for purchases where 1Ticket has the last four digits stored. Can accept multiple sets of digits in a comma-separated list
elig_refund	No	accepted values: true, false, unknown. "Unknown" means 1Ticket has either not seen refund information or Ticketmaster has not yet made it available
username	No	Username/email address of purchasing account
status	No	Status of a purchase: Active or Canceled

GET /v2/crawl

import requests

response = requests.get(
  'http://1ticket.com/api/v2/crawl/?username={username}&confnum={confnum}&source={source}',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  http://1ticket.com/api/v2/crawl/?username={username}&confnum={confnum}&source={source} \
  -H 'x-api-token: YOUR_API_TOKEN'

Description

Tell 1Ticket to crawl Ticketmaster for a specific order. This API can be used to tell 1Ticket to recrawl a purchase it has already seen or to crawl an account to find a specific new purchase.

HTTP Request

GET https://1ticket.com/api/v2/crawl/?username={username}&confnum={confnum}&source={source}

Headers

Key	Required	Description
x-api-token	Yes	Your API token

URL Query Parameters

Parameter	Required	Description
username	no	marketplace account username
confnum	no	ticketmaster order number (in format #-####/ABC) OR string "all" to do a full crawl for any new purchases
source	Yes	where this request is coming from (basically a description of your service 'joebroker_app', etc.)
id	no	ID of account in 1Ticket
marketplaceid	no	ID of marketplace in 1Ticket. If empty defaults to Ticketmaster (id 1)

Note

If "id" is submitted "username" and "marketplaceid" are ignored, even if they are also supplied.

GET /v2/verify

import requests

response = requests.get(
  'http://1ticket.com/api/v2/verify/',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  http://1ticket.com/api/v2/verify/ \
  -H 'x-api-token: YOUR_API_TOKEN'

{

  "result":
    {
      "status": "success",
      "message": "",
      "messageid": ""
    },
    "output":
    [
      {
        "company_name": "Test Comapny Name"
      }
    ]
}

Description

Verify validity of an API token and get basic client information

HTTP Request

GET http://1ticket.com/api/v2/verify/

Headers

Key	Required	Description
x-api-token	Yes	Your API token

GET /v2/sales

import requests

response = requests.get(
  'http://1ticket.com/api/v2/sales/?q=next%207%20days%20vivid%20unfilled',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  http://1ticket.com/api/v2/sales/?q=next%207%20days%20vivid%20unfilled \
  -H 'x-api-token: YOUR_API_TOKEN'

{
  "result": 
  {
    "status": "success",
    "message": "",
    "messageid": ""
  },
  "output": 
  [
    {
      "orderid": "22009999",
      "marketplace": "Vivid",
      "marketplaceid": 4,
      "ticketstock": "eticket",
      "type": "purchase",
      "processing": 
      [
        {
          "hold": "success",
          "message": ""
        },
        {
          "confirm": "success",
          "message": ""
        },
        {
          "invoice": "success",
          "message": "19033333"
        },
        {
          "fulfill": "error",
          "message": "Ticket file is not available"
        }
      ],
      "event": 
      {
        "name": "Ziggy Marley",
        "venue": "",
        "date": "2018-09-01",
        "time": "19:00"
      },
      "tickets": 
      {
        "section": "REAR ORCHESTRA",
        "row": "XX",
        "quantity": 2,
        "seatfirst": "50",
        "seatlast": "52",
        "total_order": "200",
        "total_payment": "190"
      },
      "hold_details": 
      {
        "received": "8/30/2018 8:28:45 PM",
        "removed_date": "1",
        "removed_by": ""
      }
    },
    {
      "orderid": "22005555",
      "marketplace": "Vivid",
      "marketplaceid": 4,
      "ticketstock": "eticket",
      "type": "purchase",
      "processing": 
      [
        {
          "hold": "success",
          "message": ""
        },
        {
          "confirm": "success",
          "message": ""
        },
        {
          "invoice": "success",
          "message": "19044444"
        },
        {
          "fulfill": "error",
          "message": "Ticket file is not available"
        }
      ],
      "event": 
      {
        "name": "Phantom Of The Opera",
        "venue": "",
        "date": "2018-09-06",
        "time": "19:30"
      },
      "tickets": 
      {
        "section": "MEZZANINE RIGHT",
        "row": "YY",
        "quantity": 2,
        "seatfirst": "25",
        "seatlast": "24",
        "total_order": "350",
        "total_payment": "330"
      },
      "hold_details": 
      {
        "received": "8/30/2018 6:30:01 PM",
        "removed_date": "1",
        "removed_by": ""
      }
    }
  ]
}

Description

API to query sales data.

HTTP Request

GET https://1ticket.com/api/v2/sales/?q=queryString

Headers

Key	Required	Description
x-api-token	Yes	Your API token

URL Query Parameters

Parameter	Required	Description
q	Yes	query string which can be strung together using different options

Following options can be used to build the query string:

Marketplace name:
- stubhub
- vivid
- ticketsnow
- tnow
- tickpick
- etc
Fulfillment status:
- filled
- unfilled
- unfulfilled
- fulfilled
Span of upcoming/past event dates:
- next 3 months
- next 5 days
- next 60 minutes
- last 48 hours
- last 7 days
- last 2 weeks
Date (returns sales with the matching event date and sale date):
- 12/15/2018
Date range (returns sales with the matching sale date):
- 12/10/2018 to 12/30/2018
- 12/10/2018-12/30/2018
Hold failures:
- fail
- failure
- hold fail
- failed hold

All values above can be strung together. For example "unfulfilled vivid next 3 days" will return all unfulfilled Vivid sales occurring in the next three days.

GET /v2/marketplaces/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/marketplaces',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/marketplaces \
  -H 'x-api-token: YOUR_API_TOKEN'

{
    "result": {
        "status": "success",
        "message": "",
        "messageid": ""
    },
    "output": [{
        "id": "395",
        "name": "Mesa Arts Center",
        "url": "",
        "password_required": false
    }, {
        "id": "58",
        "name": "Metrotix",
        "url": "",
        "password_required": false
    }, {
        "id": "359",
        "name": "OSSBroadway Across America - Baltimore",
        "url": "https://am.ticketmaster.com/baabal/",
        "password_required": true
    }]
}

Description

Get a list of all supported marketplaces.

HTTP Request

GET https://1ticket.com/api/v2/marketplaces

Headers

Key	Required	Description
x-api-token	Yes	Your API token

GET /v2/fulfill/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/fulfill/?orderid={orderid}&marketplaceid={marketplaceid}',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/fulfill/?orderid={orderid}&marketplaceid={marketplaceid} \
  -H 'x-api-token: YOUR_API_TOKEN'

{
    "result": {
        "status": "success",
        "message": "",
        "messageid": ""
    },
    "output": []
}

Description

This will tell 1Ticket that the order in question is ready to fulfill, triggering us to look in the POS for PDFs/barcodes as needed. Please note that just because a success response is given it does NOT mean the order was filled; it only means that we received your request and have queued the order up for fulfillment.

HTTP Request

GET https://1ticket.com/api/v2/fulfill

Headers

Key	Required	Description
x-api-token	Yes	Your API token

URL Query Parameters

Parameter	Required	Description
orderid	Yes	marketplace order id
marketplaceid	Yes	1Ticket marketplace id (see below lookup table)

Marketplace ID lookup table

Marketplace ID	Marketplace Name
1	stubhub
2	ticketnetwork
3	tnow
4	vivid
12	viagogo
15	fanxchange
16	tickpick
25	gametime
27	seatsmart
29	premiumseatsusa
41	seatgeek
52	agora

GET /v2/disclosures/

import requests

response = requests.get(
  'http://1ticket.com/api/v2/disclosures',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  http://1ticket.com/api/v2/disclosures \
  -H 'x-api-token: YOUR_API_TOKEN'

{
    "result": {
        "status": "success",
        "message": "",
        "messageid": ""
    },
    "output": [
        {
            "disclosures": [
                {
                    "id": 1,
                    "description": "Not valid",
                    "description_short": "NOENTRY",
                    "description_long": "Not Valid for Entry",
                    "description_skybox": "",
                    "description_dti": ""
                },
                {
                    "id": 2,
                    "description": "Side view",
                    "description_short": "SIDEVIEW",
                    "description_long": "Side View",
                    "description_skybox": "",
                    "description_dti": "Side View (printed on ticket)"
                },
                ...
            ]
        }
    ]
}

Description

This endpoint is used to get a list of disclosures that 1Ticket pulls from marketplace purchase receipts and PDFs.

HTTP Request

GET http://1ticket.com/api/v2/disclosures

Headers

Key	Required	Description
x-api-token	Yes	Your API token

GET /v2/accounts/list/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/accounts/list/?marketplacename=ticketmaster&username=johndoe@gmail.com',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/accounts/list/?marketplacename=ticketmaster&username=johndoe@gmail.com \
  -H 'x-api-token: YOUR_API_TOKEN'

{"result": 
  {
    "status": "success",
    "message": "",
    "messageid": ""
  },
  "output": [{
    "accountid": "847387",
    "userid": "4492",
    "notes": "",
    "active": true,
    "account_username": "sales@anytickets.com",
    "account_password": "",
    "marketplace": {
      "id": "55",
      "name": "OSSHouston Texans"
    },
    "error": {
      "error_datetime": "",
      "error_id": "",
      "error_description": ""
    },
    "quickpo_settings": {
      "custid_skybox": "",
      "creditcardid_skybox": "",
      "custid_posnext": "",
      "creditcardid_posnext": "",
      "custid_core": "",
      "creditcardid_core": "",
      "custid_ticketutils": "",
      "creditcardid_ticketutils": "",
      "custid_ticketnetwork": "",
      "creditcardid_ticketnetwork": "",
      "custid_tradedeskpos": "",
      "creditcardid_tradedeskpos": "",
      "autoposettings": {
        "autopo_skybox": false,
        "autopo_skybox_dateafter": "",
        "autopo_ticketnetwork": false,
        "autopo_ticketnetwork_dateafter": "",
        "autopo_posnext": false,
        "autopo_posnext_dateafter": "",
        "autopo_ticketutils": false,
        "autopo_ticketutils_dateafter": "",
        "autopo_tradedeskpos": false,
        "autopo_tradedeskpos_dateafter": ""
      }
    }
  }]
}

Description

This endpoint is used to get a list of accounts.

HTTP Request

GET http://1ticket.com/api/v2/accounts/list

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Query Parameters

Key	Required	Description
username	No	marketplace username (generally an e-mail address)
marketplaceid	No	marketplace ID (can be found in /v2/marketplaces)
marketplacename	No	name of marketplace (ticketmaster, telecharge, axs, etc)
accountstatus	No	"error message on account. Accepts: locked = locked accounts badpassword = incorrect password phone = phone number required error = any error"
active	No	Accepts true/false

If no fields are supplied all accounts will be returned

GET /v2/domains/list/

import requests

response = requests.get(
  'https://1ticket.com/api/v2/domains/list',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X GET \
  https://1ticket.com/api/v2/domains/list
  -H 'x-api-token: YOUR_API_TOKEN'

{
    "result": {
        "status": "success",
        "message": "",
        "messageid": ""
    },
    "output": [
        {
            "domain_id": "154",
            "domain": "partycentral.com",
            "owned_by": "9147",
            "used_by": "9147",
            "defaults": {
                "password": "",
                "customer_id": "",
                "creditcard_id": ""
            }
        },
        {
            "domain_id": "156",
            "domain": "mydomain.org",
            "owned_by": "9147",
            "used_by": "9147",
            "defaults": {
                "password": "",
                "customer_id": "1111",
                "creditcard_id": "2222"
            }
        }
    ]
}

Description

Returns a list of domains tied to the specified 1Ticket account.

HTTP Request

GET http://1ticket.com/api/v2/domains/list

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Query Parameters

Key	Required	Description
domain	No	domain name (abc123.yxz) to search for

If no fields are supplied all domains will be returned

POST /v2/accounts/add

import requests

response = requests.post(
  'https://1ticket.com/api/v2/accounts/add/?marketplaceid=1&username=johndoe@gmail.com@password=yourpassword',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X POST \
  https://1ticket.com/api/v2/accounts/add/?marketplaceid=1&username=johndoe@gmail.com@password=yourpassword \
  -H 'x-api-token: YOUR_API_TOKEN'

Description

This endpoint is used to add a new marketplace account to 1ticket.

HTTP Request

POST https://1ticket.com/api/v2/accounts/add

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Query Parameters

Key	Required	Description
username	Yes	account username (generally an e-mail address)
marketplaceid	No	marketplace ID (can be found in /v2/marketplaces)
password	No	password of account (required for Ticketmaster)

POST /v2/accounts/update/

import requests

response = requests.post(
  'http://1ticket.com/api/v2/accounts/update/?id=1000&creditcardid_skybox=32266&custid_skybox=123456',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X POST \
  http://1ticket.com/api/v2/accounts/update/?id=1000&creditcardid_skybox=32266&custid_skybox=123456 \
  -H 'x-api-token: YOUR_API_TOKEN'

Description

This endpoint is used to update a marketplace account on 1ticket.

HTTP Request

POST http://1ticket.com/api/v2/accounts/update/

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Query Parameters

Key	Required	Description
id	Yes	account ID (can be found in /v2/accounts/list)
custid_skybox	No	customer/vendor ID in SkyBox
creditcardid_skybox	No	credit card ID in SkyBox
custid_posnext	No	customer/vendor ID in POSNext
creditcardid_posnext	No	credit card ID in POSNext
custid_ticketutils	No	customer/vendor ID in TicketUtils
creditcardid_ticketutils	No	credit card ID in TicketUtils
custid_ticketnetwork	No	customer/vendor ID in TicketNetwork POS
creditcardid_ticketnetwork	No	credit card ID in TicketNetwork POS 11
note	No	note field as viewed on 1ticket.com/logins
password	No	Password to log into the marketplace account

POST /v2/sales/add

import requests
import json

saleRecord = {
    "saleid": "234234324",
    "credid": "4444",
    "posused": "ticketnetworkapi",
    "deliveryformat": "eticket",
    "saledatetime": "10/15/s2018 4:55 PM",
    "marketplaceid": "1",
    "ticketgroupid": "12345678",
    "invoiceid": "99999",
    "inhanddate": "5/25/2019",
    "confirmed": true,
    "fulfilled": false,
    "priceperseat": {
        "list": "200.55",
        "face": "99.20",
        "cost": "125.00"
    },
    "pricepersale": {
        "total": "608.00",
        "fees": "45.00",
        "payout": "590.00"
    },
    "event": {
        "name": "taylor swift",
        "venue": "verizon center",
        "state": "DC",
        "datetimelocal": "1/1/2020 7:30 PM"
    },
    "section": "ORCH",
    "row": "AA",
    "seats": [{
        "seatnumber": "1",
        "seatid": "1000"
    }, {
        "seatnumber": "2",
        "seatid": "1001"
    }, {
        "seatnumber": "3",
        "seatid": "1003"
    }]
}

response = requests.post(
  'https://1ticket.com/api/v2/sales/add',
  data=json.dumps(saleRecord),
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X POST \
  https://1ticket.com/api/v2/sales/add \
  -H 'x-api-token: YOUR_API_TOKEN'
  -d '{
        "saleid": "234234324",
        "credid": "4444",
        "posused": "ticketnetworkapi",
        "deliveryformat": "eticket",
        "saledatetime": "10/15/s2018 4:55 PM",
        "marketplaceid": "1",
        "ticketgroupid": "12345678",
        "invoiceid": "99999",
        "inhanddate": "5/25/2019",
        "confirmed": true,
        "fulfilled": false,
        "priceperseat": {
            "list": "200.55",
            "face": "99.20",
            "cost": "125.00"
        },
        "pricepersale": {
            "total": "608.00",
            "fees": "45.00",
            "payout": "590.00"
        },
        "event": {
            "name": "taylor swift",
            "venue": "verizon center",
            "state": "DC",
            "datetimelocal": "1/1/2020 7:30 PM"
        },
        "section": "ORCH",
        "row": "AA",
        "seats": [{
            "seatnumber": "1",
            "seatid": "1000"
        }, {
            "seatnumber": "2",
            "seatid": "1001"
        }, {
            "seatnumber": "3",
            "seatid": "1003"
        }]
    }'

Description

This endpoint is used to add a sale record to 1Ticket.

HTTP Request

POST https://1ticket.com/api/v2/sales/add

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Body Parameters

Key	Required	Description
saleid	Yes	marketplace saleID
credid	Yes	ID of marketplace credentials as provided by 1Ticket - email support@1ticket.com for your IDs
posused	Yes	the POS where your sale lives. MUST be one of: ticketnetworkapi, skybox, posnext
deliveryformat	Yes	method marketplace expects delivery. MUST be one of: hard, eticket, transfer, barcode, flash, mobileqr, willcall, locaklpickup
saledatetime	Yes	when the sale occurred. mm/dd/yyyy hh:mm am/pm
marketplaceid	Yes	ID of the marketplace (see GET /v2/marketplaces/ for completed list)
ticketgroupid	Yes	ID of ticket group in POS
invoiceid	Yes	ID of invoice is POS
inhanddate	Yes	date when the tickets will be in hand. mm/dd/yyyy
confirmed	Yes	has the sale been confirmed with the marketplace? true/false
fulfilled	Yes	has the sale been fulfilled with the marketplace? true/false
priceperseat.list	Yes	the list price per seat
priceperseat.face	Yes	the face value per seat
priceperseat.cost	Yes	the cost per seat
pricepersale.total	Yes	the total value of the sale as specified by the marketplace
pricepersale.fees	Yes	the total fees taken by the marketplace
pricepersale.payout	Yes	the total payout from the marketplace
event.name	Yes	name of the event
event.venue	Yes	name of the venue
event.state	No	state where the event occurs
event.datetimelocal	Yes	the local date/time of the event. mm/dd/yyyy hh:mm am/pm
section	Yes	section of the seats that sold
row	Yes	row of the seats that sold
seats.seatnumber	Yes	seat number that sold
seats.seatid	Yes	ID of the seat that sold

POST /v2/purchases/recordpo/

import requests

response = requests.post(
  'https://1ticket.com/api/v2/purchases/recordpo/?pos=skybox&po=123456&rid=23332571',
  headers={
    'x-api-token': 'the same as all other APIs'
  }
)

curl -X POST \
  https://1ticket.com/api/v2/purchases/recordpo/?pos=skybox&po=123456&rid=23332571 \
  -H 'x-api-token: the same as all other APIs'

{
  "result": {
    "status": "success",
    "message": "",
    "messageid": ""
  },
  "output": []
}

Description

Record a PO number for a purchase in 1Ticket. This does NOT create a PO - it only adds an existing PO number to 1Ticket for record keeping purposes.

HTTP Request

POST https://1ticket.com/api/v2/purchases/recordpo/

Headers

Key	Required	Description
x-api-token	Yes	the same as all other APIs

Body Parameters

Key	Required	Description
rid	Yes	1Ticket ID of group
posname	Yes	Your POS ("utils", "ticketnetwork", "posnext", "skybox", "tradedesk")
po	Yes	the The PO number that you want recorded in 1Ticket

POST /v2/accounts/update/v2/

import requests

response = requests.post(
  'https://1ticket.com/api/v2/accounts/update/v2/?id=377806&posid=2&autopo=true&autopodateafter=1/7/2020',
  headers={
    'x-api-token': 'YOUR_API_TOKEN'
  }
)

curl -X POST \
  https://1ticket.com/api/v2/accounts/update/v2/?id=377806&posid=2&autopo=true&autopodateafter=1/7/2020 \
  -H 'x-api-token: YOUR_API_TOKEN'

curl -X POST \
  https://1ticket.com/api/v2/accounts/update/v2/ \
  -H 'x-api-token: YOUR_API_TOKEN'
  -d '{
          "result": {
              "status": "success",
              "message": "",
              "messageid": ""
          },
          "output": [{
              "accountid": "377806",
              "userid": "9147",
              "notes": "",
              "active": true,
              "account_username": "support@1ticket.com",
              "account_password": "",
              "marketplace": {
                  "id": "1",
                  "name": "Ticketmaster"
              },
              "error": {
                  "error_datetime": "",
                  "error_id": "",
                  "error_description": ""
              },
              "quickpo_settings": {
                  "custid_skybox": "3000",
                  "creditcardid_skybox": "4000",
                  "custid_posnext": "3040",
                  "creditcardid_posnext": "4040",
                  "custid_core": "",
                  "creditcardid_core": "",
                  "custid_ticketutils": "3040",
                  "creditcardid_ticketutils": "4040",
                  "custid_ticketnetwork": "1000",
                  "creditcardid_ticketnetwork": "2001",
                  "custid_tradedeskpos": "3000",
                  "creditcardid_tradedeskpos": "4000",
                  "autoposettings": {
                      "autopo_skybox": false,
                      "autopo_skybox_dateafter": "1/8/2020",
                      "autopo_ticketnetwork": true,
                      "autopo_ticketnetwork_dateafter": "1/4/2020",
                      "autopo_posnext": false,
                      "autopo_posnext_dateafter": "1/30/2020",
                      "autopo_ticketutils": true,
                      "autopo_ticketutils_dateafter": "1/30/2020",
                      "autopo_tradedeskpos": true,
                      "autopo_tradedeskpos_dateafter": "11/15/2021"
                  }
              }
          }]
      }'

Description

This endpoint is used to update a marketplace account on 1ticket.

HTTP Request

POST https://1ticket.com/api/v2/accounts/update/v2/

Headers

Key	Required	Description
x-api-token	Yes	Your API token

Query Parameters

Key	Required	Description
id	Yes	ID of account in 1Ticket
posid	No	ID of POS settings to update (2=Ticketnetwork, 18=TicketUtils, 22=SkyBox, 47=POSNext, 62=Tradedesk POS
custid	No	Customer ID/vendor ID in POS
creditcardid	No	Credit card ID in POS
autopo	No	true/false - should AutoPO be activated?
autopodateafter	No	1Ticket will start AutoPOing inventory that it finds on the date AFTER the date you provide. if no value is provided it will default to the current date
active	No	true/false - this is the equivalent of clicking "delete" on a login at 1Ticket.com/logins
password	No	Password to log into the marketplace account
note	No	note field as viewed on 1ticket.com/logins

Note: If a valid posid is not provided no POS-specific settings can be applied (AutoPO, custid, creditcardid)

HTTP Request

POST https://apis.dti1ticketapps.com/sales/v1/complete-sale

Headers

Key	Required	Description
x-api-token	Yes	Your API token

curl -X POST \
  https://apis.dti1ticketapps.com/sales/v1/complete-sale \
  -H 'x-api-token: YOUR_API_TOKEN'
  -d '[{
          "user_id": "9003",
          "order_id": "247927697",
          "marketplace_id": 1
      }]'

Note: that this endpoint can take in multiple Sales and mark them “filled”. This also completes the sale on the POS.

Description

It’s a list of an object that contains the ID of the marketplace, the ID of the order on the marketplace and the ID of the user on 1ticket.