--- title: "List listings" method: GET path: "/ecosystems/{ecosystem_id}/listings" tags: ["Listing"] --- # List listings `GET /ecosystems/{ecosystem_id}/listings` List listings ## Path parameters - `ecosystem_id` string, required ## Query parameters - `cursor` string, nullable - `limit` integer - `external_id` string ## Response `200` Listings - GetListingsResponse - `status_code` integer, required — HTTP Response Status Code - `status` string, required — HTTP Response Status - `data` Listing[], required - `id` string - `external_id` string - `automate_id` string - `blendr_id` string - `card_background_color` string - `card_background_image` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `categories` Category[] - `id` string - `description` string - `name` string, required - `slug` string, required - `count` integer - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `listing_description_text_template` string - `listing_pricing_text_template` string - `listing_features_text_template` string - `logo` Logo - `content_type` string - `id` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `cloud_service_id` string - `combidesk_id` string - `collections` Collection[] - `id` string - `card_background_color` string - `card_background_image` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `card_columns` integer - `card_style` string - `count` integer - `description` string - `logo` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `name` string, required - `hidden_from_homepage` boolean - `show_max_items_homepage` integer - `sequence` integer - `slug` string, required - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `visible` boolean, required - `description` string - `detail_page_disabled` boolean - `features` string - `integromat_id` string - `logo` Logo - `content_type` string - `id` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `meta_tag_description` string - `meta_tag_keywords` string - `meta_tag_title` string - `microsoft_flow_id` string - `name` string, required - `native_integration` boolean - `native_integration_link` string - `media` Media[] - `id` string - `caption` string - `type` 'SCREENSHOT' | 'VIDEO' - `url` string, required - `sequence` integer - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `partner` Partner - `id` string - `company` string, required - `contacts` Contact[] - `id` string - `first_name` string - `last_name` string - `name` string, required - `email` string - `role` string - `linked_in` string - `twitter` string - `icon` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `listed` string - `twitter` string - `website` string - `created_at` string, date-time - `updated_at` string, date-time - `piesync_id` string - `pricing` string - `products` Product[] - `id` string - `name` string, required - `slug` string, required - `description` string - `visible` boolean, required - `sequence` integer - `count` integer - `logo` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `published` boolean - `published_at` string, date-time - `screenshots` Screenshot[] - `id` string - `caption` string - `file` File - `id` string - `content_type` string - `type` 'LOGO' | 'BANNER' | 'SCREENSHOT' - `url` string, required - `created_at` string, date-time - `updated_at` string, date-time - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `segment_id` string - `slug` string, required - `sticky` boolean - `tag_line` string - `third_party_integration` boolean - `third_party_integration_link` string - `translations` Translation[], nullable - `key` string, required - `locale` string, required - `value` string - `tray_io_id` string - `unify_connector_id` string - `upcoming` boolean - `zapier_id` string - `created_at` string, date-time - `updated_at` string, date-time - `meta` Meta — Response metadata - `items_on_page` integer — Number of items returned in the data property of the response - `cursors` object — Cursors to navigate to previous or next pages through the API - `previous` string, nullable — Cursor to navigate to the previous page of results through the API - `current` string, nullable — Cursor to navigate to the current page of results through the API - `next` string, nullable — Cursor to navigate to the next page of results through the API - `links` Links — Links to navigate to previous or next pages through the API - `previous` string — Link to navigate to the previous page through the API - `current` string, required — Link to navigate to the current page through the API - `next` string — Link to navigate to the previous page through the API ## Changes - **2026-07-13** `a8b2ef683438` — 13 info - added the optional property `data/items/card_background_image` to the response with the `200` status - the response property `data/items/categories/items/translations/items/key` became required for the status `200` - the response property `data/items/categories/items/translations/items/locale` became required for the status `200` - the response property `data/items/collections/items/translations/items/key` became required for the status `200` - …9 more - **2022-04-08** `222082c66e25` — 2 info - added the optional property `data/items/categories/items/count` to the response with the `200` status - added the optional property `data/items/collections/items/count` to the response with the `200` status - **2022-04-06** `4e8721dca810` — 3 warning, 16 info - removed the optional property `data/items/category` from the response with the `200` status - removed the optional property `data/items/partner/icon/contentType` from the response with the `200` status - removed the optional property `data/items/screenshots/items/file/contentType` from the response with the `200` status - added the new optional `query` request parameter `external_id` - …15 more - **2022-03-31** `2d9f9f64864f` — 1 info - endpoint added - **2022-03-29** `fe50a1221140` — 1 breaking - api path removed without deprecation [Change history](https://skmtc.dev/apideck-libraries/apis/ecosystem-api/changes/ecosystems/:ecosystem_id/listings/get.md) --- [API](https://skmtc.dev/apideck-libraries/apis/ecosystem-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/ecosystem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apideck-libraries/ecosystem-api/revisions/a8b2ef683438/schema)