Fetch assessments

Use GET /v1/users/{userId}/assessments to retrieve assessment results for one user.

Supported query params

  • page: positive integer, defaults to 1
  • date_from: inclusive ISO-8601 timestamp lower bound
  • date_to: inclusive ISO-8601 timestamp upper bound

Request

curl --request GET \
  --url "$REPORTING_API_BASE_URL/v1/users/user-123/assessments?page=1" \
  --header "Authorization: Bearer $SKYLAR_REPORTING_API_KEY"

Success response

{
  "data": [
    {
      "session_id": "conversation-123",
      "completed_at": "2026-04-08T10:05:00.000Z",
      "strongest_criteria": "Discovery",
      "criteria": [
        {
          "name": "Discovery",
          "score": 4,
          "description": "Asked strong discovery questions."
        }
      ],
      "coach_feedback": "Push on next steps sooner."
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 100,
    "has_next_page": false
  }
}

Integration notes

  • strongest_criteria summarizes the highest scoring area when present.
  • Each criteria item includes the name, numeric score, and description.
  • coach_feedback is optional and may not be present on every assessment.