List marketplace apps

GET/marketplace/apps

Returns all published apps available in the marketplace. Use to populate the marketplace browse page or feed an integration selector UI. Only apps with status "published" are visible to end-user tenants; admins may also see draft and suspended apps.

Request

Query parameters

Name	Type	Required	Description
category	string	No	Filter apps by category (e.g. "productivity", "analytics", "communication").
status	string	No	Filter by publication status (admin use; defaults to "published" for tenants). One of: "draft", "published", "suspended"
page	integer	No	Default: 1

Responses

200 Paginated list of marketplace apps

Content type application/json, object.

Field	Type	Required	Description
data	array of object · MarketplaceAppV1	No
data[].id	integer	No	Auto-incremented primary key.
data[].name	string	No	Display name of the app.
data[].slug	string	No	URL-safe unique identifier for the app.
data[].category	string	No	App category (e.g. "productivity", "analytics", "communication").
data[].status	string	No	Publication status of the app listing. One of: "draft", "published", "suspended"
data[].version	string	No	Current published version string (semver).
data[].developer	string	No	Name of the developer or company who published the app.
data[].description	string	No	Short description of the app's functionality.
data[].install_count	integer	No	Total number of tenant installations of this app.
data[].average_rating	number (float)	No	Average star rating (1.0–5.0) from tenant reviews.
data[].homepage_url	string, nullable	No	Developer homepage or documentation URL.
data[].support_email	string, nullable	No	Developer support contact email.
data[].created_at	string (date-time)	No
data[].updated_at	string (date-time)	No
meta	object · PaginationMeta	No
meta.current_page	integer	No
meta.per_page	integer	No
meta.total	integer	No

Example

{
  "data": [
    {
      "id": 7,
      "name": "Slack Notifier",
      "slug": "slack-notifier",
      "category": "communication",
      "status": "published",
      "version": "2.1.0",
      "developer": "Acme Integrations Ltd",
      "description": "Posts CRM events to Slack channels in real time.",
      "install_count": 412,
      "average_rating": 4.6,
      "created_at": "2025-08-01T00:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 63
  }
}

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/marketplace/apps" \
  -H "Accept: application/json"