---
title: "Search Apps"
method: GET
path: "/v0/apps/search"
tags: ["apps"]
---

# Search Apps

`GET /v0/apps/search`

## Request

- Base URL: `https://api.agentmail.to`
- URL: `https://api.agentmail.to/v0/apps/search`
- Auth: HTTP bearer

Searches apps by name prefix.

## Query parameters

- `q` string, required
- `limit` integer: Limit of number of items returned.

## Response `200`

Response with status 200

- AppsSearchAppsResponse
  - `count` integer, required: Number of items returned.
  - `limit` integer, required: Limit of number of items returned.
  - `apps` AppsApp[], required
    - `app_id` string, uuid, required: ID of app.
    - `slug` string: Short name accepted in place of `app_id` by Get App, List App Accounts and Connect App. Set by AgentMail on apps in the catalog; renaming the app does not change it. Store `app_id`, the app's permanent ID.
    - `name` string
    - `updated_at` string, date-time: Time at which app was last updated.
    - `description` string
    - `logo_url` string
    - `terms_url` string
    - `privacy_url` string
    - `categories` AppsAppCategory[]: Kinds of app, up to 3. Omitted when the app sets none.
    - `owner_signup_limit` integer: Maximum number of accounts your organization may sign up at this app. Omitted when the app sets no limit. 0 means the app has paused new sign-ups; existing accounts keep signing in.

## Other responses

- `400`: Error response with status 400

## Changes

- **2026-10-16** `3f5c7830c952`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentmail-to/apis/api/changes/v0/apps/search/get.md)

---

[API](https://skmtc.dev/agentmail-to/apis/api.md) - [All operations](https://skmtc.dev/agentmail-to/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentmail-to/apis/api/revisions/a9792efe7bdf?raw)