Examination Scores API
The Examinations Scores API allows access to an individual’s NAPLEX and MPJE scores. The data returned from this API can be found below.
Parties requesting an API key will need to contact our technology department and follow the setup guidelines provided.
The Examination Scores API provides NAPLEX or MPJE information for an individual using the provided parameters.
Method | API |
POST | v2/individual/eprofile/score |
Parameters
Name | Value | Description |
eProfileId | Integer | e-Profile ID of the Individual |
DOB | String | Date of Birth (Format: MM-dd) |
Result | String | (Optional) Values: Pass or Fail |
Exam | String | (Optional) Values: NAPLEX or MPJE |
Returned Data
A list of scores will be returned. Scores consist of the following fields:
Name | Value | Description |
eProfileId | Int | e-Profile ID of the person |
FirstName | String | First name of the person |
MiddleName | String | Middle name of the person |
LastName | String | Last name of the person |
DOB | String | Date of birth of the person (Format: MM-DD) |
Last4ssn | String | Last four digits of the person’s social security number |
Disciplined | Boolean | Is there a disciplinary action against that person in any state? |
Scores | A list of the following data combination and returns list of scores for the user for the state requesting scores | |
Scores.ApplicationID | Integer | Application ID of exam |
Scores.ExamDate | String | Date of the examination (Format: YYYY-MM-DD) |
Scores.AttemptNumber | Integer | Attempt number for the given exam |
Scores.Score | Integer | Score |
Scores.Result | String | Pass or Fail |
Scores.Exam | String | Type of examination |
Scores.PostDate | String | Results posted date (Format: YYYY-MM-DD) |
InvalidatedScores | A list of the following data combination and returns list of all the invalid scores for the given user if it is present. If not present, this will be empty. | |
InvalidatedScores.ExamName | String | Exam name |
invalidatedScores.State | String | Exam state |
InvalidatedScores.ExamDate | String | Exam date (Format: YYYY-MM-DD) |
Responses
Status Code | Description |
200 | Successful response |
400 | Invalid request/Please retry |
401 | Unauthorized |
403 | Forbidden |
404 | No scores available |
409 | Provided DOB is not a match/e-Profile not found |
500 | Error while processing request |
Example:
{
“eProfileId”: 165436,
“firstName”: “Youssef”,
“middleName”: “ahmad”,
“lastName”: “Barakate”,
“dob”: “07-20”,
“last4SSN”: “4175”,
“disciplined”: false,
“scores”: [
{
“applicationId”: 93,
“examDate”: “2011-12-29”,
“attemptNumber”: 3,
“score”: 72,
“result”: “FAILED”,
“exam”: “MPJE”,
“postDate”: “2012-01-03”,
},
{
“applicationId”: 95,
“examDate”: “2012-03-17”,
“attemptNumber”: 4,
“score”: 80,
“result”: “PASSED”,
“exam”: “MPJE”,
“postDate”: “2012-03-20”,
},
{
“applicationId”: 98,
“examDate”: “2011-05-19”,
“attemptNumber”: 2,
“score”: 89,
“result”: “PASSED”,
“exam”: “NAPLEX”,
“postDate”: “2011-05-23”,
},
{
“applicationId”: 99,
“examDate”: “2003-10-09”,
“attemptNumber”: 1,
“score”: 61,
“result”: “FAILED”,
“exam”: “NAPLEX”,
“postDate”: “2003-10-10”,
}
],
“invalidatedScores”: null
}
Looking for additional assistance?
Contact the Member Relations and Government Affairs team for API requests or incidents.