Source: https://developers.woosmap.com/api-reference/datasets-api/get-datasets/

> For clean Markdown of any page, append `.md` to the page URL.

> For a complete documentation index, see https://developers.woosmap.com/llms.txt

# List Datasets



# List Datasets

 GET 
https://api.woosmap.com/datasets

Lists datasets.

**Rate limit** : `1/1s`

**Ratelimit:** 1/1s

### Authorization

[`private_key`](#authorization-datasets-privatekeywithwrite)
apiKeyquery

Private key with write permission. Must stay private.

[`X-Api-Key`](#authorization-datasets-privatekeywithwriteheader)
apiKeyheader

Private key with write permission. Must stay private.

### Query Parameters

[`per_page`](#query-per-page)
integerDefaults to `10`

The maximum number of elements to return in a result page.

[`page`](#query-page)
integerDefaults to `1`

The result page to fetch.

### Response

200application/json

Successful Response

[`datasets`](#resp-200-datasets)
object[]required

#Show 5 propertiesHide 5 properties

datasets.[`id`](#resp-200-datasets-id)
string (uuid)required

datasets.[`name`](#resp-200-datasets-name)
stringrequired

datasets.[`created_at`](#resp-200-datasets-created-at)
string (date-time)required

The date when the dataset was created.

datasets.[`updated_at`](#resp-200-datasets-updated-at)
string

The date when the dataset was last updated.

datasets.[`scheduled_for_deletion_after`](#resp-200-datasets-scheduled-for-deletion-after)
string

After this date the dataset will be automatically removed

[`pagination`](#resp-200-pagination)
objectrequired

Pagination represents page information.

#Show 3 propertiesHide 3 properties

pagination.[`prev`](#resp-200-pagination-prev)
integer

The previous page number if any.

pagination.[`next`](#resp-200-pagination-next)
integer

The next page number if any.

pagination.[`page`](#resp-200-pagination-page)
integerrequired

The current page number.

### Errors

#401

Unable to locate credentials.

 

`application/json`

[`detail`](#err-401-detail)
stringrequired

#402

Out of free quota.

 

`application/json`

[`detail`](#err-402-detail)
stringrequired

#403

Credentials found, but not matching.

 

`application/json`

[`detail`](#err-403-detail)
stringrequired

#422

Validation Error

 

`application/json`

[`detail`](#err-422-detail)
object[]

Show 3 propertiesHide 3 properties

detail.[`loc`](#err-422-detail-loc)
any[]required

detail.[`msg`](#err-422-detail-msg)
stringrequired

detail.[`type`](#err-422-detail-type)
stringrequired

#429

Rate limit reached

 

`application/json`

[`details`](#err-429-details)
stringrequired

```shell
curl -L 'https://api.woosmap.com/datasets/?private_key=YOUR_PRIVATE_API_KEY'
```

```javascript
const requestOptions = {
  method: "GET",
  redirect: "follow"
};

fetch("https://api.woosmap.com/datasets/?private_key=YOUR_PRIVATE_API_KEY", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));
```

```python
import requests

url = "https://api.woosmap.com/datasets/?private_key=YOUR_PRIVATE_API_KEY"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
```