# tinker.types.CheckpointSearchRequest

*Generated from tinker 0.39.0 at commit [`4801e02`](https://github.com/thinking-machines-lab/tinker/tree/4801e02f551a41dc81476ab49c1a7af200d21fb3). Source links point at that snapshot.*

## *class* [**tinker.types.CheckpointSearchRequest**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L11)(*[StrictBase](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/_models.py#L76)*)

A checkpoint search. Results are restricted to projects the caller may list.

**Fields:**

- [**project_ids**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L14) (*[list](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/cli/commands/run.py#L221)[str] | None*) – Projects to search; None searches every listable project. Naming a project the caller cannot list is an error
- [**user_metadata**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L18) (*dict[str, str]*) – Exact user_metadata key/value matches; every pair must hold
- [**checkpoint_type**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L21) (*[CheckpointType](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint.py#L8) | None*) – Checkpoint type to match; None matches every type
- [**owner**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L24) (*[SearchOwner](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/search_owner.py#L32)*) – Whose checkpoints to search; defaults to the caller's own
- [**base_models**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L27) (*[list](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/cli/commands/run.py#L221)[str] | None*) – Match any listed base model; None matches every base model. An empty list matches no checkpoints
- [**limit**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L31) (*int*) – Page size, 1 to 200
- [**cursor**](https://github.com/thinking-machines-lab/tinker/blob/4801e02f551a41dc81476ab49c1a7af200d21fb3/src/tinker/types/checkpoint_search_request.py#L34) (*[CheckpointSearchCursor](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/types/checkpointsearchcursor/index.md) | None*) – `next_cursor` of the previous page; None for the first page

## Referenced by

- [RestClient.search_checkpoints](https://tinker-docs.thinkingmachines.ai/tinker/api-reference/restclient/#search_checkpoints)