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

# Slack Apps API

> Apps from the Slack Marketplace with name, description, developer, categories and pricing. Filter by category.

`POST /v1/data/slack/apps/run`

**Pricing:** $0.01 per app ($14.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**category** `string` *required*

Category to use.

28 allowed values, for example `AI Apps & Assistants`, `Analytics`, `Brilliant Bots`, `Communication`, `Customer Support`, `Daily Tools`, `Design`, `Developer Tools`, `Enterprise-ready apps`, `Essential Apps`. Fetch the full list with `GET /v1/data/slack/apps?expand=options`.

**pricing** `string` (default: All)

Pricing to use. All by default.

Allowed values: `All`, `Free`, `Paid`, `Free and paid`.

**maxResults** `integer` (default: 100)

How many apps to return in total. Defaults to 100; use 0 for all.

Max `200`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/slack/apps/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "category": "Finance",
    "maxResults": 10
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/slack/apps/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "category": "Finance",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/slack/apps/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "category": "Finance",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one app, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `appId` | App ID | text |
| `name` | Name | text |
| `description` | Description | text |
| `developer` | Developer | text |
| `headquarters` | Headquarters | text |
| `categories` | Categories | array |
| `pricing` | Pricing | text |
| `appUrl` | App URL | url |
| `installUrl` | Install URL | url |
| `developerWebsite` | Developer Website | url |
| `supportUrl` | Support URL | url |
| `supportEmail` | Support Email | text |
| `privacyPolicyUrl` | Privacy Policy URL | url |
| `supportedLanguages` | Supported Languages | array |
| `logoUrl` | Logo URL | url |
| `videoUrl` | Video URL | url |
| `slackApproved` | Slack Approved | boolean |
| `builtBySlack` | Built By Slack | boolean |
| `aiApp` | Ai App | boolean |
| `agentApp` | Agent App | boolean |
| `orgReady` | Org Ready | boolean |
| `slashCommands` | Slash Commands | object\_array |
| `globalShortcuts` | Global Shortcuts | object\_array |
| `messageShortcuts` | Message Shortcuts | object\_array |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "slack/apps",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "supportEmail": "support@ramp.com",
      "videoUrl": null,
      "logoUrl": "https://avatars.slack-edge.com/2026-09-22/12123599878438_9241e21257bf1f8c4dfa_192.png",
      "agentApp": false,
      "orgReady": false,
      "headquarters": "United States",
      "slashCommands": [
        {
          "name": "/ramp",
          "url": "https://api.ramp.com/v1/webhooks/slack_interactive/slack_ramp_slash_command/slack/events",
          "desc": "Ramp slash commands!",
          "usage": "",
          "parse_full": false
        }
      ],
      "supportedLanguages": [
        "English"
      ],
      "appId": "A0142U9UPM5",
      "name": "Ramp",
      "builtBySlack": false,
      "pricing": "Paid",
      "slackApproved": true,
      "globalShortcuts": null,
      "messageShortcuts": null,
      "privacyPolicyUrl": "https://ramp.com/legal/privacy-policy",
      "description": "Ramp is the corporate card and spend management platform that helps companies of all sizes to accelerate growth without compromising on their finances. With ...",
      "developer": "Ramp",
      "developerWebsite": "https://support.ramp.com/hc/en-us/articles/360052081394-Set-up-Ramp-s-Slack-integration-for-Admins?utm_source=slack_app",
      "categories": [
        "Featured",
        "Office Management"
      ],
      "aiApp": false,
      "appUrl": "https://slack.com/marketplace/A0142U9UPM5-ramp",
      "installUrl": "https://slack.com/signin?redir=/marketplace/A0142U9UPM5-ramp",
      "supportUrl": "https://app.ramp.com/support/get-help"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.