IOCE Bypass API¶

Manage IOCE bypass configurations to override standard IOCE logic.

Overview¶

The IOCE Bypass API allows organizations to define custom overrides for IOCE edits. You can create configurations containing multiple bypass lines, each targeting specific HCPCS codes and modifiers.

Base Path: /api/v1/ioce-bypass

Authentication: Required for all endpoints (Bearer token)

Configuration Management¶

List Configurations¶

List all IOCE bypass configurations for the organization.

Endpoint: GET /ioce-bypass/configs

Query Parameters:

Parameter	Type	Description
`is_active`	boolean	Filter by active status
`effective_date_start`	date	Filter by effective date start
`effective_date_end`	date	Filter by effective date end
`skip`	integer	Number of records to skip
`limit`	integer	Maximum records to return

Get Configuration¶

Get a specific IOCE bypass configuration.

Endpoint: GET /ioce-bypass/configs/{config_id}

Get Configuration with Lines¶

Get a configuration along with its bypass lines (paginated).

Endpoint: GET /ioce-bypass/configs/{config_id}/with-lines

Query Parameters:

Parameter	Type	Description
`skip`	integer	Number of lines to skip
`limit`	integer	Maximum lines to return

Create Configuration¶

Create a new IOCE bypass configuration.

Endpoint: POST /ioce-bypass/configs

Request Body:

{
  "name": "2024 Radiology Overrides",
  "description": "Custom logic for radiology department",
  "effective_start_date": "2024-01-01",
  "effective_end_date": "2024-12-31",
  "is_active": true
}

Update Configuration¶

Update an IOCE bypass configuration.

Endpoint: PATCH /ioce-bypass/configs/{config_id}

Activate/Deactivate Configuration¶

Toggle the active status of a configuration.

Activate: POST /ioce-bypass/configs/{config_id}/activate Deactivate: POST /ioce-bypass/configs/{config_id}/deactivate

Delete Configuration¶

Delete an IOCE bypass configuration.

Endpoint: DELETE /ioce-bypass/configs/{config_id}

Query Parameters:

Parameter	Type	Default	Description
`soft_delete`	boolean	true	If true, marks as inactive instead of removing

Line Management¶

List Lines¶

List IOCE bypass lines with filters.

Endpoint: GET /ioce-bypass/lines

Query Parameters:

Parameter	Type	Description
`config_id`	uuid	Filter by configuration ID
`hcpcs_code`	string	Filter by HCPCS code
`is_active`	boolean	Filter by active status

Create Lines¶

Add lines to a configuration.

Endpoint: POST /ioce-bypass/configs/{config_id}/lines

Request Body:

[
  {
    "hcpcs_code": "71045",
    "modifiers": ["26"],
    "action": "bypass_edit",
    "edit_codes": ["123", "456"]
  }
]

Update Line¶

Update an IOCE bypass line.

Endpoint: PATCH /ioce-bypass/lines/{line_id}

Activate/Deactivate Line¶

Toggle the active status of a line.

Activate: POST /ioce-bypass/lines/{line_id}/activate Deactivate: POST /ioce-bypass/lines/{line_id}/deactivate

Delete Line¶

Delete an IOCE bypass line.

Endpoint: DELETE /ioce-bypass/lines/{line_id}

Resolution¶

Resolve Bypass¶

Resolve bypass override for a specific code and modifiers.

Endpoint: GET /ioce-bypass/resolve

Query Parameters:

Parameter	Type	Required	Description
`config_id`	uuid	Yes	Configuration ID
`hcpcs_code`	string	Yes	HCPCS code
`modifiers`	string	No	Comma-separated modifiers

Get Active Configs¶

Get all active configurations for a specific date.

Endpoint: GET /ioce-bypass/configs/active-for-date

Query Parameters:

Parameter	Type	Required	Description
`effective_date`	date	Yes	Date to check

Audit Logs¶

List Audit Logs¶

List audit logs with filters.

Endpoint: GET /ioce-bypass/audit

Get Config Audit History¶

Get complete audit history for a configuration.

Endpoint: GET /ioce-bypass/configs/{config_id}/audit

Import/Export¶

Export CSV/JSON¶

Export configuration lines.

CSV: GET /ioce-bypass/configs/{config_id}/export/csv JSON: GET /ioce-bypass/configs/{config_id}/export/json

Import CSV¶

Import lines from a CSV file.

Endpoint: POST /ioce-bypass/configs/{config_id}/import/csv

Request Body: multipart/form-data with file field.

Get Templates¶

Download templates for bulk import.

CSV: GET /ioce-bypass/templates/csv JSON: GET /ioce-bypass/templates/json