Raw schema
{
"type": "object",
"properties": {
"entity_page_id": {
"description": "Loa entity_pages.id for the provider or hospital.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"entity_slug": {
"description": "Exact Loa entity slug if entity_page_id is not available.",
"type": "string",
"minLength": 1,
"maxLength": 160
},
"entity_type": {
"description": "Entity kind for the requested update; use unknown only when it cannot be determined.",
"default": "unknown",
"type": "string",
"enum": [
"hospital",
"provider",
"unknown"
]
},
"submitter_email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Work email for the submitting representative."
},
"submitter_name": {
"description": "Name of the person submitting the request.",
"type": "string",
"maxLength": 200
},
"submitter_organization": {
"description": "Provider, hospital, or agent organization represented by the submitter.",
"type": "string",
"maxLength": 300
},
"submitter_role": {
"description": "Submitter role, such as billing manager or authorized agent.",
"type": "string",
"maxLength": 200
},
"submitter_phone": {
"description": "Optional callback phone number for reviewer follow-up.",
"type": "string",
"maxLength": 50
},
"source_urls": {
"description": "Optional public URLs reviewers can use to verify the submitted change.",
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"source_notes": {
"description": "Short verification notes, source context, or callback instructions.",
"type": "string",
"maxLength": 2000
},
"attestation": {
"description": "How the submitter is connected to the submitted evidence.",
"type": "string",
"enum": [
"provider_representative",
"authorized_agent",
"public_source",
"other"
]
},
"request_type": {
"type": "string",
"enum": [
"price_update",
"profile_correction",
"new_listing",
"remove_listing",
"other"
],
"description": "Type of reviewed change being requested."
},
"proposed_changes": {
"description": "Structured profile or listing fields proposed for Loa review.",
"default": {},
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"uploaded_file_url": {
"description": "Optional public URL for an uploaded evidence file.",
"type": "string",
"format": "uri"
},
"idempotency_key": {
"description": "Optional stable retry key. Loa derives one from the payload if omitted.",
"type": "string",
"minLength": 8,
"maxLength": 200
},
"price_items": {
"description": "Optional structured price rows proposed for Loa review.",
"default": [],
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"cpt_code": {
"type": "string",
"minLength": 3,
"maxLength": 20
},
"code_type": {
"default": "CPT",
"type": "string",
"minLength": 1,
"maxLength": 20
},
"service_name": {
"type": "string",
"maxLength": 300
},
"price_kind": {
"default": "cash",
"type": "string",
"enum": [
"cash",
"discounted_cash",
"package_cash",
"payer_negotiated"
]
},
"proposed_price_cents": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"payer_name": {
"type": "string",
"maxLength": 300
},
"plan_name": {
"type": "string",
"maxLength": 300
},
"setting": {
"type": "string",
"maxLength": 100
},
"billing_class": {
"type": "string",
"maxLength": 100
},
"component": {
"default": "unknown",
"type": "string",
"enum": [
"global",
"professional",
"facility",
"unknown"
]
},
"included_services": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
}
},
"exclusions": {
"type": "string",
"maxLength": 1000
},
"price_notes": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"cpt_code"
]
}
}
},
"required": [
"submitter_email",
"request_type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}