---
title: "Retrieve data"
method: GET
path: "/tables/{tablename}/tuples"
tags: ["v1.0", "v1.1"]
---

# Retrieve data

`GET /tables/{tablename}/tuples`

## Request

- Base URL: `https://docs.tibco.com/lv/api/v1`
- URL: `https://docs.tibco.com/lv/api/v1/tables/{tablename}/tuples`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tibco/apis/liveview-rest-api/docs/tables/:tablename/tuples/get.ts> (a function with typed inputs; its response is checked against the schema)

Issue a snapshot query on the given table, with optional query.

## Path parameters

- `tablename` string, required

## Query parameters

- `query` string
- `include-internal` boolean

## Response `200`

JSON data, based on header

- object[]
  - `type` 'add' | 'remove' | 'update' | 'begin_snapshot' | 'end_snapshot' | 'begin_delete' | 'end_delete' | 'exception' | 'heartbeat', required
  - `key` string: Opaque index/ID
  - `data` object: Tuple

## Other responses

- `401`: Missing authentication
- `403`: User doesn't have required permissions
- `404`: Invalid table name
- `422`: Invalid Query/Non-liveview table

---

[API](https://skmtc.dev/tibco/apis/liveview-rest-api.md) - [All operations](https://skmtc.dev/tibco/apis/liveview-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tibco/apis/liveview-rest-api/revisions/fca44d5426d9?raw)