Get ticket endpoint

GET `/be/tickets/{identifier}` endpoint

identifier - this could be either ticket id or ticket code.

Response fields for quicktip ticket:

Attribute	Data Type	Description
id	string	Betstack ticket id
code	string	Betstack ticket code
price	integer	Ticket price. Should be in integer format (cents). For example, for price 35.00 the value will be 3500
stake	integer	Ticket amount. Should be in integer format (cents). For example, for stake 30.45 the value should be 3045
currency	string	Currency code in ISO 4217 three letter format
gross_payout	integer	Ticket gross payout. Should be in integer format (cents). For example, for gross payout 30.45 the value should be 3045
net_payout	integer	Ticket net payout. Should be in integer format (cents). For example, for net payout 30.45 the value should be 3045
wht_amount	integer	Player withholding tax amount. Should be in integer format (cents). For example, for withholding tax amount 30.45 the value should be 3045
wht	float	Player withholding tax percentage. For example, for withholding tax percentage 20.0% the value should be 20.0
ext_amount	integer	Ticket exercise tax amount. Should be in integer format (cents). For example, for exercise tax amount 1.25 the value will be 125
ext	float	Ticket exercise tax percentage. For example, for exercise tax percentage 12.5% the value should be 12.5
ext_type	string	Exercise tax type (see Fields)
status	string	Ticket Status (see Fields)
result	string	Ticket Result (see Fields)
approved	bool	Ticket approval (see Fields)
source	string	Ticket source (see Fields)
type	string	Ticket Type (see Fields). Will always contain quicktip
atag	string or null	Optional affilate Tag or Affiliate ID
user_id	string	Betstack user id
created	string	Ticket created datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_starts	string	Ticket created datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
updated	string	Ticket updated datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_updated	string	Ticket updated datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
events	list of objects
events id	integer	Event id
event starts	string	Event start datetime, UTC. Format - 2024-01-28T14:33:01.000000
event opetator_time_starts	string	Event start datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
event sport	object
event sport id	integer	Id of sport event
event sport name	string	Name of sport event
event category	object
event category id	integer	Id of sport category
event category name	string	Name of sport category
event league	object
event league id	integer	Id of league
event league name	string	Name of league
event home_team	object
event home_team id	integer	Id of home team
event home_team name	string	Name of home team
event away_team	object
event away_team id	integer	Id of away team
event away_team name	string	Name of away team
event market	object
event market code	string	Code of market
event market name	string	Name of market
event bet	object
event bet code	string	Code of event bet
event bet name	string	Name of event bet
event line	object
event line code	string	Code of the bet line
event line name	string	Name of the bet line
events odds	float	Event odds. Should be in decimal format with 2 digits after comma
event status	string	Status of the event (see Fields)
event result	string	Result of the event (see Fields)
odds	float	Ticket odds

Sample response (status=200) for quicktip ticket:

{
    "id": "6314704d686a9e8e5d68dca6",
    "code": "E36E20",
    "price": 2000,
    "stake": 1800,
    "currency": "USD",
    "gross_payout": 12000,
    "net_payout": 10000,
    "wht_amount": 1300,
    "wht": 0,
    "ext_amount": 200,
    "ext": 10,
    "ext_type": "inclusive",
    "status": "open",
    "result": "pending",
    "approved": true,
    "source": "desktop",
    "type": "quicktip",
    "atag": "atag_value",
    "user_id": "1660986605374148608",
    "created": "2022-09-04T09:30:53.000000",
    "operator_time_created": "2022-09-04T11:30:53.000000",
    "updated": "2022-09-04T09:30:53.000000",
    "operator_time_updated": "2022-09-04T11:30:53.000000",
    "events": [
        {
            "id": 100001,
            "starts": "2022-09-04T09:30:53.000000",
            "operator_time_starts": "2022-09-04T11:30:53.000000",
            "sport": {
                "id": 101,
                "name": "Football"
            },
            "category": {
                "id": 102,
                "name": "Europe"
            },
            "league": {
                "id": 103,
                "name": "UEFA Europa League"
            },
            "home_team": {
                "id": 1,
                "name": "FC Zurich"
            },
            "away_team": {
                "id": 2,
                "name": "Arsenal"
            },
            "market": {
                "code": "MRFT",
                "name": "Match Result Full Time"
            },
            "bet": {
                "code": "05",
                "name": "0.5"
            },
            "line": {
                "code": "05",
                "name": "0.5"
            },
            "odds": 1.55,
            "status": "not_started",
            "result": "open"
        }
    ],
    "odds": 7.4
}

Response fields for smartbet ticket are the same as for quicktip ticket, except type field will contain smartbet value. All other fields are the same.

Response fields for quickbet ticket are the same as for quicktip ticket, except type field will contain quickbet value. All other fields are the same.

Response fields for superbet ticket:

Attribute	Data Type	Description
id	string	Betstack ticket id
code	string	Betstack ticket code
price	integer	Ticket price. Should be in integer format (cents). For example, for price 35.00 the value will be 3500
stake	integer	Ticket amount. Should be in integer format (cents). For example, for stake 30.45 the value should be 3045
gross_payout	integer	Ticket gross payout. Should be in integer format (cents). For example, for gross payout 30.45 the value should be 3045
net_payout	integer	Ticket net payout. Should be in integer format (cents). For example, for net payout 30.45 the value should be 3045
wht_amount	integer	Player withholding tax amount. Should be in integer format (cents). For example, for tax 30.45 the value should be 3045
wht	float	Player withholding tax percentage. For example, for tax 20.0% the value should be 20.0
ext_amount	integer	Ticket exercise tax amount. Should be in integer format (cents). For example, for exercise tax 1.25 the value will be 125
ext	float	Ticket exercise tax percentage. For example, for tax 12.5% the value should be 12.5
ext_type	string	Exercise tax type (see Fields)
currency	string	Currency code in ISO 4217 three letter format
status	string	Ticket Status (see Fields)
result	string	Ticket Result (see Fields)
approved	bool	Ticket approval (see Fields)
source	string	Ticket source (see Fields)
type	string	Ticket Type (see Fields)
atag	string or null	Optional affilate Tag or Affiliate ID
user_id	string	Betstack user id
created	string	Ticket created datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_created	string	Ticket created datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
updated	string	Ticket updated datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_updated	string	Ticket updated datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
event	object
event id	integer	Event id
event starts	string	Event start datetime, UTC. Format - 2024-01-28T14:33:01.000000
event operator_time_starts	string	Event start datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
event home_team	string	Name of home team
event away_team	string	Name of away team
bets	list of objects
bets id	integer	Id of bet
bets bet_name	string	Name of bet
bets market_code	string	Code of market
bets market_name	string	Name of market
bets result	string	Bet Result (see Fields)

Sample response (status=200) for superbet ticket:

{
    "id": "6314704d686a9e8e5d68dca6",
    "code": "E36E20",
    "price": 2000,
    "stake": 1800,
    "gross_payout": 0,
    "net_payout": 0,
    "wht_amount": 0,
    "wht": 0,
    "ext_amount": 200,
    "ext": 10,
    "ext_type": "inclusive",
    "currency": "USD",
    "status": "resulted",
    "result": "lost",
    "approved": true,
    "source": "desktop",
    "type": "superbet",
    "atag": "atag_value",
    "user_id": "1660986605374148608",
    "created": "2022-09-04T09:30:53.000000",
    "operator_time_created": "2022-09-04T11:30:53.000000",
    "updated": "2022-09-04T09:30:53.000000",
    "operator_time_updated": "2022-09-04T11:30:53.000000",
    "event": {
        "id": 100001,
        "starts": "2022-09-04T09:30:53.000000",
        "operator_time_starts": "2022-09-04T11:30:53.000000",
        "home_team": "Lazio",
        "away_team": "FC Bayern Munich"
    },
    "bets": [
        {
            "id": 101,
            "bet_name": "Home",
            "market_code": "FTSFT",
            "market_name": "First Goal Full Time",
            "result": "pending"
        },
        {
            "id": 102,
            "bet_name": "1-0",
            "market_code": "CSHT",
            "market_name": "Correct Score Half Time",
            "result": "lost"
        },
        {
            "id": 103,
            "bet_name": "Yes",
            "market_code": "BTSFT",
            "market_name": "Both Teams to Score Full Time",
            "result": "pending"
        },
        {
            "id": 104,
            "bet_name": "Second",
            "market_code": "HSH",
            "market_name": "Highest Scoring Half",
            "result": "pending"
        },
        {
            "id": 105,
            "bet_name": "Odd",
            "market_code": "OEFT",
            "market_name": "Odd/Even Full Time",
            "result": "pending"
        },
        {
            "id": 106,
            "bet_name": "2-1",
            "market_code": "CSFT",
            "market_name": "Correct Score Full Time",
            "result": "pending"
        }
    ]
}

Response fields for jackpot ticket:

Attribute	Data Type	Description
id	string	Betstack ticket id
code	string	Betstack ticket code
price	integer	Ticket price. Should be in integer format (cents). For example, for price 35.00 the value will be 3500
stake	integer	Ticket amount. Should be in integer format (cents). For example, for stake 30.45 the value should be 3045
currency	string	Currency code in ISO 4217 three letter format
gross_payout	integer	Ticket gross payout. Should be in integer format (cents). For example, for gross payout 30.45 the value should be 3045
net_payout	integer	Ticket net payout. Should be in integer format (cents). For example, for net payout 30.45 the value should be 3045
wht_amount	integer	Player withholding tax amount. Should be in integer format (cents). For example, for withholding tax amount 30.45 the value should be 3045
wht	float	Player withholding tax percentage. For example, for withholding tax percentage 20.0% the value should be 20.0
ext_amount	integer	Ticket exercise tax amount. Should be in integer format (cents). For example, for exercise tax amount 1.25 the value will be 125
ext	float	Ticket exercise tax percentage. For example, for exercise tax percentage 12.5% the value should be 12.5
ext_type	string	Exercise tax type (see Fields)
status	string	Ticket Status (see Fields)
result	string	Ticket Result (see Fields)
approved	bool	Ticket approval (see Fields)
source	string	Ticket source (see Fields)
type	string	Ticket Type (see Fields). Will always contain jackpot
atag	string or null	Optional affilate Tag or Affiliate ID
user_id	string	Betstack user id
created	string	Ticket created datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_starts	string	Ticket created datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
updated	string	Ticket updated datetime, UTC. Format - 2024-01-28T14:33:01.000000
operator_time_updated	string	Ticket updated datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
events	list of objects
events id	integer	Event id
event starts	string	Event start datetime, UTC. Format - 2024-01-28T14:33:01.000000
event opetator_time_starts	string	Event start datetime, operator timezone. Format - 2024-01-28T14:33:01.000000
event sport	object
event sport id	integer	Id of sport event
event sport name	string	Name of sport event
event category	object
event category id	integer	Id of sport category
event category name	string	Name of sport category
event league	object
event league id	integer	Id of league
event league name	string	Name of league
event home_team	object
event home_team id	integer	Id of home team
event home_team name	string	Name of home team
event away_team	object
event away_team id	integer	Id of away team
event away_team name	string	Name of away team
event market	object
event market code	string	Code of market
event market name	string	Name of market
event bet	object
event bet code	string	Code of event bet
event bet name	string	Name of event bet
event line	object
event line code	string	Code of the bet line
event line name	string	Name of the bet line
events odds	float	Event odds. Should be in decimal format with 2 digits after comma
event status	string	Status of the event (see Fields)
event result	string	Result of the event (see Fields)
betcard_code	string	Betcard code
prize	integer	Betcard prize
bonus_prizes	list of integers	Betcard bonus prizes

Sample response (status=200) for jackpot ticket:

{
    "id": "66e393ea19adab3ab258cb34",
    "code": "4AAFE4",
    "price": 500,
    "stake": 444,
    "currency": "USD",
    "gross_payout": 0,
    "net_payout": 0,
    "wht_amount": 0,
    "wht": 20,
    "ext_amount": 56,
    "ext": 12.5,
    "ext_type": "inclusive",
    "status": "open",
    "result": "pending",
    "approved": true,
    "source": "desktop",
    "type": "jackpot",
    "atag": "atag_value",
    "user_id": "sometokenvalue",
    "created": "2024-09-13T01:22:50.507000",
    "operator_time_created": "2024-09-13T01:22:50.507000",
    "updated": "2024-09-13T01:22:50.532000",
    "operator_time_updated": "2024-09-13T01:22:50.532000",
    "events": [
        {
            "id": 317299,
            "starts": "2024-09-14T10:00:00.000000",
            "operator_time_starts": "2024-09-14T10:00:00.000000",
            "sport": {
                "id": 10000,
                "name": "Football"
            },
            "category": {
                "id": 1410000,
                "name": "Kenya"
            },
            "league": {
                "id": 11130000,
                "name": "KPL"
            },
            "home_team": {
                "id": 1062240000,
                "name": "Nairobi City Stars"
            },
            "away_team": {
                "id": 1069080000,
                "name": "Bidco United"
            },
            "market": {
                "code": "MRFT",
                "name": "Match Result Full Time"
            },
            "bet": {
                "code": "1",
                "name": "Home"
            },
            "line": null,
            "odds": 2.35,
            "status": "not_started",
            "result": "open"
        },
        {
            "id": 317298,
            "starts": "2024-09-13T21:45:00.000000",
            "operator_time_starts": "2024-09-13T21:45:00.000000",
            "sport": {
                "id": 10000,
                "name": "Football"
            },
            "category": {
                "id": 2280000,
                "name": "Venezuela"
            },
            "league": {
                "id": 16720000,
                "name": "Primera Division"
            },
            "home_team": {
                "id": 1103400000,
                "name": "Metropolitanos FC"
            },
            "away_team": {
                "id": 104407,
                "name": "Portuguesa"
            },
            "market": {
                "code": "DCFT",
                "name": "Double Chance Full Time"
            },
            "bet": {
                "code": "12",
                "name": "Home/Away"
            },
            "line": null,
            "odds": 1.22,
            "status": "not_started",
            "result": "open"
        },
        {
            "id": 317297,
            "starts": "2024-09-14T10:00:00.000000",
            "operator_time_starts": "2024-09-14T10:00:00.000000",
            "sport": {
                "id": 10000,
                "name": "Football"
            },
            "category": {
                "id": 2060000,
                "name": "South Korea"
            },
            "league": {
                "id": 15120000,
                "name": "K3 League"
            },
            "home_team": {
                "id": 1087600000,
                "name": "Ulsan Citizen"
            },
            "away_team": {
                "id": 1087580000,
                "name": "Hwaseong"
            },
            "market": {
                "code": "DCFT",
                "name": "Double Chance Full Time"
            },
            "bet": {
                "code": "12",
                "name": "Home/Away"
            },
            "line": null,
            "odds": 1.2,
            "status": "not_started",
            "result": "open"
        }
    ],
    "betcard_code": "ABC123",
    "prize": 10000,
    "bonus_prizes": [
        2000,
        1500,
        1000
    ]
}

Response status codes:

Status Code	Interpretation
200	OK - Everything worked as expected
400	Bad Request. Please check error code in response body (see Error codes)
403	Forbidden. You do not have access for such request
422	Validation Error. Please check response body for more details

Error response (status=400):

{
    "code": 100,
    "message": "Feature not implemented yet"
}

Error response (status=400):

{
    "code": 102,
    "message": "Ticket with {ticket-id} identifier is not found"
}

Error response (status=400):

{
    "code": 112,
    "message": "Operator with `{operator-id}` name is not found"
}