### cURL Example for Test EligibilityInquiry

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

This cURL command demonstrates how to make a POST request to the Test EligibilityInquiry endpoint. It includes necessary headers such as Authorization, Client-API-Id, and Content-Type, along with the JSON request body. Replace placeholders like '<access token>' and '<client-API-ID>' with your actual credentials.

```bash
curl --location 'https://api.pverify.com/Test/API/EligibilityInquiry' \
--header 'Authorization: Bearer  <access token>' \
--header 'Client-API-Id: <client-API-ID>' \
--header 'Content-Type: application/json' \
--data '{ 
  "payerCode": "00007",
  "provider": {
    "firstName": "",
    "middleName": "",
    "lastName": " test name",
    "npi": "1122334455"
  },
  "subscriber": {
    "firstName": "first",
    "middleName": "",
    "lastName": "somelast",
    "dob": "12/21/2018",
    "memberID": "1234567890"
  },
  "dependent": {
    "patient": {
      "firstName": "",
      "middleName": "",
      "lastName": "",
      "dob": "",
      "gender": ""
    },
    "relationWithSubscriber": ""
  },
  "isSubscriberPatient": "true",
  "doS_StartDate": "12/21/2018",
  "doS_EndDate": "12/21/2018",
  "serviceCodes": [
    "30"
  ],
       "requestSource": "RestAPI",
     "isHMOplan": true,
     "IncludeTextResponse": true,
     "referenceId": "1234",
     "Location": "Nowhere"

}'
```

--------------------------------

### PatientFinderInquiry API Request Example (cURL)

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

This cURL command demonstrates how to make a POST request to the PatientFinderInquiry API endpoint. It includes the necessary headers for authorization, API identification, and content type, along with the JSON payload containing patient demographic data.

```bash
curl --location 'https://api.pverify.com/Test/api/PatientFinderInquiry' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: <client-API-ID>' \
--header 'Content-Type: application/json' \
--data '{
	"FirstName": "John",
	"MiddleName": null,
	"LastName": "Doe",
	"DOB": null, // use format MM/DD/YYYY
	"SSN": null, // use format XXX-XX-XXXX
	"PhoneNumber": null,
	"Address": {
		"AddressLine1": "Address1",
		"AddressLine2": null,
		"City": "City",
		"State": "ST", // use abbreviation - CA for California
		"ZipCode": "12345"
	},
	"Location": "CA1",
	"ReferenceNumber": null // MRN etc
}'
```

--------------------------------

### PatientFinderInquiryResults Request Example (cURL)

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

This cURL command demonstrates how to make a request to the PatientFinderInquiryResults endpoint. It includes necessary headers like Authorization and Content-Type, along with a JSON payload containing patient demographic information.

```curl
curl --location 'https://api.pverify.com/Test/api/PatientFinderInquiryResults' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: <client-API-ID>' \
--header 'Content-Type: application/json' \
--data '{ 
	"FirstName": "John",
	"MiddleName": null,
	"LastName": "Doe",
	"DOB": "01/12/1953", 
	"SSN": null, 
	"PhoneNumber": null,
	"Address": {
		"AddressLine1": null,
		"AddressLine2": null,
		"City": null,
		"State": null, 
		"ZipCode": null,
        "ReportedDate":null
	},
	"Location": null,
    "RequestSource":null,
	"ReferenceNumber": null ,
    "SearchCriteriaId":null
}'
```

--------------------------------

### cURL Example for GetPatientFinderResponse

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

This snippet demonstrates how to call the GetPatientFinderResponse API using cURL. It includes the endpoint URL and required headers like Authorization and Client-API-Id. The request body is empty.

```curl
curl --location 'https://api.pverify.com/api/Test/GetPatientFinderResponse/0' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: <client-API-ID>' \
--header 'Content-Type: application/json' \
--data ''
```

--------------------------------

### GET /api/Test/GetPatientFinderResponse/{requestId}

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Retrieves the complete patient finder response using the search request ID from previous patient finder inquiries.

```APIDOC
## GET /api/Test/GetPatientFinderResponse/{requestId}

### Description
Retrieves the complete patient finder response using the search request ID from previous patient finder inquiries.

### Method
GET

### Endpoint
https://api.pverify.com/api/Test/GetPatientFinderResponse/{requestId}

### Parameters
#### Path Parameters
- **requestId** (string) - Required - The ID of the patient finder request.

### Request Example
```bash
curl --location 'https://api.pverify.com/api/Test/GetPatientFinderResponse/12345' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json'
```

### Response
#### Success Response (200)
- **Comprehensive patient insurance discovery results** (object) - The complete response for the patient finder inquiry.

#### Response Example
```json
{
  "requestId": "12345",
  "patient": {
    "patientId": "123e4567-e89b-12d3-a456-426614174000",
    "firstName": "John",
    "lastName": "Doe",
    "dob": "01/12/1953"
  },
  "insuranceDetails": [
    {
      "payerName": "Example Insurance",
      "policyNumber": "XYZ123456789",
      "effectiveDate": "01/01/2024",
      "expirationDate": "12/31/2024"
    }
  ]
}
```
```

--------------------------------

### GET /api/Test/GetInusuranceDiscoverySummaryResponse/{requestId}

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

Retrieves the response from an InsuranceDiscovery POST call using a unique request ID.

```APIDOC
## GET /api/Test/GetInusuranceDiscoverySummaryResponse/{requestId}

### Description
This endpoint retrieves the response from the InsuranceDiscovery POST call using a unique request ID provided in the InsuranceDiscovery response.

### Method
GET

### Endpoint
`https://api.pverify.com/api/Test/GetInusuranceDiscoverySummaryResponse/{requestId}`

### Parameters
#### Path Parameters
- **requestId** (string) - Required - The unique request ID returned in the InsuranceDiscovery response.

#### Query Parameters
None

#### Request Body
None

### Request Example
```
curl --location 'https://api.pverify.com/api/Test/GetInusuranceDiscoverySummaryResponse/467' \
--header 'Authorization: Bearer <YOUR_AUTH_TOKEN>' \
--header 'Client-API-Id: <YOUR_CLIENT_API_ID>' \
--header 'Content-Type: application/json' \
--data ''
```

### Response
#### Success Response (200)
No response body or headers are returned for this request. The details are expected to be found within the context of the initial InsuranceDiscovery response.
```

--------------------------------

### Get Insurance Discovery Summary Response API

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Retrieves the results of a previously submitted insurance discovery request using the unique request ID returned from the initial POST call.

```APIDOC
## GET /api/Test/GetInusuranceDiscoverySummaryResponse/{requestId}

### Description
Retrieves the results of a previously submitted insurance discovery request using the unique request ID returned from the initial POST call.

### Method
GET

### Endpoint
https://api.pverify.com/api/Test/GetInusuranceDiscoverySummaryResponse/{requestId}

### Parameters
#### Path Parameters
- **requestId** (string) - Required - The unique ID of the insurance discovery request.

### Response
#### Success Response (200)
- **RequestID** (integer) - The ID of the request.
- **APIResponseCode** (integer) - The response code from the API.
- **APIResponseMessage** (string) - A message describing the API response.
- **PayerName** (string) - The name of the insurance payer.
- **VerificationType** (string) - The type of verification performed.
- **DOS** (string) - The date(s) of service.
- **IsHMOPlan** (boolean) - Indicates if it's an HMO plan.
- **DemographicInfo** (object) - Demographic information.
- **ServiceDetails** (object) - Details about the services.
- **PlanCoverageSummary** (object) - Summary of the plan coverage.
- **HBPC_Deductible_OOP_Summary** (object) - Summary of deductible and out-of-pocket costs.
- **MedicareInfoSummary** (object) - Summary of Medicare information.

### Response Example
```json
{
  "RequestID": 467,
  "APIResponseCode": 0,
  "APIResponseMessage": "Processed",
  "PayerName": "Medicare Part B",
  "VerificationType": "Subscriber",
  "DOS": "01/01/2025 - 01/01/2025",
  "IsHMOPlan": false,
  "DemographicInfo": {},
  "ServiceDetails": {},
  "PlanCoverageSummary": {},
  "HBPC_Deductible_OOP_Summary": {},
  "MedicareInfoSummary": {}
}
```
```

--------------------------------

### GET Insurance Discovery Summary Response

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

Retrieves the response from an InsuranceDiscovery POST call using a request ID. Requires Authorization, Client-API-Id, and Content-Type headers. The request ID is provided in the InsuranceDiscovery response.

```curl
curl --location 'https://api.pverify.com/api/Test/GetInusuranceDiscoverySummaryResponse/467' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: <client-API-ID>' \
--header 'Content-Type: application/json' \
--data ''
```

--------------------------------

### Get Insurance Discovery Summary Response using cURL

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Retrieves the results of a previously submitted insurance discovery request using the unique request ID. This endpoint requires the request ID obtained from an initial POST call, along with authentication headers. The response includes payer information, verification type, and coverage details.

```bash
curl --location 'https://api.pverify.com/api/Test/GetInusuranceDiscoverySummaryResponse/467' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json'
```

--------------------------------

### OAuth Token Authentication

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Details on how to obtain OAuth 2.0 bearer tokens for API authentication.

```APIDOC
## OAuth Token Authentication

### Description
All API requests require authentication using OAuth 2.0 bearer tokens obtained from pVerify's token endpoint.

### Method
POST

### Endpoint
https://api.pverify.com/Token

### Parameters
#### Request Body
- **grant_type** (string) - Required - Must be 'client_credentials'.
- **client_id** (string) - Required - Your pVerify client ID.
- **client_secret** (string) - Required - Your pVerify client secret.

### Request Example
```bash
curl --location 'https://api.pverify.com/Token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=your_client_id_here' \
--data-urlencode 'client_secret=your_client_secret_here'
```

### Response
#### Success Response (200)
- **access_token** (string) - The OAuth 2.0 bearer token.
- **token_type** (string) - The type of token, usually 'Bearer'.
- **expires_in** (integer) - The time in seconds until the token expires.

#### Response Example
```json
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}
```

### Usage
Use the `access_token` in the `Authorization` header for all subsequent API calls:
`Authorization: Bearer {access_token}`
Include your `Client-API-Id` in the `Client-API-Id` header.
```

--------------------------------

### Submit Insurance Discovery Request

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Discovers insurance coverage for patients by searching across multiple payers. Requires Authorization, Client-API-Id headers and a JSON payload with patient demographics and state-specific criteria. Response includes a RequestID to retrieve summary results.

```bash
curl --location 'https://api.pverify.com/API/InsuranceDiscovery' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json' \
--data '{
  "patientStateId": 10,
  "patientState": "CA",
  "patientFirstName": "Jane",
  "patientLastName": "Smith",
  "patientDOB": "03/15/1980",
  "patientSSN": "987-65-4321",
  "patientGender": "F",
  "doS_StartDate": "01/01/2025",
  "doS_EndDate": "01/01/2025",
  "referenceId": "ACC-2025-001",
  "Notes": "Emergency admission - insurance unknown",
  "location": "ER-West"
}'
```

--------------------------------

### POST /api/PatientFinderInquiry

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

Initiates pVerify's Insurance Discovery service to find a patient's insurance coverage. Requires patient state information.

```APIDOC
## POST /api/PatientFinderInquiry

### Description
pVerify’s Insurance Discovery allows Hospitals and Providers to find a patient’s insurance coverage to collect potentially millions from insurance companies, allow prompt claim submission, increase patient payment collection, and drastically decrease Account Receivables. To run insurance discovery, a patient state is required.

### Method
POST

### Endpoint
`https://api.pverify.com/API/InsuranceDiscovery` (Production)
`https://api.pverify.com/Test/API/InsuranceDiscovery` (Test)

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **PatientState** (string) - Required - The state of the patient for insurance discovery.
- Other fields as required by the Insurance Discovery service (refer to specific service documentation for a complete list).

### Request Example
```json
{
  "PatientState": "CA",
  "PatientIdentifier": "...",
  "PayerIdentifier": "..."
}
```

### Response
#### Success Response (200)
- **MedicareInfoSummary** (object) - Returned for Medicare patients, containing Medicare-specific information such as Part A/B deductible, pharmacy payer name, MCA payer name, and more. Null for non-Medicare patients.
- Other insurance discovery response fields (refer to specific service documentation).

#### Response Example
```json
{
  "MedicareInfoSummary": {
    "partADeductible": "...",
    "partBDeductible": "...",
    "pharmacyPayerName": "..."
  },
  "InsuranceDetails": [
    // ... insurance details ...
  ]
}
```
```

--------------------------------

### Retrieve Patient Finder Response by ID

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Retrieves the complete patient finder response using the search request ID from previous inquiries. Requires Authorization, Client-API-Id headers and the request ID in the URL. Returns comprehensive patient insurance discovery results.

```bash
curl --location 'https://api.pverify.com/api/Test/GetPatientFinderResponse/12345' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json'
```

--------------------------------

### Submit Patient Finder Inquiry Results

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Submits refined search criteria to retrieve patient finder results with additional filtering parameters. Requires Authorization, Client-API-Id headers and a JSON payload with patient details. Response contains matching patient records.

```bash
curl --location 'https://api.pverify.com/Test/api/PatientFinderInquiryResults' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json' \
--data '{
  "FirstName": "John",
  "MiddleName": null,
  "LastName": "Doe",
  "DOB": "01/12/1953",
  "SSN": null,
  "PhoneNumber": null,
  "Address": {
    "AddressLine1": null,
    "AddressLine2": null,
    "City": null,
    "State": null,
    "ZipCode": null,
    "ReportedDate": null
  },
  "Location": null,
  "RequestSource": null,
  "ReferenceNumber": null,
  "SearchCriteriaId": null
}'
```

--------------------------------

### Patient Finder Inquiry API

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Initiates a patient search based on demographic information to discover insurance coverage for patients without known insurance details.

```APIDOC
## POST /Test/api/PatientFinderInquiry

### Description
Initiates a patient search based on demographic information to discover insurance coverage for patients without known insurance details.

### Method
POST

### Endpoint
https://api.pverify.com/Test/api/PatientFinderInquiry

### Parameters
#### Request Body
- **FirstName** (string) - Required - Patient's first name.
- **MiddleName** (string) - Optional - Patient's middle name.
- **LastName** (string) - Required - Patient's last name.
- **DOB** (string) - Required - Patient's date of birth (MM/DD/YYYY).
- **SSN** (string) - Optional - Patient's Social Security Number.
- **PhoneNumber** (string) - Optional - Patient's phone number.
- **Address** (object) - Optional - Patient's address.
  - **AddressLine1** (string) - Required - First line of the address.
  - **AddressLine2** (string) - Optional - Second line of the address.
  - **City** (string) - Required - City.
  - **State** (string) - Required - State.
  - **ZipCode** (string) - Required - Zip code.
- **Location** (string) - Optional - Location identifier.
- **ReferenceNumber** (string) - Optional - A reference number for the patient.

### Request Example
```json
{
  "FirstName": "John",
  "MiddleName": null,
  "LastName": "Doe",
  "DOB": "01/15/1975",
  "SSN": "123-45-6789",
  "PhoneNumber": "555-123-4567",
  "Address": {
    "AddressLine1": "123 Main Street",
    "AddressLine2": "Apt 4B",
    "City": "Los Angeles",
    "State": "CA",
    "ZipCode": "90001"
  },
  "Location": "CA1",
  "ReferenceNumber": "MRN123456"
}
```
```

--------------------------------

### Test Eligibility Inquiry using cURL

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Performs a test eligibility check for a patient against a specified insurance payer. This endpoint requires OAuth 2.0 bearer token authentication and a client API ID. It returns detailed coverage information including deductibles, copays, and plan details for the requested date of service.

```bash
curl --location 'https://api.pverify.com/Test/API/EligibilityInquiry' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json' \
--data '{
  "payerCode": "00007",
  "provider": {
    "firstName": "",
    "middleName": "",
    "lastName": "test name",
    "npi": "1122334455"
  },
  "subscriber": {
    "firstName": "first",
    "middleName": "",
    "lastName": "somelast",
    "dob": "12/21/2018",
    "memberID": "1234567890"
  },
  "dependent": {
    "patient": {
      "firstName": "",
      "middleName": "",
      "lastName": "",
      "dob": "",
      "gender": ""
    },
    "relationWithSubscriber": ""
  },
  "isSubscriberPatient": "true",
  "doS_StartDate": "12/21/2018",
  "doS_EndDate": "12/21/2018",
  "serviceCodes": ["30"],
  "requestSource": "RestAPI",
  "isHMOplan": true,
  "IncludeTextResponse": true,
  "referenceId": "1234",
  "Location": "Nowhere"
}'
```

--------------------------------

### POST /api/PatientFinderInquiry

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

This endpoint is used to find patient insurance information and verify eligibility. It requires demographic details of the patient and returns a comprehensive response with transaction status, payer information, and coverage details.

```APIDOC
## POST /api/PatientFinderInquiry

### Description
This endpoint is used to find patient insurance information and verify eligibility. It requires demographic details of the patient and returns a comprehensive response with transaction status, payer information, and coverage details.

### Method
POST

### Endpoint
/api/PatientFinderInquiry

### Headers
- **Authorization** (string) - Required - Bearer token for authentication.
- **Client-API-Id** (string) - Required - The client's API identifier.
- **Content-Type** (string) - Required - application/json

### Request Body
- **FirstName** (string) - Required - The first name of the patient.
- **MiddleName** (string) - Optional - The middle name of the patient.
- **LastName** (string) - Required - The last name of the patient.
- **DOB** (string) - Optional - Date of Birth in MM/DD/YYYY format.
- **SSN** (string) - Optional - Social Security Number in XXX-XX-XXXX format.
- **PhoneNumber** (string) - Optional - The patient's phone number.
- **Address** (object) - Optional - The patient's address details.
  - **AddressLine1** (string) - Required - Street address line 1.
  - **AddressLine2** (string) - Optional - Street address line 2.
  - **City** (string) - Required - City name.
  - **State** (string) - Required - State abbreviation (e.g., CA for California).
  - **ZipCode** (string) - Required - Zip code.
- **Location** (string) - Required - Location identifier.
- **ReferenceNumber** (string) - Optional - Reference number such as MRN.

### Request Example
```json
{
	"FirstName": "John",
	"MiddleName": null,
	"LastName": "Doe",
	"DOB": null, 
	"SSN": null, 
	"PhoneNumber": null,
	"Address": {
		"AddressLine1": "Address1",
		"AddressLine2": null,
		"City": "City",
		"State": "ST", 
		"ZipCode": "12345"
	},
	"Location": "CA1",
	"ReferenceNumber": null 
}
```

### Response
#### Success Response (200)
- **RequestID** (integer) - Eligibility Transaction ID.
- **APIResponseCode** (integer) - 0-Processed, 1-Rejected, 2-NoFunds, 3-Pending.
- **APIResponseMessage** (string) - Message about the transaction.
- **EDIErrorMessage** (string) - Message from Payer about errors.
- **PayerName** (string) - Payer Name as defined by pVerify.
- **VerificationType** (string) - Verification Type – Subscriber or dependent.
- **DOS** (string) - Date of service start date – DOS end date.
- **IsHMOPlan** (boolean) - If true then Patient has HMO plan.
- **ExceptionNotes** (string) - Exception Notes if any. If response demographic info is not matched with that of Request.
- **AddtionalInfo** (string) - If there is any other info.
- **Location** (string) - Location in which trans ran.
- **ReferrenceId** (string) - Referencid passed in request.
- **ResultPracticeType** (string) - Practice type Name.
- **AreAllSTCsProcessed** (boolean) - True when all service codes are processed by payer else false.
- **STCsStatusMessage** (string) - Contains message when AreAllSTCsProcessed=false.
- **Notes** (string) - Notes.
- **DemographicInfo** (object) - Contains the subscriber info or dependent info.
- **ServiceDetails** (object) - Contains all Service type details info.
- **PreventiveServices** (object) - Contains Preventive codes details.
- **OtherPayerInfo** (object) - Contains Other Payer info. It is null then there is no payer change.
- **PlanCoverageSummary** (object) - Contains Plan related info.
- **PCPAuthInfoSummary** (object) - Contains PCP auth info.
- **HBPC_Deductible_OOP_Summary** (object) - Contains Deductible and OOP in from Health benefit Plan Coverage service type.
- **MedicareInfoSummary** (object) - Contains Medicare info summary.
- **SpecialistOfficeSummary** (object) - Contains Specialist Consultation specific Summary (Co-Pay, Co-ins, Ded, OOP) and exclusive values of practice type.
- **ComboPayerResponses** (array of object) - Contains Combo Group payer responses.
- **MiscellaneousInfoSummary** (object) - Miscellaneous info summary.

#### Response Example
(No example provided in the source text)
```

--------------------------------

### POST /api/PatientFinderInquiryResults

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

Submits a patient finder inquiry with specified demographic and reference information to retrieve patient data.

```APIDOC
## POST /api/PatientFinderInquiryResults

### Description
Submits a patient finder inquiry with specified demographic and reference information to retrieve patient data.

### Method
POST

### Endpoint
https://api.pverify.com/Test/api/PatientFinderInquiryResults

### Headers
- **Authorization** (string) - Required - Bearer token for authentication.
- **Client-API-Id** (string) - Required - The client's API identifier.
- **Content-Type** (string) - Required - Must be application/json.

### Request Body
- **FirstName** (string) - Required - The first name of the patient.
- **MiddleName** (string) - Optional - The middle name of the patient.
- **LastName** (string) - Required - The last name of the patient.
- **DOB** (string) - Required - Date of Birth in MM/DD/YYYY format.
- **SSN** (string) - Optional - Social Security Number.
- **PhoneNumber** (string) - Optional - Patient's phone number.
- **Address** (object) - Optional - Patient's address details.
  - **AddressLine1** (string) - Optional
  - **AddressLine2** (string) - Optional
  - **City** (string) - Optional
  - **State** (string) - Optional
  - **ZipCode** (string) - Optional
  - **ReportedDate** (string) - Optional
- **Location** (string) - Optional - Location information.
- **RequestSource** (string) - Optional - Source of the request.
- **ReferenceNumber** (string) - Optional - A reference number for the inquiry.
- **SearchCriteriaId** (string) - Optional - Identifier for search criteria.

### Request Example
```json
{
	"FirstName": "John",
	"MiddleName": null,
	"LastName": "Doe",
	"DOB": "01/12/1953", 
	"SSN": null, 
	"PhoneNumber": null,
	"Address": {
		"AddressLine1": null,
		"AddressLine2": null,
		"City": null,
		"State": null, 
		"ZipCode": null,
        "ReportedDate":null
	},
	"Location": null,
    "RequestSource":null,
	"ReferenceNumber": null ,
    "SearchCriteriaId":null
}
```

### Response
This endpoint does not return a response body or headers upon success.
```

--------------------------------

### Patient Finder Inquiry using cURL

Source: https://context7.com/context7/documenter_getpostman_view_8401811_tw6wjtmj/llms.txt

Initiates a patient search based on demographic information to discover insurance coverage for patients without known insurance details. This endpoint requires demographic data and location information, along with authentication headers. It is used for insurance discovery when patient insurance details are unavailable.

```bash
curl --location 'https://api.pverify.com/Test/api/PatientFinderInquiry' \
--header 'Authorization: Bearer WqO4b4o72_0lX5iMPMSFztAWxUYSVtKLKJXoE3afIPuNAf88qmRAHvV1e9b3RXBPNJyQkg7y4joMJCrA7TD13TL79GCmdHZ1Hdb1o8ryWS_O3pmc45c2rsF0ap1cioh0YiBZUq8n8UZVIzSIjo3gGz52SmjBZraizVmdRm2HX7baDuvNFEUT789uHMlt2uOeC2gFlwroQFDa4kJlJVKXSY2J23GDgUMws9_3oXI5E7MyuoU1ZK-gyBvZM3TwgiQ35tjz6PSf7jQY2wx7E_k4fg' \
--header 'Client-API-Id: abc123def456' \
--header 'Content-Type: application/json' \
--data '{
  "FirstName": "John",
  "MiddleName": null,
  "LastName": "Doe",
  "DOB": "01/15/1975",
  "SSN": "123-45-6789",
  "PhoneNumber": "555-123-4567",
  "Address": {
    "AddressLine1": "123 Main Street",
    "AddressLine2": "Apt 4B",
    "City": "Los Angeles",
    "State": "CA",
    "ZipCode": "90001"
  },
  "Location": "CA1",
  "ReferenceNumber": "MRN123456"
}'
```

--------------------------------

### POST /Test/API/EligibilityInquiry

Source: https://documenter.getpostman.com/view/8401811/TW6wJTmj/index

The EligibilityInquiry endpoint allows you to test eligibility checks without using real patient data. It requires authentication credentials and a JSON request body containing payer, provider, subscriber, and service details.

```APIDOC
## POST /Test/API/EligibilityInquiry

### Description
Tests eligibility inquiries without using real patient data. Recommended for testing purposes, with production endpoints available for specific scenarios.

### Method
POST

### Endpoint
https://api.pverify.com/Test/API/EligibilityInquiry

### Parameters
#### Headers
- **Authorization** (string) - Required - Bearer token for authentication.
- **Client-API-Id** (string) - Required - Your client API ID.
- **Content-Type** (string) - Required - application/json

#### Request Body
- **payerCode** (string) - Required - The code for the payer.
- **provider** (object) - Required - Information about the provider.
  - **firstName** (string) - Optional - Provider's first name.
  - **middleName** (string) - Optional - Provider's middle name.
  - **lastName** (string) - Required - Provider's last name.
  - **npi** (string) - Required - Provider's National Provider Identifier.
- **subscriber** (object) - Required - Information about the subscriber.
  - **firstName** (string) - Required - Subscriber's first name.
  - **middleName** (string) - Optional - Subscriber's middle name.
  - **lastName** (string) - Required - Subscriber's last name.
  - **dob** (string) - Required - Subscriber's date of birth (MM/DD/YYYY).
  - **memberID** (string) - Required - Subscriber's member ID.
- **dependent** (object) - Optional - Information about the dependent.
  - **patient** (object) - Optional - Details of the patient if dependent.
    - **firstName** (string) - Optional - Patient's first name.
    - **middleName** (string) - Optional - Patient's middle name.
    - **lastName** (string) - Optional - Patient's last name.
    - **dob** (string) - Optional - Patient's date of birth.
    - **gender** (string) - Optional - Patient's gender.
  - **relationWithSubscriber** (string) - Optional - Relationship of the dependent to the subscriber.
- **isSubscriberPatient** (string) - Required - Boolean value indicating if the subscriber is the patient ('true' or 'false').
- **doS_StartDate** (string) - Required - Date of Service start date (MM/DD/YYYY).
- **doS_EndDate** (string) - Required - Date of Service end date (MM/DD/YYYY).
- **serviceCodes** (array) - Required - An array of service codes.
  - **string** (string) - A service code.
- **requestSource** (string) - Optional - Source of the request (e.g., "RestAPI").
- **isHMOplan** (boolean) - Optional - Indicates if it's an HMO plan.
- **IncludeTextResponse** (boolean) - Optional - Whether to include a text response.
- **referenceId** (string) - Optional - A reference identifier for the request.
- **Location** (string) - Optional - Location information.

### Request Example
```json
{
  "payerCode": "00007",
  "provider": {
    "firstName": "",
    "middleName": "",
    "lastName": " test name",
    "npi": "1122334455"
  },
  "subscriber": {
    "firstName": "first",
    "middleName": "",
    "lastName": "somelast",
    "dob": "12/21/2018",
    "memberID": "1234567890"
  },
  "dependent": {
    "patient": {
      "firstName": "",
      "middleName": "",
      "lastName": "",
      "dob": "",
      "gender": ""
    },
    "relationWithSubscriber": ""
  },
  "isSubscriberPatient": "true",
  "doS_StartDate": "12/21/2018",
  "doS_EndDate": "12/21/2018",
  "serviceCodes": [
    "30"
  ],
  "requestSource": "RestAPI",
  "isHMOplan": true,
  "IncludeTextResponse": true,
  "referenceId": "1234",
  "Location": "Nowhere"
}
```

### Response
#### Success Response (200)
This endpoint does not return a response body upon success.

#### Response Example
No response body
```