# Collections API

*Skill Level: Intermediate*

## Before You Begin

* The Adalo API is available on the Team and Business Plan.

This help article will show you how to access the documentation for your use. We will add additional resources in the near future for how and why you can use the Adalo Collections API. 

Step 1: Open your Adalo application and click on the three buttons beside the collection name.

![](/files/-MJ9NVhPsx-bezEsr0g0)

Step 2: Then select API Documentation

![](/files/-MJ9Nqi3BPlpyCr1h3eA)

Step 3: This will open a new tab with the Adalo Collections API Documentation. This data dynamically updates per individual applications.

![](/files/-MJ9O2zR19wIfagT14u7)

Step 4: \
Left side will show each of your collections and their respective endpoints.\
\
Center will show you the Headers required along with your already populated Adalo API Key. This key can also be generated from the Builder on the left nav > Settings > App Access > API Key.\
\
Right will show you the URL per endpoint and the data which is collected.

You can also access the Adalo Collections API Documentation by clicking on the records number shown by the collection.

![](/files/-MJ9OqtdQXbl8eCcxLwh)

Then select the < > symbol in the top right to open the API Documentation.

![](/files/-MJ9P81G68P24Lwod1J-)

### Filtering with Query Parameters

Adalo’s Collections API supports filtering records via **query parameters** (`filterKey`, `filterValue`), but **only** on single-value properties (Number, Text, Boolean, Date). Relationship fields return **arrays** of IDs, so they **cannot** be filtered this way.

> **Example**: If your Items collection has a **Category** relationship, each Item’s Category value comes through as an array (e.g. `[36]`). Query params cannot match against arrays, so adding `?filterKey=Category&filterValue=36` will never return results.

**To use `filterKey` / `filterValue` successfully:**

1. Add a Number property (e.g. `CategoryID`) to your **Items** collection that holds the single ID of its Category.
2. Populate that field for each record (e.g. `CategoryID = 36`).
3. Call the API endpoint with:

   ```
   GET /collections/{ItemsCollectionId}/records
       ?filterKey=CategoryID
       &filterValue=36
   ```

   This will return only the items whose `CategoryID` equals `36`.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.adalo.com/integrations/the-adalo-api/collections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.