Providers

Get provider

Retrieves a specific provider by ID.

get/providers/{provider_id}

Request

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

Path parameters

provider_idstring required

Unique identifier of the provider.

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

object'provider' required

String representing the object's type

idstring required

Unique provider identifier

access'public' | 'tenant' required

Access level of the provider

status'active' | 'archived' | 'deleted' required

Current status of the provider

identifierstring required

Provider identifier

namestring required

Display name of the provider

descriptionstring nullable required

Brief description of the provider

slugstring required

URL-friendly identifier

metadataobject nullable required

Custom key-value pairs for storing additional information

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "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.