NAV
bash php python javascript

Info

Welcome to the generated API reference. Get Postman Collection

Authorization

Authorization is done by using the Bearer token provided to you when you became a partner. The authorization header will therefor look like this: Authorization: Bearer {TOKEN}

In case of a failed authorization you will always receive a 401 Unauthorized response header with the following body: { "message": "Unauthenticated." }

Additional notes

The Content-Type and Accept are optional but recommended and they should both be application/json

In case of a validation errors you will always receive a 422 Unprocessable Entity header. Example: { "zip": [ "The zip code is required" ] }

Leads

api/leads/add


Requires authentication

Example request:

curl -X POST \
    "https://api.medicaidplanningassistance.org/api/leads/add" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -H "Authorization: Bearer {token}" \
    -d '{"first_name":"John","last_name":"Smith","email":"john.smith@example.com","phone":"2182222222","zip":"12345","city":"Los Angeles","state":"CA"}'


$client = new \GuzzleHttp\Client();
$response = $client->post(
    'https://api.medicaidplanningassistance.org/api/leads/add',
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'Authorization' => 'Bearer {token}',
        ],
        'json' => [
            'first_name' => 'John',
            'last_name' => 'Smith',
            'email' => 'john.smith@example.com',
            'phone' => '2182222222',
            'zip' => '12345',
            'city' => 'Los Angeles',
            'state' => 'CA',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'https://api.medicaidplanningassistance.org/api/leads/add'
payload = {
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@example.com",
    "phone": "2182222222",
    "zip": "12345",
    "city": "Los Angeles",
    "state": "CA"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Bearer {token}'
}
response = requests.request('POST', url, headers=headers, json=payload)
response.json()
const url = new URL(
    "https://api.medicaidplanningassistance.org/api/leads/add"
);

let headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Authorization": "Bearer {token}",
};

let body = {
    "first_name": "John",
    "last_name": "Smith",
    "email": "john.smith@example.com",
    "phone": "2182222222",
    "zip": "12345",
    "city": "Los Angeles",
    "state": "CA"
}

fetch(url, {
    method: "POST",
    headers: headers,
    body: body
})
    .then(response => response.json())
    .then(json => console.log(json));

Example response (200):

{
    "id": 4,
    "name": "Jessica Jones",
    "error": false,
    "message": "Lead Accepted"
}

Example response (422):

{
    "error": true,
    "message": "The phone number is required"
}

Example response (422):

{
    "error": true,
    "message": "The zip code must be numeric with a length of 5"
}

HTTP Request

POST api/leads/add

Body Parameters

Parameter Type Status Description
first_name string required The first name must be a string between 1 and 100 characters
last_name string required The last name must be a string between 1 and 100 characters
email string required A valid email address.
phone string required The phone number must be a string of 10 digits [0-9]{10}
state string required The 2 letter state code of the lead. Example: CA
medicaid_enrollment_status string optional If provided, valid values are: one of ["Currently on Medicaid", "Medicaid Application Pending", "Medicaid Application Denied", "Not Yet Applied for Medicaid", "Will Not Apply for Medicaid", "Currently on Medicaid Long Term Care", "Currently on Regular Medicaid" ]
zip string optional If provided, the zip code must be a string of digits with a length of 5
city string optional If provided, the city must be a string between 2 and 200 characters
source_id int optional Only if a source_id has been provided to you
relationship_to_claimant string optional If provided, valid values are: one of ["N/A", "Parent", "Spouse", "Yourself", "Loved one", "Client"]
marital_status string optional If provided, valid values are: one of ["N/A", "Not Married", "Married", "Divorced", "Widowed", "Never married"]
type_of_care string optional If provided, valid values are: one of ["Nursing home", "Assisted living", "Home care", "Assisted Living & Home Care", "Not Sure or Other"]
age string optional If provided, valid values are: one of ["Under 65", "Under 65 and Legally Disabled", "65 - 85", "Over 85"]
out_of_pocket_cost string optional If provided, valid values are: one of ["Less than $2,000", "Between $2,000 - $3,000", "Between $3,000 - $4,000", "Over $4,000", "Unknown"]
description string optional We suggest that you concatenate all available data points in this field

Support and Bug Reports

We encourage you to send any potential bug reports to info[at]codepunker.com.

If you send a bug report, your issue should contain a title and a clear description of the issue. You should also include as much relevant information as possible and a code sample that demonstrates the issue.

Security Vulnerabilities

If you discover a security vulnerability within our API, please send an email to Daniel Gheorghe at info[at]codepunker.com. All security vulnerabilities will be promptly addressed.

bash php python javascript