# Get GradScore

MeasureOne's Gradscore is a proprietary predictive analytic that provides an assessment of an Individual's academic persistence rate (probability of the student to be enrolled or graduated 12 months from measurement).   This endpoint calculates and returns the Gradscore based on the Individual's transcript. 


Endpoint: POST /v3/services/gradscore
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)
    Unique ID of the transcript identified by MeasureOne

## Response 200 fields (application/json):

  - `service_context_id` (string)
    Unique ID of the service context identified by MeasureOne

  - `items` (array)

  - `items.id` (string)

  - `processing_status` (string)
    Enum: "COMPLETED", "IN_PROGRESS"

  - `gradscore` (object)

  - `gradscore.grad_score` (number)
    MeasureOne's GradScore for the requested transcript

  - `gradscore.aa_code_1` (number)
    First adverse action code that can be used for decline decisions

  - `gradscore.aa_code_2` (number)
    Second adverse action code that can be used for decline decisions

  - `gradscore.aa_code_3` (number)
    Third adverse action code that can be used for decline decisions

  - `gradscore.version` (string)
    Version of the MeritScore

  - `transaction_id` (string)

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

  - `http_code` (number)
    Example: 405

## Response 422 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

  - `reason_codes` (array)
    List of reason codes. Helps developer understand what error occurred during processing an item.

  - `reason_codes.code` (string)
    Reason code applicable
 |Reason Code|Description|
 |--- |--- |
 |UNSUPPORTED_FORMAT| The report could not be generated as the following items are of unsupported format.
 |UNPROCESSABLE_DOCUMENT_QUALITY| The report could not be generated as the following items are unprocessable.
 |PARTIAL_DOCUMENT| The report could not be generated as the following items are partial.
 |NO_ITEMS| The report could not be generated as there are no items for this Individual.

  - `reason_codes.description` (string)
    Description providing details to understand what error occurred during processing an item.

  - `reason_codes.context` (object)
    Context to understand where the reason code is applicable

  - `reason_codes.context.items` (array)
    List of Items where the reason code is applicable

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error