---
title: "Collection.find"
description: "Find a specific datapoint in a collection by its id."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Collection.find

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```python
def Collection.find(
    datapoint_id: str,
    skip_data: bool = False
) -> xarray.Dataset
```

Find a specific datapoint in a collection by its id.

## Parameters

**datapoint_id**

type: str

The id of the datapoint to find.

**skip_data**

type: bool

If `True`, the response contains only the ID and the timestamp for the datapoint. Defaults to `False`.

## Returns

An [`xarray.Dataset`](/docs/sdks/python/xarray) containing the requested data point.

Since it returns only a single data point, the output xarray dataset does not include a `time` dimension.

## Errors

**NotFoundError**

type: "No

">
The specified datapoint does not exist in this collection.

<h2 id="request-example">Usage example</h2>

```python
data = collection.find(
    "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
)


# check if a datapoint exists
from tilebox.datasets.sync.dataset import (
    NotFoundError,
)

try:
    collection.find(
        "0186d6b6-66cc-fcfd-91df-bbbff72499c3",
        skip_data=True,
    )
    exists = True
except NotFoundError:
    exists = False
```

Source: https://tilebox.com/docs/api-reference/python/tilebox.datasets/Collection.find/index.mdx