Skip to main content
Charts are the reusable venue layouts stored in the Seats.io workspace. Each chart is designed once in the Seats.io chart designer and then instantiated as a Seats.io event every time a TMT event uses that venue.
A chart ID identifies the reusable venue layout. A Seats.io event ID (also called event_id in these functions) identifies a specific instance of that chart for one TMT event. These are different identifiers — most chart management functions take a chart_id, while seat-level operations take an event_id.

​
List all charts

list_charts_seatsio retrieves every chart in the Seats.io workspace. 
POST /list_charts_seatsio
Content-Type: application/json
This function takes no request body.

​
Response fields

​
data.charts
array
Array of chart objects from the Seats.io workspace. Each object contains the chart metadata returned by the Seats.io API, including id, key, name, status, tags, publishedVersionThumbnailUrl, and draftVersionThumbnailUrl.
Success (200) 
{
  "message": "Listado de Venues en Seatsio",
  "status": 200,
  "data": {
    "charts": [
      {
        "id": 1024,
        "key": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "name": "Teatro Metropolitano",
        "status": "published",
        "tags": ["teatro", "bogota"],
        "publishedVersionThumbnailUrl": "https://thumbnails.seats.io/...",
        "draftVersionThumbnailUrl": null
      }
    ]
  }
}

​
Get published chart thumbnail

published_charts_seatsio retrieves the published version thumbnail for a specific chart. 
POST /published_charts_seatsio
Content-Type: application/json

{
  "data": {
    "chart_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
Request parameters

​
data.chart_id
string
required
The unique key of the chart in the Seats.io workspace. Found in the key field of the chart object returned by list_charts_seatsio.

​
Response fields

​
data.charts
object
The published version thumbnail data returned by Seats.io for the requested chart, including the thumbnail URL and associated metadata.
Success (200) 
{
  "message": "Version Publicada",
  "status": 200,
  "data": {
    "charts": {
      "thumbnailUrl": "https://thumbnails.seats.io/workspaces/abc/charts/a1b2c3d4/published/thumbnail"
    }
  }
}

​
List objects in a chart

list_objects_charts_seatsio returns a summary of all seat objects in a chart, grouped by category label. Use this to inspect sections and GA areas before creating an event or listing available seat categories. 
POST /list_objects_charts_seatsio
Content-Type: application/json

{
  "data": {
    "chart_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
Request parameters

​
data.chart_id
string
required
The unique key of the chart to inspect.

​
Response fields

​
data.summary_object
object
A summary keyed by category label. Each key maps to an object describing the count and status breakdown of seats in that category.
Success (200) 
{
  "message": "Listado de Objetos en Seatsio",
  "status": 200,
  "data": {
    "summary_object": {
      "VIP": {
        "count": 50,
        "byStatus": {
          "free": 50,
          "booked": 0,
          "held": 0
        }
      },
      "General": {
        "count": 500,
        "byStatus": {
          "free": 480,
          "booked": 20,
          "held": 0
        }
      }
    }
  }
}
Use list_objects_charts_seatsio to validate category names before passing them as zone labels in TMT ticket generation. The category labels in Seats.io should match the zone names in your TMT event configuration.

​
Add tags to a chart

add_tags_to_chart_seatsio adds one or more tags to a chart for organisation and filtering in the Seats.io dashboard. 
POST /add_tags_to_chart_seatsio
Content-Type: application/json

{
  "data": {
    "chart_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tags": ["bogota", "teatro", "temporada-2025"]
  }
}

​
Request parameters

​
data.chart_id
string
required
The unique key of the chart to tag.
​
data.tags
array
required
Array of tag strings to add. Each tag is applied to the chart in sequence. Tags are additive — existing tags are not removed.

​
Response fields

​
data.tags
array
The array of tags that were added, as provided in the request.
Success (200) 
{
  "message": "Tags agregados al chart en Seatsio",
  "status": 200,
  "data": {
    "tags": ["bogota", "teatro", "temporada-2025"]
  }
}

​
Remove tags from a chart

remove_tags_from_chart_seatsio removes one or more tags from a chart. 
POST /remove_tags_from_chart_seatsio
Content-Type: application/json

{
  "data": {
    "chart_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "tags": ["temporada-2025"]
  }
}

​
Request parameters

​
data.chart_id
string
required
The unique key of the chart to remove tags from.
​
data.tags
array
required
Array of tag strings to remove. Each tag is removed from the chart in sequence. Tags not present on the chart are silently ignored.

​
Response fields

​
data.tags
array
The array of tags that were removed, as provided in the request.
Success (200) 
{
  "message": "Tags removidos del chart en Seatsio",
  "status": 200,
  "data": {
    "tags": ["temporada-2025"]
  }
}

​
Copy a chart

copy_chart_seatsio creates a full duplicate of an existing chart in the Seats.io workspace. Use this to create a new venue layout based on an existing one without modifying the original. 
POST /copy_chart_seatsio
Content-Type: application/json

{
  "data": {
    "chart_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

​
Request parameters

​
data.chart_id
string
required
The unique key of the chart to duplicate.

​
Response fields

​
data.copy_chart
object
The newly created chart object returned by Seats.io. Contains the same fields as a regular chart object (id, key, name, status, tags, etc.) with a new key and a name prefixed with "Copy of ".
Success (200) 
{
  "message": "Chart copiado en Seatsio",
  "status": 200,
  "data": {
    "copy_chart": {
      "id": 1025,
      "key": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
      "name": "Copy of Teatro Metropolitano",
      "status": "published",
      "tags": []
    }
  }
}
The copied chart inherits the layout of the original but does not inherit events. You must create a new Seats.io event (create_event_seatsio) against the copied chart’s key before it can be used for seat reservations.

Build docs developers (and LLMs) love

Get started for freeTalk to us