Skip to main content

List all charts

Returns a paginated list of charts you’ve previously created in a workspace. The charts are returned in reverse chronological order: the most recently created charts will appear first in the list.

GET https://api-{region}.seatsio.net/charts

GET https://api-{region}.seatsio.net/charts?filter=london
GET https://api-{region}.seatsio.net/charts?tag=WestEnd
GET https://api-{region}.seatsio.net/charts?expand=events&expand=validation&expand=venueType&expand=zones

More info: https://docs.seats.io/docs/api-pagination
Note

The maximum number of charts that can be retrieved in a single request is 20.

An example​

curl https://api-{region}.seatsio.net/charts -u aSecretKey: 
{
    "next_page_starts_after": 12,
    "items": [
        {
            "name":"chart1",
            "id":"20",
            "key":"6451436c-24fb-11e7-93ae-92361f002671",
            "status":"PUBLISHED",
            "tags": [],
            "archived": false,
            "publishedVersionThumbnailUrl": "https://thumbnails.seats.io/workspaceKey/.../published/.../thumbnail"
        },
        {
            "name":"chart2",
            "id":"19",
            "key":"749b9650-24fb-11e7-93ae-92361f002671",
            "status":"PUBLISHED_WITH_DRAFT",
            "tags": ["tag1", "tag2"],
            "archived": false,
            "publishedVersionThumbnailUrl": "https://thumbnails.seats.io/workspaceKey/.../published/.../thumbnail",
            "draftVersionThumbnailUrl": "https://thumbnails.seats.io/workspaceKey/.../draft/.../thumbnail"
        }
    ]
}

The status of a chart can be either

  • "NOT_USED": there are no events linked to the chart
  • "PUBLISHED": there's an event linked to the chart, and there's no draft version
  • "PUBLISHED_WITH_DRAFT": there's an event linked to the chart, and a draft version exists

publishedVersionThumbnailUrl (and draftVersionThumbnailUrl if applicable) are URLs that return a PNG thumbnail for the chart.

Query parameters​

This is a paginated API endpoint, so the normal pagination query params (limit, start_after_id and end_before_id) are applicable. See this page for more info.

  • filter (optional)
    Allows you to filter on chart name (case insensitive). Specifying multiple filters will result in a 400 Bad Request.

  • tag (optional)
    Return only charts that have this tag. Specifying multiple tags will result in a 400 Bad Request.

  • expand (optional) Allow returning extra information about the chart:

  • expand=events
  • expand=validation
  • expand=venueType
  • expand=zones

These parameters can be combined:

  • expand=events&expand=validation&expand=venueType&expand=zones
  • eventsLimit (optional) The maximum number of events to retrieve per chart, when expand=events is also passed in. Defaults to 10. Cannot be more than 10. If you need more, please use the List events endpoint. 
// newest charts having 'london' in their name
$seatsioClient->charts->listFirstPage((new ChartListParams())->withFilter('london')); 

// newest charts tagged 'WestEnd'
$seatsioClient->charts->listFirstPage((new ChartListParams())->withTag('WestEnd')); 

// newest charts, together with validation errors and warnings
$seatsioClient->charts->listFirstPage((new ChartListParams())->withExpandValidation(true)); 

// newest charts and a list of linked events
$seatsioClient->charts->listFirstPage((new ChartListParams())->withExpandEvents(true)); 

// newest charts and venue types
$seatsioClient->charts->listFirstPage((new ChartListParams())->withExpandVenueType(true));
 
 // newest charts and zones
$seatsioClient->charts->listFirstPage((new ChartListParams())->withExpandZones(true)); 
{
    "items": [
        {
            "name":"chart1",
            "id":"20",
            "key":"6451436c-24fb-11e7-93ae-92361f002671",
            "status":"PUBLISHED",
            "archived": false,
            "publishedVersionThumbnailUrl": "https://thumbnails.seats.io/workspaceKey/.../published/.../thumbnail",
            "events": [
                {
                    "id": "50",
                    "bookWholeTables": false,
                    "key": "eventKey2"
                },
                {
                    "id": "49",
                    "bookWholeTables": false,
                    "key": "event34"
                }
            ],
            "validation": {
              "errors": ["VALIDATE_OBJECTS_WITHOUT_CATEGORIES"],
              "warnings": ["VALIDATE_DUPLICATE_LABELS"]
            },
            "venueType": "SIMPLE"
        },
        {
            "name":"chart2",
            "id":"19",
            "key":"749b9650-24fb-11e7-93ae-92361f002671",
            "status":"NOT_USED",
            "archived": false,
            "publishedVersionThumbnailUrl": "https://thumbnails.seats.io/workspaceKey/.../published/.../thumbnail"
        }
    ]
}