Skip to main content
GET
/
results
Returns result information for one or more users based on filters provided.
curl --request GET \
  --url https://api.smartermeasure.com/v3/results \
  --header 'Authorization: Basic <encoded-value>'
{
  "NumPages": "7",
  "Page": "1",
  "PageSize": "50",
  "Total": "345",
  "Start": "1",
  "End": "50",
  "FirstPageUri": "/v3/results?PAGE=1",
  "LastPageUri": "/v3/results?PAGE=7",
  "PreviousPageUri": "",
  "NextPageUri": "/v3/results?PAGE=2",
  "User": [
    {
      "RowNumber": "1",
      "UserId": "10000001",
      "InternalId": "STU-001",
      "CompletionPercentage": "0",
      "DateTimeTaken": "2026-03-20T18:40:08Z",
      "Account": {
        "Id": "410",
        "Name": "DEMO - Integration School"
      },
      "FirstName": "Alice",
      "LastName": "Carter",
      "EmailAddress": "alice.carter@example.com",
      "AssessmentResults": [
        {
          "Title": "Life Factors",
          "Code": "LifeFactors",
          "IsComplete": "0"
        },
        {
          "Title": "Learning Styles",
          "Code": "LearnStyles",
          "IsComplete": "0"
        },
        {
          "Title": "Personal Attributes",
          "Code": "PersonalAttributes",
          "IsComplete": "0"
        },
        {
          "Title": "Technical Competency",
          "Code": "TechComp",
          "IsComplete": "0"
        },
        {
          "Title": "Technical Knowledge",
          "Code": "TechKnowledge",
          "IsComplete": "0"
        },
        {
          "Title": "Reading Rate & Recall",
          "Code": "Reading",
          "IsComplete": "0"
        },
        {
          "Title": "Typing Speed & Accuracy",
          "Code": "Typing",
          "IsComplete": "0"
        }
      ]
    },
    {
      "RowNumber": "2",
      "UserId": "10000002",
      "InternalId": "STU-002",
      "CompletionPercentage": "100",
      "DateTimeTaken": "2026-02-27T10:27:44Z",
      "DateTimeLastUpdated": "2026-02-27T10:33:38Z",
      "DateTimeCompleted": "2026-02-27T10:33:38Z",
      "Account": {
        "Id": "410",
        "Name": "DEMO - Integration School"
      },
      "FirstName": "Marcus",
      "LastName": "Webb",
      "EmailAddress": "marcus.webb@example.com",
      "AssessmentResults": [
        {
          "Title": "Life Factors",
          "Code": "LifeFactors",
          "IsComplete": "0"
        },
        {
          "Title": "Learning Styles",
          "Code": "LearnStyles",
          "IsComplete": "1",
          "AttemptNumber": "1",
          "Percent": "23.81",
          "Readiness": "fail",
          "Primary": "Aural, Logical, Social",
          "DateTimeCompleted": "2026-02-27T10:33:00Z"
        },
        {
          "Title": "Personal Attributes",
          "Code": "PersonalAttributes",
          "IsComplete": "0"
        },
        {
          "Title": "Technical Competency",
          "Code": "TechComp",
          "IsComplete": "0"
        },
        {
          "Title": "Technical Knowledge",
          "Code": "TechKnowledge",
          "IsComplete": "1",
          "AttemptNumber": "1",
          "Percent": "31.48",
          "Readiness": "fail",
          "DateTimeCompleted": "2026-02-27T10:34:00Z"
        },
        {
          "Title": "Reading Rate & Recall",
          "Code": "Reading",
          "IsComplete": "0"
        },
        {
          "Title": "Typing Speed & Accuracy",
          "Code": "Typing",
          "IsComplete": "0"
        }
      ]
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic authentication with username and password

Query Parameters

​
UserID
string

This can be a comma sep. list of SmarterMeasure user IDs.

​
InternalID
string

InternalID

​
FirstName
string

FirstName

​
LastName
string

LastName

​
EmailAddress
string

EmailAddress

​
Gender
string

Gender

​
AdminGroupUserName
string

AdminGroupUserName

​
TestingGroupUserName
string

TestingGroupUserName

​
ExtendedData
string

ExtendedData - If passed in, the results will include the detailed scores for the sections passed in here. This is a comma delimited list. Valid data points are LifeFactors, LearnStyles, PersonalAttributes, TechComp, TechKnowledge, Demographic.

​
IncludeAccountRequestedData
boolean
default:false

IncludeAccountRequestedData

​
StartDate
string

StartDate - When wanting to filter by date started, this is the start date of the date range.

​
EndDate
string

EndDate - When wanting to filter by date started, this is the end date of the date range.

​
UpdateStartDate
string

UpdateStartDate - When wanting to filter by date updated, this is the start date of the date range.

​
UpdateEndDate
string

UpdateEndDate - When wanting to filter by date updated, this is the end date of the date range.

​
CompletionStartDate
string

CompletionStartDate - When wanting to filter by date completed, this is the start date of the date range.

​
CompletionEndDate
string

CompletionEndDate - When wanting to filter by date completed, this is the end date of the date range.

​
StartRecord
integer
default:1

StartRecord

​
EndRecord
integer
default:50

EndRecord

Response

200 - application/json

A list of user results.

​
NumPages
string

Total number of pages.

​
Page
string

Current page number.

​
PageSize
string

Number of records per page.

​
Total
string

Total number of records.

​
Start
string

Start record index for the current page.

​
End
string

End record index for the current page.

​
FirstPageUri
string
​
LastPageUri
string
​
PreviousPageUri
string

Empty string if on first page.

​
NextPageUri
string

Empty string if on last page.

​
User
object

One or more user result records. Returns an object when there is a single result, or an array when there are multiple results.