Authentication

All Silver API requests require an API key passed in the apiKey header.

API Key Types

Silver issues separate API keys for each audience:

Key Type	Audience	Used For
Partner API Key	Partners	Eligibility API, Claim Submission API
Administrator API Key	Administrators / TPAs	Claims API
Webhook Secret	Administrators / TPAs	Verifying webhook deliveries

API keys are provided during onboarding. Contact your Silver representative if you need to rotate or request additional keys.

Passing the API Key

Include the API key in the apiKey header of every request:

curl -X POST https://eligibility.withsilver.app/v1/product \
  -H "apiKey: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"title": "Advil Ibuprofen Tablets"}'

import requests

response = requests.post(
    "https://eligibility.withsilver.app/v1/product",
    headers={"apiKey": "your-api-key-here"},
    json={"title": "Advil Ibuprofen Tablets"}
)

Error Responses

If the API key is missing or invalid, the API returns a 403 Forbidden response:

{
  "detail": "Invalid or missing API key"
}

Webhook Authentication

Webhook deliveries include the webhook secret in the apiKey header. Verify this value matches your configured webhook secret to ensure the delivery is authentic. See Webhooks Overview for details.