# List the agents companies listed in Community

`GET /o/{org}/agents/community`

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `org` | path | string | yes | The org's slug or id. A caller with no role in the org gets `404`. |
| `q` | query | string | no |  |
| `category` | query | string | no |  |
| `cursor` | query | string | no |  |

## Example request

```bash
curl "https://api.phoenix.so/o/$RUSH_ORG/agents/community" \
  -H "Authorization: Bearer $RUSH_TOKEN"
```

```typescript
const org = process.env.RUSH_ORG;

const res = await fetch(`https://api.phoenix.so/o/${org}/agents/community`, {
  headers: {
    Authorization: `Bearer ${process.env.RUSH_TOKEN}`,
  },
});

console.log(res.status, await res.json());
```

```python
import os

import requests

org = os.environ["RUSH_ORG"]

res = requests.get(
    f"https://api.phoenix.so/o/{org}/agents/community",
    headers={"Authorization": f"Bearer {os.environ['RUSH_TOKEN']}"},
)

print(res.status_code, res.json())
```

## Responses

### 200

Listed agents, newest listing first, 24 a page

- `agents` (array of object, required)
  - `id` (string, required)
  - `name` (string, required)
  - `subtitle` (string, required)
  - `description` (string, required)
  - `category` (string, required, one of `Engineering`, `Business`, `Marketing`, `General`)
  - `maker` (object, required)
    - `name` (string, required)
    - `slug` (string, required)
    - `logo_url` (string | null, optional)
  - `integrations` (array of string, optional): The apps it works with, by name.
  - `triggers` (array of string, optional): How it starts, by kind: `request` is a run you start; the rest are automation triggers. Absent on a listing approved before makers declared it.
  - `logo_url` (string, optional): The listing's square logo, a public image URL that never changes.
  - `cover_url` (string, optional): The listing's wide cover image, a public image URL that never changes.
  - `listed_at` (string, required)
  - `harness` (string, required)
  - `model` (string, required)
  - `added` (boolean, required)
- `next_cursor` (string, optional)

### 400

Unknown category, or a cursor that is not an earlier next_cursor

## Example response (200)

```json
{
  "agents": [
    {
      "id": "3f6c1e2a-8b4d-4c1e-9a7f-2d5b6e8c0a14",
      "name": "string",
      "subtitle": "string",
      "description": "string",
      "category": "Engineering",
      "maker": {
        "name": "string",
        "slug": "string",
        "logo_url": "string"
      },
      "integrations": ["string"],
      "triggers": ["request"],
      "logo_url": "string",
      "cover_url": "string",
      "listed_at": "string",
      "harness": "string",
      "model": "string",
      "added": true
    }
  ],
  "next_cursor": "string"
}
```
