---
title: "List registries"
method: GET
path: "/api/v2/sandboxes/registries"
tags: ["sandboxes"]
---

# List registries

`GET /api/v2/sandboxes/registries`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v2/sandboxes/registries`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in header `X-Tenant-Id`
  - HTTP bearer

List sandbox registries for pulling private images.
Page with page_size and cursor, replaying next_cursor until it is null. Results are ordered newest first, with stable ordering for equal creation times. Keep filters unchanged between pages.
Requests without page_size or cursor retain the legacy default of 50 results. Cursor requests default to 20 results, with a maximum of 100.

## Query parameters

- `page_size` integer
- `cursor` string
- `limit` integer
- `offset` integer
- `name_contains` string

## Response `200`

OK

- SandboxesRegistryListResponse
  - `items` SandboxesRegistryResponse[]
    - `auth_type` 'DOCKER_CONFIG' | 'AWS_ROLE'
    - `aws_role_arn` string
    - `created_at` string
    - `created_by` string
    - `id` string
    - `name` string
    - `provider` 'DOCKER_REGISTRY' | 'HARBOR' | 'GHCR' | 'ECR' | 'GAR' | 'DOCKER_HUB'
    - `repository_search_mode` 'GLOBAL' | 'SCOPED' | 'NONE'
    - `updated_at` string
    - `updated_by` string
    - `url` string
  - `next_cursor` string, nullable
  - `offset` integer: Deprecated: only applies to limit/offset requests. Use next_cursor when paging with a cursor.
  - `registries` SandboxesRegistryResponse[]: Deprecated: use items.
    - `auth_type` 'DOCKER_CONFIG' | 'AWS_ROLE'
    - `aws_role_arn` string
    - `created_at` string
    - `created_by` string
    - `id` string
    - `name` string
    - `provider` 'DOCKER_REGISTRY' | 'HARBOR' | 'GHCR' | 'ECR' | 'GAR' | 'DOCKER_HUB'
    - `repository_search_mode` 'GLOBAL' | 'SCOPED' | 'NONE'
    - `updated_at` string
    - `updated_by` string
    - `url` string

## Other responses

- `400`: invalid cursor pagination or mixed pagination parameters
- `403`: Forbidden
- `422`: out-of-range legacy limit or offset
- `500`: Internal Server Error

## Changes

- **2026-10-21** `4e648664140a`: 5 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `page_size`
  - added the non-success response with the status `422`
  - added the optional property `items` to the response with the `200` status
  - …1 more
- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v2/sandboxes/registries/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)