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
name
StringDisplay name
description
StringNullableFull description
slug
StringURL-friendly identifier
image_url
StringNullableURL of the listing logo/icon
readme
StringNullableREADME content in markdown
skills
Array of StringsCapability tags
flags
ObjectStatus flags for the listing
provider_id
StringNullableAssociated provider ID
categories
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","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": ["code-review","pull-requests"],"flags": {"is_public": true,"is_customized": false,"is_metorial": true,"is_verified": true,"is_official": false},"provider_id": "pro_5gHjKlMnPqRsTuVw","categories": [{"object": "provider.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.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.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"}
List provider listings
Returns a paginated list of provider listings.
Query Parameters
limit
NumberOptionalMaximum number of items to return (1-100)
after
StringOptionalReturn items after this ID
before
StringOptionalReturn items before this ID
cursor
StringOptionalPagination cursor from a previous response
order
EnumOptionalSort order for results
search
StringOptionalprovider_id
UnionOptionalprovider_version_id
StringOptionalprovider_category_id
UnionOptionalprovider_collection_id
UnionOptionalprovider_group_id
UnionOptionalpublisher_id
UnionOptionalflags
ObjectOptionalcurl -X GET "https://api.metorial.com/provider-listings" \-H "Authorization: Bearer metorial_sk_..."
Get provider listing
Retrieves a specific provider listing by ID.
URL Parameters
provider_listing_id
StringThe unique identifier for the provider_listing
curl -X GET "https://api.metorial.com/provider-listings/pro_Rm4Mnheq2bfEPhBhP7SY" \-H "Authorization: Bearer metorial_sk_..."