API Documentation

WinTheP2P API

Free REST API for denial code lookup and P2P call preparation data. CORS-enabled, no API key required. Rate limited to 100 requests/minute.

Base URL

https://winthep2p.com/api/embed

CORS: EnabledAuth: NoneRate limit: 100/minCache: 24 hours

Denial Codes

GET/api/embed/denial-code

List all 108 denial codes with code, group, name, category, and P2P recommendation.

Parameters

Name	Required	Description
format	No	Response format: 'json' (default) or 'html' (embeddable widget)
callback	No	JSONP callback function name for cross-domain script tags

Example

curl https://winthep2p.com/api/embed/denial-code

Response

[
  {
    "code": "50",
    "groupCode": "CO",
    "shortName": "Medical Necessity Denied",
    "category": "Medical Necessity",
    "needsP2P": true
  },
  ...
]

GET/api/embed/denial-code?code={code}

Get full details for a single denial code including description, common causes, action steps, and P2P recommendation.

Parameters

Name	Required	Description
code	Yes	Denial code number (e.g., 50, 197, 272)
format	No	'json' (default) or 'html' (self-contained embeddable widget)

Example

curl https://winthep2p.com/api/embed/denial-code?code=50

Response

{
  "code": "50",
  "groupCode": "CO",
  "shortName": "Medical Necessity Denied",
  "description": "These are non-covered services because...",
  "commonCause": "The payer determined that the service...",
  "actionSteps": [
    "Review the specific medical policy...",
    "Gather supporting clinical evidence...",
    "Request a peer-to-peer review..."
  ],
  "category": "Medical Necessity",
  "needsP2P": true,
  "link": "https://winthep2p.com/tools/denial-codes/50"
}

P2P Guides

GET/api/embed/p2p-guide

List all available procedures (20) and payers (5) with slugs, names, and metadata.

Example

curl https://winthep2p.com/api/embed/p2p-guide

Response

{
  "procedures": [
    {
      "slug": "mri-lumbar-spine",
      "name": "MRI Lumbar Spine",
      "cptCodes": ["72148", "72149", "72158"],
      "specialty": "Radiology / Orthopedics / Neurosurgery"
    },
    ...
  ],
  "payers": [
    {
      "slug": "unitedhealthcare",
      "name": "UnitedHealthcare (UHC / Optum)",
      "shortName": "UHC"
    },
    ...
  ]
}

GET/api/embed/p2p-guide?procedure={slug}&payer={slug}

Get a complete P2P preparation guide for a specific procedure and payer combination, including payer-specific policy references, denial patterns, and call strategies.

Parameters

Name	Required	Description
procedure	Yes	Procedure slug (e.g., mri-lumbar-spine, knee-replacement)
payer	Yes	Payer slug (e.g., unitedhealthcare, aetna, cigna)

Example

curl 'https://winthep2p.com/api/embed/p2p-guide?procedure=mri-lumbar-spine&payer=unitedhealthcare'

Response

{
  "procedure": {
    "name": "MRI Lumbar Spine",
    "cptCodes": ["72148", "72149", "72158"],
    "commonDenialReasons": [...],
    "medicalNecessityPoints": [...],
    "clinicalGuidelines": [...]
  },
  "payer": {
    "name": "UnitedHealthcare (UHC / Optum)",
    "criteriaSource": "eviCore / UHC Clinical Guidelines",
    "p2pTips": [...]
  },
  "nuance": {
    "specificPolicy": "UHC CG-RAD-23",
    "uniqueDenialPattern": "UHC via eviCore requires...",
    "payerSpecificStrategy": "Pull up CG-RAD-23...",
    "keyPhrase": "This patient meets the..."
  },
  "link": "https://winthep2p.com/p2p/mri-lumbar-spine/unitedhealthcare"
}

Want an embeddable widget instead?

Copy-paste a single line of code to add denial code lookup to your site.

Embed widget Try the P2P tool