Provider Listings
A listing is a provider enriched with marketplace metadata.
Provider Listings object
Attributes
object
StringString representing the object's type
id
StringUnique listing identifier
attributes
ObjectListing attribute flags
name
StringDisplay name
description
StringNullableFull description
slug
StringURL-friendly identifier
image_url
StringURL of the listing logo/icon
readme
StringNullableREADME content in markdown
skills
Array of StringsCapability tags
provider
Objectcategories
ObjectProvider categories for organization and filtering
collections
ObjectProvider collections this provider belongs to
groups
ObjectUser groups with access to this provider
created_at
DateTimestamp when created
updated_at
DateTimestamp when last updated
{"object": "provider.listing","id": "plg_8kLmNpQrStUvWxYz","attributes": {"is_public": false,"is_customized": false,"is_metorial": false,"is_verified": false,"is_official": false},"name": "GitHub","description": "Connect to GitHub repositories, issues, and pull requests","slug": "github","image_url": "https://cdn.metorial.com/images/github.png","readme": "# GitHub\n\nConnect to GitHub repositories, issues, and pull requests.","skills": ["example_item"],"provider": {"object": "provider","id": "pro_5gHjKlMnPqRsTuVw","access": "public","status": "active","publisher": {"object": "provider.publisher","id": "pub_9hJkLmNpQrStUvWx","name": "Acme Corp","description": "A leading provider of developer tools","image_url": "https://cdn.metorial.com/images/acme.png","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},"current_version": {"object": "provider.version","id": "prv_4dEfGhJkLmNpQrSt","version": "1.0.0","provider_id": "pro_5gHjKlMnPqRsTuVw","is_current": false,"name": "Version 1.0.0","description": "example_description","metadata": {},"specification_id": "psp_9gHjKlMnPqRsTuVw","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},"oauth": {"status": "enabled","callback_url": "example_callback_url","auto_registration": {"status": "supported"}},"identifier": "example_identifier","name": "example_name","description": "example_description","slug": "example_slug","metadata": {},"created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},"categories": [{"object": "provider.listing_category","id": "pca_2mNpQrStUvWxYzAb","name": "Developer Tools","description": "Tools for software development and CI/CD","slug": "developer-tools","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},{"object": "provider.listing_category","id": "pca_2mNpQrStUvWxYzAb","name": "Developer Tools","description": "Tools for software development and CI/CD","slug": "developer-tools","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"}],"collections": [{"object": "provider.listing_collection","id": "pco_6pQrStUvWxYzAbCd","name": "CRM Integrations","description": "Providers for customer relationship management","slug": "crm","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},{"object": "provider.listing_collection","id": "pco_6pQrStUvWxYzAbCd","name": "CRM Integrations","description": "Providers for customer relationship management","slug": "crm","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"}],"groups": [{"object": "provider.listing_group","id": "pgr_3nPqRsTuVwXyZaBc","name": "Sales Integrations","description": "CRM and sales pipeline integrations for sales agents","slug": "sales-integrations","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"},{"object": "provider.listing_group","id": "pgr_3nPqRsTuVwXyZaBc","name": "Sales Integrations","description": "CRM and sales pipeline integrations for sales agents","slug": "sales-integrations","created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"}],"created_at": "2025-09-15T10:30:00.000Z","updated_at": "2026-01-10T14:45:00.000Z"}
Get provider listing
Retrieves a specific provider listing by ID.
URL Parameters
provider_listing_id
StringThe unique identifier for the provider_listing
GEThttp://api.metorial.com/provider-listings/:provider_listing_id
curl -X GET "https://api.metorial.com/provider-listings/pro_Rm4Mnheq2bfEPhBhP7SY" \-H "Authorization: Bearer metorial_sk_..."