Skip to main content

Quick Start

Get up and running with Silver APIs in minutes. Below are example requests for each API.

Prerequisites​

  • An API key for the appropriate audience (partner or administrator)
  • curl or an HTTP client of your choice

Eligibility API (Partner)​

Check if a product is eligible for FSA/HSA reimbursement:

curl -X POST https://eligibility.withsilver.app/v1/product \
  -H "apiKey: your-partner-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Advil Ibuprofen Tablets, 200mg",
    "description": "Pain reliever and fever reducer, 100 coated tablets",
    "sku": "305730169301",
    "sku_type": "UPC",
    "vendor": "Advil"
  }'

Response:

{
  "eligibility": "eligible",
  "title": "Advil Ibuprofen Tablets, 200mg",
  "description": "Pain reliever and fever reducer, 100 coated tablets",
  "sku": "305730169301",
  "sku_type": "UPC",
  "image_url": "https://example.com/images/advil-200mg.jpg"
}

Claim Submission API (Partner)​

Submit a claim in four steps:

1. List providers​

curl -X GET https://claim-submission.withsilver.app/v1/providers \
  -H "apiKey: your-partner-api-key"

2. Get provider form requirements​

curl -X GET https://claim-submission.withsilver.app/v1/providers/prv_abc123 \
  -H "apiKey: your-partner-api-key"

3. Upload a claimable document​

curl -X POST https://claim-submission.withsilver.app/v1/claimable_documents \
  -H "apiKey: your-partner-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_m3mb3r01",
    "document_type": "receipt",
    "file": {
      "base64": "JVBERi0xLjQKJcfs...",
      "mime_type": "application/pdf"
    },
    "claimable_services": [
      {
        "service_date_start": "2026-01-10",
        "service_date_end": "2026-01-10",
        "service_provider": "Downtown Physical Therapy",
        "service_description": "Physical therapy session — 60 min",
        "claimable_amount": 150.00
      }
    ]
  }'

4. Submit the claim​

curl -X POST https://claim-submission.withsilver.app/v1/claims \
  -H "apiKey: your-partner-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "usr_m3mb3r01",
    "provider_id": "prv_abc123",
    "user_form_fields": {
      "employee_id": "EMP-9876",
      "relationship": "self"
    },
    "signature": "iVBORw0KGgoAAAANSUhEUgAA...",
    "claimable_documents": ["cdoc_a1b2c3d4"]
  }'

Claims API (Administrator)​

Submit a claim with evidence for adjudication:

curl -X POST https://claim-api.withsilver.app/v1/claims \
  -H "apiKey: your-admin-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "claim_number": "CLM-2025-00042",
    "claim_amount": 15000,
    "service_start_date": "2025-03-10",
    "service_end_date": "2025-03-10",
    "submission_date": "2025-03-15",
    "provider": "Lakewood Family Dentistry",
    "plan_name": "Acme 2025 Medical FSA",
    "plan_type": "medical_fsa",
    "plan_year_start": "2025-01-01",
    "plan_year_end": "2025-12-31",
    "final_submission_date": "2026-03-31",
    "final_service_date": "2025-12-31",
    "evidence": [
      {
        "mime_type": "application/pdf",
        "content": "JVBERi0xLjQKJeLjz9MK..."
      }
    ]
  }'
Amounts are in cents

The Claims API uses cents for all monetary values. For example, 15000 represents $150.00.

Retrieve claim details and adjudication results:

curl -X GET "https://claim-api.withsilver.app/v1/claims?id=a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -H "apiKey: your-admin-api-key"

Next Steps​