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)
- 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
- 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)
- 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
- 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
- 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
- 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
- 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
- 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
- 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
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
- 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.