MEmetorial
Provider Specifications

List provider specifications

Returns a paginated list of provider specifications.

get/provider-specifications

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
string
OR
string[]

Filter by specification ID(s)

string
OR
string[]

Filter by provider ID(s)

string
OR
string[]

Filter by provider version ID(s)

string
OR
string[]

Filter by provider deployment ID(s)

string
OR
string[]

Filter by provider config ID(s)

searchstring

Match a provider specification by its exact ID

gtstring date-time

Only include records after this timestamp for provider specification creation time

ltstring date-time

Only include records before this timestamp for provider specification creation time

Filter provider specification creation time by date range

gtstring date-time

Only include records after this timestamp for provider specification last update time

ltstring date-time

Only include records before this timestamp for provider specification last update time

Filter provider specification last update time by date range

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

Example response

{
  "items": [
    {
      "id": "psp_9gHjKlMnPqRsTuVw",
      "key": "github",
      "name": "GitHub",
      "description": "GitHub API integration",
      "tools": [
        {
          "id": "pto_5jKlMnPqRsTuVwXy",
          "key": "create_issue",
          "name": "Create Issue",
          "description": "Creates a new issue in a GitHub repository",
          "specification_id": "psp_9gHjKlMnPqRsTuVw",
          "provider_id": "pro_5gHjKlMnPqRsTuVw",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        }
      ],
      "tool_categories": [
        {
          "key": "crm",
          "name": "Zoho CRM",
          "description": "Manage leads, contacts, deals and other CRM records",
          "image_url": "https://provider-logos.metorial-cdn.com/zoho-crm.svg",
          "tool_count": 24
        }
      ],
      "auth_methods": [
        {
          "id": "pam_2mNpQrStUvWxYzAb",
          "key": "oauth2",
          "name": "OAuth 2.0",
          "description": "Authenticate using OAuth 2.0",
          "scopes": [
            {
              "id": "pams_8tUvWxYzAbCdEfGh",
              "scope": "repo",
              "name": "Repository Access",
              "description": "Full control of private repositories"
            }
          ],
          "provider_id": "pro_5gHjKlMnPqRsTuVw",
          "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        }
      ],
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.