Custom Fee Schedules API¶

Manage organization-specific fee schedules and pricing overrides.

Overview¶

The Custom Fee Schedules API allows you to programmatically create, update, and query custom pricing logic.

Base Path: /api/v1/custom-fee-schedules

Authentication: Required (Bearer token)

Endpoints¶

List Fee Schedules¶

Retrieve all custom fee configurations for your organization.

Endpoint: GET /

Response:

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Standard Commercial 2025",
    "description": "Base commercial rates",
    "is_active": true,
    "created_at": "2025-01-01T00:00:00Z"
  }
]

Create Fee Schedule¶

Create a new pricing configuration.

Endpoint: POST /

Body:

{
  "name": "Urgent Care Rates",
  "description": "Overrides for urgent care center",
  "is_active": true
}

Get Schedule Details & Items¶

Retrieve metadata and items for a specific schedule.

Endpoint: GET /{config_id}/items

Query Parameters: - skip (int): Pagination offset - limit (int): Pagination limit - code (string): Filter by specific code

Add/Update Item¶

Add a pricing item to a schedule.

Endpoint: POST /{config_id}/items

Body:

{
  "code": "99213",
  "code_type": "HCPCS",
  "pricing_amount": 150.00,
  "pricing_type": "flat_rate",
  "effective_date": "2025-01-01"
}

Audit History¶

View the change log for a specific schedule.

Endpoint: GET /{config_id}/audit

Query Parameters: - skip (int): Pagination offset - limit (int): Pagination limit

Response: Returns a list of audit entries including action, changed_at, changed_by_user_id, old_value, and new_value.