---
title: "List published extensions"
method: GET
path: "/v1/public/published-extensions"
tags: ["Public"]
---

# List published extensions

`GET /v1/public/published-extensions`

## Request

- Base URL: `https://api.finalpos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finalpos.com/v1/public/published-extensions`
- Auth: none required

Returns every extension with `status: "public"`, enriched with its owning organization (logo, name, and `organization_alias`). Publicly accessible — no API key required. Results are ordered by organization name, then extension name. All query params are optional; when none are supplied, every public extension is returned (unbounded).

## Query parameters

- `skip` number
- `limit` number
- `searchByLabel` string

## Response `200`

Published extensions.

- PublishedExtensionListResponseDto
  - `data` PublishedExtensionListItemDto[], required: Published extensions.
    - `_id` string, required: Extension id.
    - `label` string, required: Extension display name.
    - `status` string, required: Publication status. Always `public` for these endpoints.
    - `category` string, required: Extension category.
    - `short_description` string, required: Short marketing description.
    - `long_description` string, required: Long marketing description.
    - `url` string: Hosted iframe URL of the extension, if deployed.
    - `description` string: General/legacy description.
    - `price` string: Price label.
    - `website` string: Marketing website URL.
    - `main_image` string: Main listing image URL.
    - `backgroundUrl` string: Background image URL.
    - `gallery` string[]: Gallery image URLs.
    - `theme` string: Theme identifier.
    - `redirectUrl` string: Post-install redirect URL.
    - `organizationId` string: Owning organization id (reference to `companies`).
    - `organization` OrganizationSummaryDto, required
      - `_id` string, required: Organization (Company) id.
      - `name` string, nullable, required: Organization name.
      - `logo` string, nullable, required: Organization logo URL, if set.
      - `organization_alias` string, nullable, required: Organization's public alias, from the `organization_alias` company-settings attribute.
    - `createdAt` string, required: Creation timestamp (ISO 8601).
    - `updatedAt` string, required: Last-update timestamp (ISO 8601).
  - `meta` ListMetaDto, required
    - `count` number, required: Total number of items matching the query filters
    - `skip` number, required: Number of items skipped
    - `limit` number, required: Maximum number of items returned

## Other responses

- `429`: Rate limit exceeded for the caller IP. Back off and retry after the `retryAfter` interval.

---

[API](https://skmtc.dev/finalpos/apis/final-pos-public-api.md) · [All operations](https://skmtc.dev/finalpos/apis/final-pos-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finalpos/apis/final-pos-public-api/revisions/6a6842dcb479?raw)