---
title: "get multiple diagrams"
method: GET
path: "/4.0/diagrams"
tags: ["Diagrams"]
---

# get multiple diagrams

`GET /4.0/diagrams`

## Query parameters

- `ids` string
- `event` string
- `space` integer
- `guestlist` string
- `legacy_event` integer
- `fields` string
- `external_diagram_id` string
- `external_event_id` string
- `limit` integer
- `offset` integer

## Response `200`

returns an array of diagrams

- DiagramsDiagramResponseDiagramService[]
  - `id` string
  - `updated_at` string
  - `created_at` string
  - `chair_count` integer
  - `space_id` integer
  - `session_id` string
  - `event_id` string
  - `legacy_event_id` integer
  - `team_id` string — A legacy (v2) team id.
  - `floor_elements` object
  - `groups` object
  - `sections` object
  - `boundary_visibility` DiagramsComponents1boundaryVisibilityDiagramService — unresolved $ref
  - `deleted` boolean
  - `external_diagram_id` string
  - `external_event_id` string
  - `floorPlan` FloorPlansFloorPlanDiagramService
    - `type` 'bookableRoom' | 'spaceTemplate' | 'image' | 'background'
    - `id` integer
    - `url` string
    - `background_type` string
  - `guestlist_id` string
  - `length` number
  - `name` string
  - `notes` string
  - `prefunction_perimeter` number
  - `rotation` number
  - `service_perimeter` number
  - `sort_order` number
  - `table_numbering` DiagramsTableNumberingDiagramService
    - `allowRepeats` boolean
    - `evenOnly` boolean
    - `oddOnly` boolean
    - `skipNumbers` integer[]
    - `skipNumbersWith` integer[]
    - `startingNumber` integer
  - `team_uploads_id` string
  - `update_id` string
  - `width` number
  - `start_datetime` string, date-time
  - `end_datetime` string, date-time

## Other responses

- `400` — validation error must specify either event, space, or guestlist

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/revisions/221c9d836cf0/schema)