---
title: "List splats owned by the authenticated caller"
method: GET
path: "/v1/splats"
tags: ["Splats"]
---

# List splats owned by the authenticated caller

`GET /v1/splats`

## Request

- Base URL: `https://playcanvas.com/api/supersplat`
- URL: `https://playcanvas.com/api/supersplat/v1/splats`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/playcanvas/apis/supersplat-api/docs/v1/splats/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of splats owned by the authenticated user. The response uses `visibility`; there is no separate `listed` boolean in this API.

## Query parameters

- `limit` integer: Maximum number of splats to return.
- `skip` integer: Number of splats to skip.

## Response `200`

Caller splats

- SplatList: Paginated splat list.
  - `data` Splat[], required: Splats owned by the authenticated user.
    - `id` string, required: Public 8-character splat id.
    - `title` string, required: Display title.
    - `description` string, required: Display description.
    - `status` 'processing' | 'completed' | 'failed', required: Publish lifecycle state of the splat.
    - `visibility` 'listed' | 'unlisted', required: Whether the splat is listed publicly or only reachable by direct link.
    - `format` string, nullable, required: Published output format once processing completes. `null` while processing.
    - `size` integer, required: Published splat size in bytes. Processing splats may report `0` until output is available.
    - `viewerUrl` string, required: URL where the splat can be viewed.
    - `createdAt` string, date-time, nullable, required: Creation timestamp.
    - `updatedAt` string, date-time, nullable, required: Last update timestamp.
    - `completedAt` string, date-time, nullable, required: Processing completion timestamp, or `null` while processing.
  - `pagination` object, required
    - `skip` integer, required: Number of splats skipped.
    - `limit` integer, required: Maximum number of splats requested.
    - `total` integer, required: Total matching splats owned by the caller.

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate limited

---

[API](https://skmtc.dev/playcanvas/apis/supersplat-api.md) - [All operations](https://skmtc.dev/playcanvas/apis/supersplat-api/llms.txt) - [OpenAPI document](https://skmtc.dev/playcanvas/apis/supersplat-api/revisions/a0f996dcea93?raw)