Mark objects as for sale

Rate limits

This endpoint does not belong to the priority lane. Do not use it within your ticket sales flow.

This API call marks the passed in objects, area places and categories as for sale, while marking all other objects as not for sale.

Text

POST https://api-{region}.seatsio.net/events/{eventKey}/actions/mark-as-for-sale

PHP

$seatsioClient->events->markAsForSale("event34", ["A-1", "A-2"], [ "GA1" => 3], ["category1", "category2"]);

C#

await Client.Events.MarkAsForSaleAsync("event34", new [] { "A-1", "A-2" }, new () {{ "GA1", 3 }}, new [] { "category1", "category2" });

Java

client.events.markAsForSale("event34", List.of("A-1", "A-2"), Map.of("GA1", 3), List.of("category1", "category2"));

Python

client.events.mark_as_for_sale("event34", objects=["A-1", "A-2"], area_places={"GA1": 3}, categories=["category1", "category2"])

Ruby

client.events.mark_as_for_sale key: 'event34', objects: ['A-1', 'A-2'], area_places: {'GA1' => 3}, categories: ['category1', 'category2']

Javascript

await client.events.markAsForSale('eventKey', ['A-1', 'A-2'], { 'GA1': 3 }, ['category1', 'category2']);

Go

err = client.Events.MarkAsForSale("eventKey", &events.ForSaleConfigParams{
    Objects:    []string{"A-1", "A-2"},
    AreaPlaces: map[string]int{"GA1": 3},
    Categories: []string{"category1", "category2"},
})

Request

{
    "objects": ["A-1", "A-2"],
    "areaPlaces": {"GA1":  3},
    "categories": ["category1", "category2"]
}

• objects: optional array of strings. Can contain table labels, booth labels, area labels or seat labels.
• areaPlaces: optional object, which indicates how many places per general admission area should be for sale. An area can also be passed into objects. In that case, it's made completely for sale.
• categories: optional array of strings. Can contain category keys or labels.

Only objects that satisfy objects, areaPlaces or categories will become selectable (and bookable). All other objects are not selectable, and trying to book them results in a bad request.

Note that even though object is marked for sale, it's still not selectable if its status is not free.

Examples

To mark seats A-1 and A-2 for sale:

{
    "objects": ["A-1", "A-2"]
}

To mark 10 places in GA1 as for sale:

{
  "areaPlaces": {"GA1":  10}
}

To mark all objects in category 'category1' for sale:

{
    "categories": ["category1"]
}

Example request

curl https://api-{region}.seatsio.net/events/event34/actions/mark-as-for-sale \
-u aSecretKey: -X POST -H 'Content-Type: application/json' -d '{"objects": ["A-1", "A-2"]}'

Response

{
    "rateLimitRemainingCalls": 9,
    "rateLimitResetDate": "2021-10-01T23:00:00Z"
}

Warning

There's a rate limit of 10 calls per day per event. If that rate limit if reached, a 429 (Too Many Requests) is returned. The Retry-After header indicates how many seconds you have to wait before trying again.