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

# Quick Start

> Get started with the Poelis Public API in minutes

Get up and running with the Poelis Public API in just a few steps.

## Prerequisites

* A Poelis account and a **REST API key** — create one under [Settings ↗︎](https://app.poelis.com/settings) → [Manage REST API Keys ↗︎](https://app.poelis.com/settings/api-keys) (see [Authentication](/authentication) for details)
* `curl` or any HTTP client

## Step 1: Make Your First Request

List workspaces in your organization. Use your REST API key in the `Authorization: Bearer <key>` header — see [Authentication](/authentication) for how to get and use keys.

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.poelis.com/v1/public/workspaces" \
    -H "Authorization: Bearer poelis_api_YOUR_KEY_HERE"
  ```

  ```python Python theme={null}
  import requests

  headers = {
      "Authorization": "Bearer poelis_api_YOUR_KEY_HERE",
      "Content-Type": "application/json"
  }

  response = requests.get(
      "https://api.poelis.com/v1/public/workspaces",
      headers=headers
  )

  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.poelis.com/v1/public/workspaces', {
    headers: {
      'Authorization': 'Bearer poelis_api_YOUR_KEY_HERE',
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log(data);
  ```
</CodeGroup>

## Step 2: Understand the Response

A successful response will look like this:

```json theme={null}
{
  "items": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "readable_id": "aerospace-engineering",
      "name": "Aerospace Engineering"
    }
  ],
  "count": 1
}
```

## Step 3: Explore More Endpoints

Now that you've made your first request, try these:

### List Products in a Workspace

```bash theme={null}
curl -X GET "https://api.poelis.com/v1/public/products?workspace_id=YOUR_WORKSPACE_ID" \
  -H "Authorization: Bearer poelis_api_YOUR_KEY_HERE"
```

### Get a Specific Item

```bash theme={null}
curl -X GET "https://api.poelis.com/v1/public/items/YOUR_ITEM_ID" \
  -H "Authorization: Bearer poelis_api_YOUR_KEY_HERE"
```

### List Properties for an Item

```bash theme={null}
curl -X GET "https://api.poelis.com/v1/public/properties?item_id=YOUR_ITEM_ID" \
  -H "Authorization: Bearer poelis_api_YOUR_KEY_HERE"
```

## Next Steps

* Read the [Authentication guide](/authentication) to learn more about REST API keys
* Explore the [API Reference](/api-reference/introduction) for all available endpoints
* Check out [Rate Limiting](/guides/rate-limiting) to understand API limits
* Review [Error Handling](/guides/error-handling) for proper error management