Overview

This guide explains how to create New Service Requests for Payer Enrollments.

Creating Payer Enrollment New Service Requests

You can create Payer Enrollment New Service Requests for a Group or a Provider.

You can easily use the Medallion API Platform UI for creating Payer Enrollment New Service Requests by going to POST a Payer Enrollment Service Request endpoint.

Preparation

Gather your Payer's State and Name and also if you know your Payer's unique UUID. Set these parameters

state = "<YOUR_PAYER_STATE>"
payer_name = "<YOUR_PAYER_NAME>"
payer_id= "<YOUR_PAYER_ID>" #set if you know

is_medallion_owned = True #True if the request will be owned by Medallion, False if owned by your org

You might want to add Lines of Business to your request. If you do not know IDs for lines of business, you can use the GET Lines Of Business endpoint and get the IDs corresponding to the business lines you want. If you are using the Medallion API Platform UI, you can click on ADD OBJECT under lines_of_business to add the each Line of Business ID you want. If you are not using the Medallion API Platform UI

lines_of_business = [{ "id": "<LINE_OF_BUSINESS_ID>" }, { "id": "<LINE_OF_BUSINESS_ID>" }]

Similarly, you may want to add Practices to your request. If you are using the Medallion API Platform UI, you can click on ADD OBJECT under practices to add the each Line of Business ID you want. You need the ID of the Practice and other Practice parameters such name and address related parameters are optional. If you are not using the Medallion API Platform UI

practices = [
        {
            "id": "<PRACTICE_ID>",
            "name": "<PRACTICE_NAME>",
            "country": "<PRACTICE_COUNTRY>",
        },
        {
        "id": "<PRACTICE_ID>",
        }
    ],

New Request for a Group

Gather your Group Profile ID. If you did not saved your Group Profile ID, you can use the GET Group Profiles endpoint with a search or name to find it. Then set group_profile with this ID.

If you are using the Medallion API Platform UI, please select NewGroupPayerEnrollmentServiceRequest body parameter.

If you are requesting outside of the the Medallion API Platform UI

import requests

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}

group_profile="<GROUP_PROFILE_ID>"
state = "<YOUR_PAYER_STATE>"
payer_name = "<YOUR_PAYER_NAME>"
payer_id= "<YOUR_PAYER_ID>" #set if you know

is_medallion_owned = True #True if the request will be owned by Medallion, False if owned by your org
resourcetype= "NewGroupPayerEnrollmentServiceRequest"

#lines_of_business and practices are optional
lines_of_business = [{ "id": "<LINE_OF_BUSINESS_ID>" }, { "id": "<LINE_OF_BUSINESS_ID>" }]
practices = [
        {
            "id": "<PRACTICE_ID>",
            "name": "<PRACTICE_NAME>",
            "country": "<PRACTICE_COUNTRY>",
        },
        {
        "id": "<PRACTICE_ID>",
        }
    ]

url = "https://app.medallion.co/p/api/v1/service-requests/payer-enrollments/"

payload = {
    "group_profile":group_profile,
    "state":state,
    "payer_name":payer_name,
    "payer_id":payer_id,
    "is_medallion_owned": is_medallion_owned,
    "resourcetype": resourcetype,
    "lines_of_business":lines_of_business,
    "practices":practices
}

response = requests.post(url, json=payload, headers=headers)
response_json = response.json()
print(response_json)

New Request for a Provider

Gather your your Provider's ID. If you did not saved your Provider's ID, you can use the GET Providers endpoint with a search to find them again, e.g. with requests.get(providers_url, params={"search": "[email protected]"}, headers=headers) . Then set provider with this ID.

If you are using the Medallion API Platform UI, please select NewProviderPayerEnrollmentServiceRequest body parameter.

import requests

headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}

provider = "<PROVIDER_ID>"
state = "<YOUR_PAYER_STATE>"
payer_name = "<YOUR_PAYER_NAME>"
payer_id= "<YOUR_PAYER_ID>" #set if you know

is_medallion_owned = True #True if the request will be owned by Medallion, False if owned by your org
resourcetype= "NewProviderPayerEnrollmentServiceRequest"

#lines_of_business and practices are optional
lines_of_business = [{ "id": "<LINE_OF_BUSINESS_ID>" }, { "id": "<LINE_OF_BUSINESS_ID>" }]
practices = [
        {
            "id": "<PRACTICE_ID>",
            "name": "<PRACTICE_NAME>",
            "country": "<PRACTICE_COUNTRY>",
        },
        {
        "id": "<PRACTICE_ID>",
        }
    ]

url = "https://app.medallion.co/p/api/v1/service-requests/payer-enrollments/"

payload = {
    "provider":provider,
    "state":state,
    "payer_name":payer_name,
    "payer_id":payer_id,
    "is_medallion_owned": is_medallion_owned,
    "resourcetype": resourcetype,
    "lines_of_business":lines_of_business,
    "practices":practices
}

response = requests.post(url, json=payload, headers=headers)
response_json = response.json()
print(response_json)