Go CLI

# macOS (Apple Silicon)
curl -L https://github.com/Tylerbryy/verity-cli/releases/latest/download/verity-darwin-arm64 -o verity
chmod +x verity
sudo mv verity /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/Tylerbryy/verity-cli/releases/latest/download/verity-darwin-amd64 -o verity
chmod +x verity
sudo mv verity /usr/local/bin/

# Linux
curl -L https://github.com/Tylerbryy/verity-cli/releases/latest/download/verity-linux-amd64 -o verity
chmod +x verity
sudo mv verity /usr/local/bin/

# Windows
# Download verity-windows-amd64.exe from releases

go install github.com/tylerbryy/verity-cli@latest

export VERITY_API_KEY=vrt_live_YOUR_API_KEY

verity --api-key vrt_live_YOUR_API_KEY check 76942

# Basic prior auth check
verity prior-auth 27447 --state TX

# With diagnosis codes
verity prior-auth 27447 --diagnosis M17.11 --state TX

# Multiple procedure codes
verity prior-auth 27447 76942 --state CA

# JSON output for scripting
verity prior-auth 27447 --state TX --output json | jq '.data.pa_required'

Prior Authorization Required: true
Confidence: high
Reason: Procedure requires prior authorization in Texas

Matched Policies:
  • L33831: Ultrasound Guidance for Needle Placement
  • L38942: Diagnostic Ultrasound

Documentation Checklist:
  • Medical necessity documentation
  • Prior imaging results
  • Conservative treatment history

# Basic code lookup
verity check 76942

# With RVU reimbursement data
verity check 76942 --rvu

# With coverage policies
verity check 76942 --policies

# Everything (RVU + policies)
verity check 76942 --rvu --policies

# Filter by jurisdiction
verity check 76942 --jurisdiction JM

Code: 76942
System: HCPCS
Found: true
Description: Echo guide for biopsy

RVU Data (2026):
  Work RVU: 0.65
  Facility Price: $64.13
  Non-Facility Price: $64.13

Coverage Policies (16 found):
  • [covered] Billing and Coding: Varicose Veins
  • [covered] Billing and Coding: Nerve Blockade
  • [not_covered] Ultrasound Guidance for Trigger Point Injections

# Keyword search
verity policies list --query "ultrasound guidance"

# Filter by policy type
verity policies list --query "diabetes" --type LCD

# Filter by jurisdiction
verity policies list --query "CGM" --jurisdiction JM

# Active policies only
verity policies list --query "surgery" --status active

# JSON output
verity policies list --query "ultrasound" --output json | jq '.data[].policy_id'

Found 50 policies:

ID: A57305
Title: Billing and Coding: Varicose Veins of the Lower Extremity
Type: Article
Jurisdiction: JM
Status: active
---
ID: L33831
Title: Ultrasound Guidance for Needle Placement
Type: LCD
Jurisdiction: J06
Status: active
---

# Get policy by ID
verity policies get L33831

# JSON output for parsing
verity policies get L33831 --output json | jq '.data.title'

Policy: L33831
Title: Ultrasound Guidance for Needle Placement
Type: LCD
Status: active
Jurisdiction: J06
Effective Date: 2024-01-01

Description:
This LCD outlines coverage requirements for ultrasound guidance
used during needle placement procedures...

Covered Codes (12):
  • 76942 (HCPCS): covered
  • 76998 (HCPCS): covered

# List all jurisdictions
verity jurisdictions

# JSON output
verity jurisdictions --output json

Medicare Administrative Contractors (MACs):

JM: Palmetto GBA
  States: TX, OK, NM, CO, LA, AR, MS

J05: Novitas Solutions
  States: PA, NJ, DE, MD, DC, WV

J06: National Government Services
  States: IL, MN, WI

# Async mode - returns research ID for polling
verity prior-auth research 27447 --payer "UnitedHealthcare" --state TX

# Output:
# Research ID: res_abc123
# Status: pending
# Poll URL: /api/v1/prior-auth/research/res_abc123
#
# Use 'verity prior-auth research-status <research-id>' to check progress

# Check research status
verity prior-auth research-status res_abc123

# Sync mode - waits for completion
verity prior-auth research 27447 --payer "Aetna" --state CA --sync

# JSON output
verity prior-auth research 27447 --payer "UnitedHealthcare" --sync --output json | jq '.data.result.determination'

# Single code
verity spending T1019

# Multiple codes
verity spending T1019 T1020

# Filter by year
verity spending T1019 --year 2023

# JSON output for scripting
verity spending T1019 --output json | jq '.data.T1019.total_paid'

verity health

# Output:
# Status: healthy
# Version: 1.0.0
# Timestamp: 2026-02-17T12:00:00Z
#
# Checks:
#   database: healthy
#   redis: healthy

# Search criteria text
verity coverage search "BMI greater than 40"

# Filter by section and policy type
verity coverage search "conservative treatment" --section indications --type LCD

# Filter by jurisdiction
verity coverage search "frequency limits" --jurisdiction JM

# JSON output
verity coverage search "BMI" --output json | jq '.data[].text'

# Compare coverage for a procedure
verity policies compare 76942

# Compare specific jurisdictions
verity policies compare 76942 --jurisdictions J05,J06,JM

# Multiple codes with policy type filter
verity policies compare 27447 76942 --type LCD

# JSON output
verity policies compare 76942 --output json | jq '.data.comparison'

#!/bin/bash

CODES=("76942" "27447" "99213" "J0585")

for code in "${CODES[@]}"; do
  echo "Checking $code..."
  verity check "$code" --output json | jq -r '.data.description'
done

#!/bin/bash

# Get changes from the last 24 hours
SINCE=$(date -u -v-24H +"%Y-%m-%dT%H:%M:%SZ")  # macOS
# SINCE=$(date -u -d '24 hours ago' +"%Y-%m-%dT%H:%M:%SZ")  # Linux

verity policies changes --since "$SINCE" --output json | \
  jq -r '.data[] | "\(.policy_id): \(.change_type) - \(.change_summary)"'

#!/bin/bash

# Check if procedures need PA before submitting claim
PROCEDURES=("27447" "76942")
DIAGNOSES=("M17.11" "M79.3")
STATE="TX"

result=$(verity prior-auth "${PROCEDURES[@]}" \
  --diagnosis "${DIAGNOSES[@]}" \
  --state "$STATE" \
  --output json)

pa_required=$(echo "$result" | jq -r '.data.pa_required')

if [ "$pa_required" = "true" ]; then
  echo "Warning: Prior authorization required!"
  echo "$result" | jq -r '.data.documentation_checklist[]'
  exit 1
else
  echo "No prior authorization needed"
  exit 0
fi

#!/bin/bash

# Search and export to CSV
verity policies list --query "diabetes" --output json | \
  jq -r '.data[] | [.policy_id, .title, .policy_type, .status] | @csv' > policies.csv

# Table (default) - human-readable
verity check 76942

# JSON - for scripting
verity check 76942 --output json

# YAML - for configuration
verity check 76942 --output yaml

# Create config file
mkdir -p ~/.verity
cat > ~/.verity/config.yaml << EOF
api-key: vrt_live_YOUR_API_KEY
base-url: https://verity.backworkai.com/api/v1
output: table
EOF

# Now you can use the CLI without --api-key
verity check 76942

--api-key string    # Verity API key (or set VERITY_API_KEY env var)
--base-url string   # API base URL (default: https://verity.backworkai.com/api/v1)
--output string     # Output format: table, json, yaml (default: table)
--config string     # Config file (default: $HOME/.verity/config.yaml)

verity check 76942 --rvu --policies --jurisdiction JM

verity health

verity prior-auth 27447 76942 --diagnosis M17.11 --state TX

verity prior-auth research 27447 --payer "UnitedHealthcare" --state TX --sync

verity prior-auth research-status res_abc123

verity policies list --query "ultrasound" --type LCD --status active

verity policies get L33831

verity policies changes --since 2026-01-01T00:00:00Z

verity policies compare 76942 --jurisdictions J05,J06,JM

verity jurisdictions

verity coverage search "BMI greater than 40" --section indications --type LCD

verity spending T1019 T1020 --year 2023

# Bash
verity completion bash > /usr/local/etc/bash_completion.d/verity

# Zsh
verity completion zsh > /usr/local/share/zsh/site-functions/_verity

# Fish
verity completion fish > ~/.config/fish/completions/verity.fish

# PowerShell
verity completion powershell | Out-String | Invoke-Expression

git clone https://github.com/Tylerbryy/verity-cli.git
cd verity-cli
go build -o verity .
./verity --help

make build-all
# Creates binaries in dist/ for:
# - darwin/amd64, darwin/arm64
# - linux/amd64, linux/arm64
# - windows/amd64