Skip to main content
POST
Swap reseller ticket

Authorizations

Authorization
string
header
required

Reseller API key, sent raw in the Authorization header: Authorization: rs_live_xxxxxxxxxxxxxxxx. Keys prefixed rs_test_ operate against the test environment. The same key serves v2 and the swap operations, and it only reaches the organizations Fourvenues authorized on it.

Body

application/json
ticket
object

The ticket to swap, plus what it was resold for. A single object: send one request per barcode.

customer
object

Response

Swap performed, or refused by a resale rule

id
string
Example:

"abcdefghijk1234567890"

barcode
string
Example:

"ABCD1235"

pdf
string<uri>
Example:

"https://cdn.fourvenues.com/abcdefghijk1234567890-ABCD1235.pdf"

valid
boolean

Only present when the swap was refused.

Example:

true

swappable
boolean

Only present when the swap was refused. Always false there.

Example:

false

error
enum<string>

Only present when the swap was refused. Names the rule that blocked it.

Available options:
RESELL_PENDING_NAME_CHANGE,
RESELL_ALREADY_RESOLD,
RESELL_NOT_SWAPPABLE
Example:

"RESELL_ALREADY_RESOLD"