---
title: "List a sandbox's shared service URLs"
method: GET
path: "/api/v2/sandboxes/boxes/{name}/service-urls"
tags: ["sandboxes"]
---

# List a sandbox's shared service URLs

`GET /api/v2/sandboxes/boxes/{name}/service-urls`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v2/sandboxes/boxes/{name}/service-urls`
- Auth: one of:
  - API key in header `X-API-Key` and API key in header `X-Tenant-Id`
  - HTTP bearer and API key in header `X-Tenant-Id`

Returns one entry per port the sandbox is currently reachable on, so a caller can see what is shared before turning it off. Expired token grants are omitted.
Cursors are opaque and only valid on this endpoint; do not parse or construct one.

## Path parameters

- `name` string, required

## Query parameters

- `page_size` integer
- `cursor` string

## Response `200`

OK

- SandboxesServiceURLGrantListResponse
  - `items` SandboxesServiceURLGrantResponse[], required: This page of the ports the sandbox is shared on.
    - `access` 'token' | 'restricted' | 'workspace', required: How the port is shared: "token" for a minted service token, or "restricted"/"workspace" for LangSmith login.
    - `created_at` string, date-time, required
    - `created_by` string, uuid: The LangSmith user who first shared this port, when known.
    - `embed_origins` string[]: Origins that may embed a LangSmith login URL in an iframe; omitted when there are none.
    - `expires_at` string, date-time: When the share expires. Set only for "token"; a login grant does not expire.
    - `port` integer, required
  - `next_cursor` string, nullable, required: Cursor for the next page, or null on the last page. A non-null value is the only signal that more pages exist. Treat it as opaque.

## Other responses

- `400`: invalid page_size or cursor
- `401`: missing or invalid authentication
- `403`: forbidden (insufficient permission)
- `404`: sandbox not found
- `500`: internal server error

## Changes

- **2026-10-21** `016683c2a6e3`: 1 info
  - added the optional property `items/items/embed_origins` to the response with the `200` status
- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v2/sandboxes/boxes/:name/service-urls/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)