Skip to main content
GET
/
providers
/
{org}
/
{name}
Get Provider
curl --request GET \
  --url https://api.example.com/providers/{org}/{name}
{
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "author": {
    "organization_id": "<string>",
    "org_name": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "scope": "public",
  "trust_tier": "community",
  "icon_url": "<string>",
  "readme": "<string>",
  "tags": [
    "<string>"
  ],
  "latest_version": "<string>",
  "install_count": 0
}

Path Parameters

​
org
string
required
​
name
string
required

Response

Successful Response

Provider listing in the catalog.

Identity fields (frozen): name: Globally unique provider name (used as SurrealDB record ID).

Metadata: display_name: Human-readable name for UI display. description: Short description of what the provider does. author: Publishing organization metadata. scope: Visibility scope (public or tenant-only). trust_tier: Trust level (Official/Verified/Community). icon_url: URL to provider icon image. readme: Long-form documentation in markdown. tags: Searchable tags for categorization.

State (system-managed): latest_version: Semver of the most recent published version. install_count: Total number of tenant installations.

​
name
string
required
​
display_name
string
required
​
description
string
required
​
author
ProviderAuthor · object
required

Author metadata for a provider.

Attributes: organization_id: Organization ID of the publishing tenant. org_name: Display name of the publishing organization.

​
created_at
string<date-time>
​
updated_at
string<date-time>
​
scope
enum<string>
default:public

Scope of a provider in the catalog.

Available options:
public,
tenant
​
trust_tier
enum<string>
default:community

Trust level assigned to providers.

Available options:
official,
verified,
community
​
icon_url
string | null
​
readme
string | null
​
tags
string[]
​
latest_version
string | null
​
install_count
integer
default:0