---
title: "Get a splat owned by the authenticated caller"
method: GET
path: "/v1/splats/{splatId}"
tags: ["Splats"]
---

# Get a splat owned by the authenticated caller

`GET /v1/splats/{splatId}`

## Request

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

Returns a single splat owned by the authenticated user. Newly completed uploads may return `status: "processing"` until processing finishes.

## Path parameters

- `splatId` string, required: Opaque public splat id.

## Response `200`

Splat

- Splat: Splat scene 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.

## Other responses

- `401`: Authentication required
- `403`: Forbidden
- `404`: Not found
- `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)