Skip to main content
GET
/
providers
/
{slug}
from portkey_ai import Portkey

# Initialize the Portkey client
portkey = Portkey(
    api_key="PORTKEY_API_KEY",
)

# Get a specific provider
provider = portkey.providers.retrieve(
    slug="PROVIDER_SLUG",
    workspace_id=""
)

print(provider)
{
  "name": "Open AI Workspace",
  "integration_id": "<string>",
  "note": "randomness",
  "status": "active",
  "usage_limits": {
    "credit_limit": 10,
    "periodic_reset": "monthly",
    "alert_threshold": 8
  },
  "reset_usage": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "slug": "<string>",
  "rate_limits": [
    {
      "type": "requests",
      "unit": "rpd",
      "value": 123
    }
  ],
  "expires_at": "2023-11-07T05:31:56Z",
  "object": "provider"
}

Authorizations

​
x-portkey-api-key
string
header
required

Path Parameters

​
slug
string
required

Provider slug

Query Parameters

​
workspace_id
string

optional, needed when using organisation admin keys

Response

200 - application/json

Successful response

​
name
string
Example:

"Open AI Workspace"

​
integration_id
string
​
note
string | null
Example:

"randomness"

​
status
enum<string>
Available options:
active,
exhausted,
expired
​
usage_limits
object
Example:
{
  "credit_limit": 10,
  "periodic_reset": "monthly",
  "alert_threshold": 8
}
​
reset_usage
number | null
Example:

0

​
created_at
string<date-time>
​
slug
string
​
rate_limits
object[] | null
​
expires_at
string<date-time>
​
object
enum<string>
Available options:
provider
Last modified on February 25, 2026