Skip to content
  • There are no suggestions because the search field is empty.

Axio360 API Reference: Assessment Capabilities

Axio360 API Reference

Assessment Capabilities

This document describes the Axio360 API capabilities related to assessments. Each section explains what an API call does, what information it provides, and when you might use it. To authenticate API requests, see How to find your Axio360 API key.

1. Browsing & Retrieving Assessments

List All Assessments

Use this when you want a high-level view of everything in your account before diving into any single assessment.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Assessment ID
  • Assessment name
  • Description
  • Associated model (framework) UUID
  • Tags — the labels applied to the assessment (empty if none are set)
Common use cases
  • Seeing all assessments in your account at a glance
  • Finding an assessment ID to use in a follow-up call
  • Building a master list or index for reporting

Get Full Assessment Details

Use this when you need the complete picture of a specific assessment — every practice, every response, every action item, and every note.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Assessment name, description, and tags
  • All practice responses — the current answer for each control (e.g., "Largely Implemented")
  • Target response level per practice — the level the user has set as their goal; returns an explicit "no target set" indicator if none has been set
  • Target date per practice — the date by which the user expects to reach that target (null if not set)
  • Action items per practice, including:
    • Action item text and due date
    • Completion flag (isDone) and computed status — Done, Not Done, or Overdue
    • Assignee — user ID and display name (null if unassigned)
    • Criticality — IMPORTANT or ADDITIONAL
    • Whether the action item is linked to the practice's target score
  • Notes per practice
Common use cases
  • Pulling a full assessment snapshot for an audit or review
  • Feeding assessment data into an external reporting tool or BI dashboard
  • Comparing current vs. target responses to identify and prioritize gaps
  • Exporting action items with owner and status for tracking in a spreadsheet or ticketing system

Get Assessment Scores

Use this when you want a scoring summary without needing the full detail of every individual response.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Percent complete — how much of the assessment has been answered
  • Overall assessment score (current, target, and maximum possible)
  • Scores by domain (major category, e.g., Govern, Identify, Protect)
  • Scores by objective (sub-category within each domain)
Common use cases
  • Displaying a score summary on an executive dashboard
  • Tracking score changes over time by calling this periodically
  • Comparing current vs. target scores to identify gaps at the domain or objective level

2. Assessment Models (Frameworks)

List All Assessment Models

Assessment models are the frameworks that assessments are built on — such as NIST CSF, C2M2, or CIS Controls. Use this call when you need to know which frameworks are available in your account.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Model UUID (required when creating a new assessment)
  • Model title / framework name
Common use cases
  • Finding the UUID of a specific framework before creating a new assessment
  • Inventorying which frameworks your account has licensed

Get Assessment Model Details

Use this when you need to understand the full structure of a framework — every practice (control question) and the possible answer options for each.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • All practices (controls/questions) within the model
  • Answer dimensions and the available levels for each (e.g., Not Implemented → Fully Implemented)
  • Full qualified names (FQNs) used to reference practices in other calls
Common use cases
  • Building a custom form or interface that mirrors the assessment structure
  • Understanding all answer options before programmatically updating responses
  • Mapping your internal control library to Axio360 practice identifiers

3. Creating & Updating Assessments

Create a New Assessment

Use this to programmatically spin up a new assessment — for example, as part of an onboarding workflow or automated provisioning process.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • The newly created assessment's ID and details
  • Confirmation of any initial practice responses that were provided
Common use cases
  • Automating assessment setup for new business units or clients
  • Importing assessment data from another system into Axio360
  • Programmatically seeding a new assessment with baseline responses

Update an Existing Assessment

Use this to modify an assessment that already exists — changing its name, description, or updating responses to specific practices.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Confirmation of the updated assessment state
  • Reflects changes to name, description, and/or practice responses
Common use cases
  • Pushing updated practice responses from an external tool back into Axio360
  • Renaming or re-describing an assessment to match an organizational change
  • Syncing assessment data from a ticketing system or GRC platform

4. Tags

Get Tags for an Assessment

Use this to retrieve the tags associated with a specific assessment, or to filter assessments by tag name across your account.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • All tag labels applied to the assessment
  • Empty value if no tags have been set
Common use cases
  • Programmatically grouping or filtering assessments by tag without manual intervention in the UI
  • Building tag-based reporting across assessments (e.g., all assessments tagged "Tier 1")
  • Checking which tags are applied to an assessment before updating or reporting on it

5. Action Items

Get All Action Items Across Assessments

Use this to retrieve a consolidated view of all action items across every assessment — without having to pull each assessment individually.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Assessment name
  • Practice ID — the control the action item is tied to
  • Action item name / description
  • Assignee — user ID and display name (null if unassigned)
  • Due date
  • Computed status — Done, Not Done, or Overdue
Common use cases
  • Feeding open action items into a ticketing system (e.g., Azure DevOps, Jira) automatically
  • Building a consolidated remediation dashboard across all assessments
  • Closing out tickets in an external system when an action item is marked Done in Axio360
Native integrations

6. Milestones

Get Assessment Milestones

Use this to retrieve the historical score snapshots recorded for an assessment over time.

Tables can't be imported directly. Please insert an image of your table which can be found here.

EndpointWhat it doesWhat it returns
  • Milestone name and date
  • Score snapshot at the time the milestone was created
  • Current score, target score, and maximum possible score — enabling direct before/after comparison
Common use cases
  • Charting score improvement over time in a BI tool or executive dashboard
  • Demonstrating progress to auditors or leadership by comparing milestone snapshots
  • Benchmarking historical vs. current performance at the assessment level

Quick Reference

Tables can't be imported directly. Please insert an image of your table which can be found here.