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

# Searching Overview

> Introduction to querying assets with filters and sorting

The Assets API provides a flexible unified search approach that supports both simple query parameters and advanced filtering through request bodies.

## Quick Reference

| Method                | Use Case                          |
| --------------------- | --------------------------------- |
| GET with query params | Simple filtering by single values |
| POST with body        | Complex filtering with operators  |
| Combined              | Mix both for flexibility          |

## Query Parameters (GET)

When using the GET method, apply filters through URL query parameters:

```bash theme={null}
GET /app/v1/organizations/:organizationId/projects/:projectId/assets?type=image/jpeg&tags=hero&sort=updatedAt:desc
```

| Parameter | Type   | Description                                 |
| --------- | ------ | ------------------------------------------- |
| `limit`   | number | Items per page (default: 10)                |
| `lastKey` | string | Pagination cursor from previous response    |
| `type`    | string | Filter by MIME type                         |
| `tags`    | string | Filter by tag IDs (comma-separated)         |
| `status`  | string | Filter by status (`active` or `deleted`)    |
| `search`  | string | Search term for name/description            |
| `sort`    | string | Sort field and direction (e.g., `name:asc`) |
| `from`    | string | Updated date range start (ISO format)       |
| `to`      | string | Updated date range end (ISO format)         |

## Sort Fields

| Field       | Description                         | Example               |
| ----------- | ----------------------------------- | --------------------- |
| `updatedAt` | Sort by last modification (default) | `sort=updatedAt:desc` |

<Note>
  When no sort is specified, resources are sorted by `updatedAt:desc` by default.
</Note>