MEmetorial
Providers

List providers

Returns a paginated list of providers.

get/providers

Request

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

Query parameters

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

Filter by provider ID(s)

searchstring

Search providers by name, description, or readme

string
OR
string[]

Filter by auth method — matches an auth method ID, auth method global ID, key, name, or type (oauth, token, service_account, custom)

'configured' | 'not_configured'
OR
string[]

Filter by auth setup status. "configured" matches providers with a token or custom auth method, or with auth credentials already configured. "not_configured" matches providers with only OAuth auth methods and no auth credentials configured.

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": "pro_5gHjKlMnPqRsTuVw",
      "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": {
        "id": "prv_4dEfGhJkLmNpQrSt",
        "version": "1.0.0",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "name": "Version 1.0.0",
        "specification_id": "psp_9gHjKlMnPqRsTuVw",
        "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"
    }
  ]
}

Changes

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