Download OpenAPI specification:Download
The eMASS Representational State Transfer (REST) Application Programming Interface (API) enables users to perform assessments and complete actions associated with system records.
The eMASS API provides an interface for application to communicate eMASS Services. For information on how to register and use the eMASS API reference the eMASS API Getting Started.
Additional information about eMASS can be obtain by contacting the National Industrial Security Program (NISP). Points of Contact are:
The Registration endpoint provides the ability to register a certificate & obtain an API-key.
Note:
Returns the API Key (api-key) that must be provided in the request header for all endpoint calls.
{- "meta": {
- "code": 200
}, - "data": {
- "apikey": "f0126b6b-f232-45c9-a8de-01d5f003deda"
}
}
The Systems endpoints provide the ability to view system information.
Notes
Returns all system(s) that match the query parameters
coamsId | string COAMS ID: Filter query by Cyber Operational Attributes Management System (COAMS). |
ditprId | string DITPR ID: Filter query by DoD Information Technology (IT) Portfolio Repository (DITPR). |
includeDecommissioned | boolean Default: true Include Decommissioned Systems: Indicates if decommissioned systems are retrieved. If no value is specified, the default returns true to include decommissioned systems. |
includeDitprMetrics | boolean Default: false Include DITPR: Indicates if DITPR metrics are retrieved. This query string parameter cannot be used in conjunction with the following parameters:
If no value is specified, the default returns false to not include DITPR Metrics. |
policy | string Default: "rmf" Enum: "diacap" "rmf" "reporting" System Policy: Filter query by system policy. If no value is specified, the default returns RMF policy information for dual-policy systems. |
registrationType | string Default: "regular" Registration Type: Filter record by selected registration type (single value or comma delimited values). Valid Options Are: assessAndAuthorize, assessOnly, guest, regular, functional, cloudServiceProvider, commonControlProvider, authorizationToUse, reciprocityAcceptanc |
reportsForScorecard | boolean Default: true DoD Cyber Hygiene Scorecard: Used to filter results to only return systems that report to the DoD Cyber Hygiene Scorecard. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "registrationCompletionDate": 1638741770,
- "systemLifeCycleAcquisitionPhase": "Pre-Milestone A",
- "specialType": "Special Type 1",
- "specialTypeDescription": "Test Special Type Description",
- "missionPortfolio": "Not Applicable",
- "isNNPI": false,
- "isRBC": false,
- "isWaiver": true,
- "programOffice": "Test Program Office",
- "vramId": "12345",
- "systemId": 33,
- "policy": "RMF",
- "registrationType": "Assess and Authorize",
- "name": "System XYZ",
- "acronym": "PM-6",
- "description": "This is a test system for the eMASS API documentation",
- "instance": "Navy",
- "owningOrganization": "Defense Information Systems Agency",
- "secondaryOrganization": "ID31",
- "versionReleaseNo": "V1",
- "systemType": "IS Major Application",
- "isNSS": true,
- "isPublicFacing": true,
- "coamsId": 93054,
- "isTypeAuthorization": true,
- "ditprId": "30498",
- "apmsId": "30498",
- "vasiId": "30498",
- "authorizationStatus": "Not Yet Authorized",
- "authorizationDate": 1638741660,
- "authorizationTerminationDate": 1638741660,
- "authorizationLength": 365,
- "securityControlsAssessorExecutiveSummary": "Executive Summary of the system's Security Controls Assessor",
- "riskReviewExecutiveSummary": "Executive Summary of the system's Risk Review",
- "termsForAuth": "Terms/Conditions to maintain a valid ATO",
- "securityPlanApprovalStatus": "Approved",
- "securityPlanApprovalDate": 1638741660,
- "missionCriticality": "Mission Support (MS)",
- "geographicalAssociation": "VA Operated IS",
- "systemOwnershipControlled": "Region 1",
- "governingMissionArea": "DoD portion of the Intelligence MA (DIMA)",
- "primaryFunctionalArea": "Health/Medical",
- "secondaryFunctionalArea": "Logistics",
- "primaryControlSet": "NIST SP 800-53 Revision 4",
- "confidentiality": "Low",
- "integrity": "Moderate",
- "availability": "High",
- "appliedOverlays": "Classified Information; Privacy",
- "appliedStigs": "Active_Directory_Domain",
- "rmfActivity": "Maintain ATO and conduct reviews",
- "crossDomainTicket": "Cross Domain Ticket test",
- "ditprDonId": "5910, 1234, 8765",
- "mac": "II",
- "dodConfidentiality": "Public",
- "contingencyPlanRequired": true,
- "contingencyPlanArtifact": "ContingencyPlanTest.pdf",
- "contingencyPlanTested": true,
- "contingencyPlanTestDate": 1426957321,
- "securityReviewRequired": true,
- "securityReviewCompleted": true,
- "securityReviewCompletionDate": 1531958400,
- "nextSecurityReviewDueDate": 1526957321,
- "hasOpenPoamItem": true,
- "hasOpenPoamItem90to120PastScheduledCompletionDate": false,
- "hasOpenPoamItem120PlusPastScheudledCompletionDate": false,
- "impact": "Low",
- "hasCUI": false,
- "hasPII": false,
- "hasPHI": false,
- "ppsmRegistrationRequired": "PPSM registration required",
- "ppsmRegistryNumber": "Test PPSM Registry Number",
- "ppsmRegistrationExemptionJustification": "Exemption justification",
- "interconnectedInformationSystemAndIdentifiers": "Test",
- "privacyImpactAssessmentRequired": true,
- "privacyImpactAssessmentStatus": "Not Started",
- "privacyImpactAssessmentDate": 1622048629,
- "privacyImpactAssessmentArtifact": "PIATest.pdf",
- "userDefinedField1": "Test User-defined Field 1",
- "userDefinedField2": "Test User-defined Field 2",
- "userDefinedField3": "Test User-defined Field 3",
- "userDefinedField4": "Test User-defined Field 4",
- "userDefinedField5": "Test User-defined Field 5",
- "currentRmfLifecycleStep": "4 - Assess",
- "otherInformation": "Additional Comments",
- "reportsForScorecard": true,
- "highestSystemDataClassification": "Unclassified",
- "overallClassification": "Unclassified",
- "isHVA": true,
- "isFinancialManagement": true,
- "isReciprocity": true,
- "reciprocityExemption": "Decommission",
- "cloudComputing": false,
- "cloudType": "Public",
- "authorizationToConnectStatus": "Decommissioned",
- "isSaaS": true,
- "isPaaS": false,
- "isIaaS": true,
- "otherServiceModels": "Test Other Service",
- "needDate": 1638741660,
- "overallRiskScore": "Moderate",
- "isHRR": false,
- "connectivityAuthorizationDate": 1638741660,
- "connectivityAuthorizationTerminationDate": 1638741660,
- "systemDevelopmentLifeCycle": "Test Other Service",
- "isFISMAReportable": false,
- "groupTagging": "Group Tag 1",
- "groupTagDescriptions": "Group Tag 1 explanation",
- "dadmsId": "DADMS-1",
- "dadmsExpirationDate": 1638751730,
- "enclaveConnectivity": "NIPR",
- "environmentType": "Cloud Computing",
- "navyCommonControlProvider": false,
- "navyCloudBroker": "AWS IL 5",
- "cloudBrokerEmassId": 2349,
- "cloudBrokerProvisionalAuthorizationAtd": 1638741660,
- "navyJointAuthorization": false,
- "nmciNgenClins": "NMCI CLIN",
- "enterpriseLocations": "All Navy Networks",
- "whitelistId": "DoD DMZ Whitelist",
- "whitelistInventory": "Whitelist document",
- "acquisitionCategory": "I",
- "softwareCategory": "Government Off-The-Shelf Software (GOTS)",
- "cybersecurityServiceProvider": "NIPR",
- "cybersecurityServiceProviderExceptionJustification": "Exception justification",
- "maximumTolerableDowntime": "Immediate",
- "recoveryTimeObjective": "Mission Critical: 12 hours",
- "recoveryPointObjective": "Mission Critical: 12 hours",
- "businessImpactAnalysisRequired": true,
- "businessImpactAnalysisArtifact": "BIATest.pdf",
- "incidentResponsePlanRequired": true,
- "incidentResponsePlanArtifact": "IRPlanTest.pdf",
- "disasterRecoveryPlanRequired": true,
- "disasterRecoveryPlanArtifact": "DRPlanTest.pdf",
- "privacyThresholdAnalysisCompleted": true,
- "privacyThresholdAnalysisDate": 1715312304,
- "privacyThresholdAnalysisArtifact": "PTATest.pdf",
- "privacyActSystemOfRecordsNoticeRequired": true,
- "eAuthenticationRiskAssessmentRequired": true,
- "eAuthenticationRiskAssessmentDate": 1715312304,
- "eAuthenticationRiskAssessmentArtifact": "EAuthRisk.pdf",
- "ipv4OnlyAssets": 10,
- "ipv6OnlyAssets": 5,
- "ipv4Ipv6DualStackAssets": 15,
- "totalIpAssets": 30,
- "originatingOrganization": "Originating Organization",
- "systemUseJustification": "System EOL within 120 days",
- "systemUseJustificationArtifact": "SystemUseJustification.pdf\"",
- "authorizationToUseStatus": "Authority to Use (ATU)",
- "reciprocityAcceptanceStatus": "Acceptance status content",
- "useAuthorizationDate": 1715312304,
- "reciprocityAcceptanceDate": 1715312304,
- "useAuthorizationTerminationDate": 1715312304,
- "reciprocityAcceptanceTerminationDate": 1715312304,
- "termsConditionsForUseSummary": "Test ATU Summary",
- "termsConditionsForReciprocitySummary": "Test ATU Summary",
- "primaryMissionEssentialFunction": false,
- "pmefDescription": "Test PMEF Description",
- "missionEssentialFunction": false,
- "mefDescription": "Test MEF Description",
- "administration": "Test Administration",
- "administrationOtherJustification": "Test Administration Justification",
- "atcIatcGrantedDate": 1715312304,
- "atcIatcExpirationDate": 1715312304,
- "atcIatcPendingItems": "Test ATC/IATC Pending Items",
- "pendingItemsDueDate": 1715312304,
- "dodinnSystemId": false,
- "authorizationToUseConnectStatus": "Authorization",
- "useConnectAuthorizationDate": 1715312304,
- "useConnectAuthorizationTerminationDate": 1715312304,
- "termsConditionsForUseConnectSummary": "Test ATU Summary",
- "workstations": 10,
- "servers": 5,
- "connectivityCcsd": [
- {
- "ccsdNumber": "CCSD-579",
- "connectivity": "Not Yet Authorized"
}
]
}
]
}
Returns the system matching provided parameters
systemId required | integer Example: 35 System Id: The unique system record identifier. |
policy | string Default: "rmf" Enum: "diacap" "rmf" "reporting" System Policy: Filter query by system policy. If no value is specified, the default returns RMF policy information for dual-policy systems. |
{- "meta": {
- "code": 200
}, - "data": {
- "registrationCompletionDate": 1638741770,
- "systemLifeCycleAcquisitionPhase": "Pre-Milestone A",
- "specialType": "Special Type 1",
- "specialTypeDescription": "Test Special Type Description",
- "missionPortfolio": "Not Applicable",
- "isNNPI": false,
- "isRBC": false,
- "isWaiver": true,
- "programOffice": "Test Program Office",
- "vramId": "12345",
- "systemId": 33,
- "policy": "RMF",
- "registrationType": "Assess and Authorize",
- "name": "System XYZ",
- "acronym": "PM-6",
- "description": "This is a test system for the eMASS API documentation",
- "instance": "Navy",
- "owningOrganization": "Defense Information Systems Agency",
- "secondaryOrganization": "ID31",
- "versionReleaseNo": "V1",
- "systemType": "IS Major Application",
- "isNSS": true,
- "isPublicFacing": true,
- "coamsId": 93054,
- "isTypeAuthorization": true,
- "ditprId": "30498",
- "apmsId": "30498",
- "vasiId": "30498",
- "authorizationStatus": "Not Yet Authorized",
- "authorizationDate": 1638741660,
- "authorizationTerminationDate": 1638741660,
- "authorizationLength": 365,
- "securityControlsAssessorExecutiveSummary": "Executive Summary of the system's Security Controls Assessor",
- "riskReviewExecutiveSummary": "Executive Summary of the system's Risk Review",
- "termsForAuth": "Terms/Conditions to maintain a valid ATO",
- "securityPlanApprovalStatus": "Approved",
- "securityPlanApprovalDate": 1638741660,
- "missionCriticality": "Mission Support (MS)",
- "geographicalAssociation": "VA Operated IS",
- "systemOwnershipControlled": "Region 1",
- "governingMissionArea": "DoD portion of the Intelligence MA (DIMA)",
- "primaryFunctionalArea": "Health/Medical",
- "secondaryFunctionalArea": "Logistics",
- "primaryControlSet": "NIST SP 800-53 Revision 4",
- "confidentiality": "Low",
- "integrity": "Moderate",
- "availability": "High",
- "appliedOverlays": "Classified Information; Privacy",
- "appliedStigs": "Active_Directory_Domain",
- "rmfActivity": "Maintain ATO and conduct reviews",
- "crossDomainTicket": "Cross Domain Ticket test",
- "ditprDonId": "5910, 1234, 8765",
- "mac": "II",
- "dodConfidentiality": "Public",
- "contingencyPlanRequired": true,
- "contingencyPlanArtifact": "ContingencyPlanTest.pdf",
- "contingencyPlanTested": true,
- "contingencyPlanTestDate": 1426957321,
- "securityReviewRequired": true,
- "securityReviewCompleted": true,
- "securityReviewCompletionDate": 1531958400,
- "nextSecurityReviewDueDate": 1526957321,
- "hasOpenPoamItem": true,
- "hasOpenPoamItem90to120PastScheduledCompletionDate": false,
- "hasOpenPoamItem120PlusPastScheudledCompletionDate": false,
- "impact": "Low",
- "hasCUI": false,
- "hasPII": false,
- "hasPHI": false,
- "ppsmRegistrationRequired": "PPSM registration required",
- "ppsmRegistryNumber": "Test PPSM Registry Number",
- "ppsmRegistrationExemptionJustification": "Exemption justification",
- "interconnectedInformationSystemAndIdentifiers": "Test",
- "privacyImpactAssessmentRequired": true,
- "privacyImpactAssessmentStatus": "Not Started",
- "privacyImpactAssessmentDate": 1622048629,
- "privacyImpactAssessmentArtifact": "PIATest.pdf",
- "userDefinedField1": "Test User-defined Field 1",
- "userDefinedField2": "Test User-defined Field 2",
- "userDefinedField3": "Test User-defined Field 3",
- "userDefinedField4": "Test User-defined Field 4",
- "userDefinedField5": "Test User-defined Field 5",
- "currentRmfLifecycleStep": "4 - Assess",
- "otherInformation": "Additional Comments",
- "reportsForScorecard": true,
- "highestSystemDataClassification": "Unclassified",
- "overallClassification": "Unclassified",
- "isHVA": true,
- "isFinancialManagement": true,
- "isReciprocity": true,
- "reciprocityExemption": "Decommission",
- "cloudComputing": false,
- "cloudType": "Public",
- "authorizationToConnectStatus": "Decommissioned",
- "isSaaS": true,
- "isPaaS": false,
- "isIaaS": true,
- "otherServiceModels": "Test Other Service",
- "needDate": 1638741660,
- "overallRiskScore": "Moderate",
- "isHRR": false,
- "connectivityAuthorizationDate": 1638741660,
- "connectivityAuthorizationTerminationDate": 1638741660,
- "systemDevelopmentLifeCycle": "Test Other Service",
- "isFISMAReportable": false,
- "groupTagging": "Group Tag 1",
- "groupTagDescriptions": "Group Tag 1 explanation",
- "dadmsId": "DADMS-1",
- "dadmsExpirationDate": 1638751730,
- "enclaveConnectivity": "NIPR",
- "environmentType": "Cloud Computing",
- "navyCommonControlProvider": false,
- "navyCloudBroker": "AWS IL 5",
- "cloudBrokerEmassId": 2349,
- "cloudBrokerProvisionalAuthorizationAtd": 1638741660,
- "navyJointAuthorization": false,
- "nmciNgenClins": "NMCI CLIN",
- "enterpriseLocations": "All Navy Networks",
- "whitelistId": "DoD DMZ Whitelist",
- "whitelistInventory": "Whitelist document",
- "acquisitionCategory": "I",
- "softwareCategory": "Government Off-The-Shelf Software (GOTS)",
- "cybersecurityServiceProvider": "NIPR",
- "cybersecurityServiceProviderExceptionJustification": "Exception justification",
- "maximumTolerableDowntime": "Immediate",
- "recoveryTimeObjective": "Mission Critical: 12 hours",
- "recoveryPointObjective": "Mission Critical: 12 hours",
- "businessImpactAnalysisRequired": true,
- "businessImpactAnalysisArtifact": "BIATest.pdf",
- "incidentResponsePlanRequired": true,
- "incidentResponsePlanArtifact": "IRPlanTest.pdf",
- "disasterRecoveryPlanRequired": true,
- "disasterRecoveryPlanArtifact": "DRPlanTest.pdf",
- "privacyThresholdAnalysisCompleted": true,
- "privacyThresholdAnalysisDate": 1715312304,
- "privacyThresholdAnalysisArtifact": "PTATest.pdf",
- "privacyActSystemOfRecordsNoticeRequired": true,
- "eAuthenticationRiskAssessmentRequired": true,
- "eAuthenticationRiskAssessmentDate": 1715312304,
- "eAuthenticationRiskAssessmentArtifact": "EAuthRisk.pdf",
- "ipv4OnlyAssets": 10,
- "ipv6OnlyAssets": 5,
- "ipv4Ipv6DualStackAssets": 15,
- "totalIpAssets": 30,
- "originatingOrganization": "Originating Organization",
- "systemUseJustification": "System EOL within 120 days",
- "systemUseJustificationArtifact": "SystemUseJustification.pdf\"",
- "authorizationToUseStatus": "Authority to Use (ATU)",
- "reciprocityAcceptanceStatus": "Acceptance status content",
- "useAuthorizationDate": 1715312304,
- "reciprocityAcceptanceDate": 1715312304,
- "useAuthorizationTerminationDate": 1715312304,
- "reciprocityAcceptanceTerminationDate": 1715312304,
- "termsConditionsForUseSummary": "Test ATU Summary",
- "termsConditionsForReciprocitySummary": "Test ATU Summary",
- "primaryMissionEssentialFunction": false,
- "pmefDescription": "Test PMEF Description",
- "missionEssentialFunction": false,
- "mefDescription": "Test MEF Description",
- "administration": "Test Administration",
- "administrationOtherJustification": "Test Administration Justification",
- "atcIatcGrantedDate": 1715312304,
- "atcIatcExpirationDate": 1715312304,
- "atcIatcPendingItems": "Test ATC/IATC Pending Items",
- "pendingItemsDueDate": 1715312304,
- "dodinnSystemId": false,
- "authorizationToUseConnectStatus": "Authorization",
- "useConnectAuthorizationDate": 1715312304,
- "useConnectAuthorizationTerminationDate": 1715312304,
- "termsConditionsForUseConnectSummary": "Test ATU Summary",
- "workstations": 10,
- "servers": 5,
- "connectivityCcsd": [
- {
- "ccsdNumber": "CCSD-579",
- "connectivity": "Not Yet Authorized"
}
]
}
}
The System Roles endpoints provides the ability to access user data assigned to systems.
NOTES:
Returns the role(s) data matching parameters.
roleCategory required | string Default: "PAC" Enum: "CAC" "PAC" "Other" Role Category: The system role category been queried |
role required | string Default: "IAO" Role: Accepts single value from options available at base system-roles endpoint e.g., SCA. |
policy | string Default: "rmf" Enum: "diacap" "rmf" "reporting" System Policy: Filter query by system policy. If no value is specified, the default returns RMF policy information for dual-policy systems. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "systemName": "eMASS API Example System",
- "systemAcronym": "S-XYZ",
- "roles": [
- {
- "roleCategory": "PAC",
- "role": "AO",
- "users": [
- {
- "firstName": "John",
- "lastName": "Smith",
- "email": "John.Smith@hb.com"
}
]
}
]
}
]
}
The Controls endpoints provide the ability to view, add, and update Security Control information to a system for both the Implementation Plan and Risk Assessment.
Returns system control information for matching systemId
path parameter
systemId required | integer Example: 35 System Id: The unique system record identifier. |
acronyms | string Default: "PM-6" Acronym: The system acronym(s) being queried (single value or comma delimited values). |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 83,
- "acronym": "AC-3",
- "responsibleEntities": "Unknown",
- "controlDesignation": "Common",
- "estimatedCompletionDate": 1799644800,
- "implementationNarrative": "Test Imp. Narrative",
- "commonControlProvider": "DoD",
- "naJustification": "System EOL within 120 days",
- "slcmCriticality": "Test Criticality",
- "slcmFrequency": "Annually",
- "slcmMethod": "Automated",
- "slcmReporting": "Test Reporting",
- "slcmTracking": "Test Tracking",
- "slcmComments": "Test SLCM Comments",
- "implementationStatus": "Planned",
- "severity": "Low",
- "vulnerabiltySummary": "Test Vulnerability Summary",
- "recommendations": "Test Recommendations",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "testMethod": "Test",
- "mitigations": "Test Mitigations",
- "applicationLayer": "Cloud Computing",
- "databaseLayer": "Time Sharing Computing",
- "operatingSystemLayer": "Client Server Computing",
- "name": "System XYZ",
- "ccis": "000001,000002",
- "isInherited": true,
- "modifiedByOverlays": "Requirements",
- "includedStatus": "Manually",
- "complianceStatus": "Status"
}
]
}
Update a Control for given systemId
Request Body Required Fields
acronym
responsibleEntities
controlDesignation
estimatedCompletionDate
implementationNarrative
The following optional fields (plus the Request Body Required Fields) are required based on the Implementation Status (implementationStatus
) field value:
Status | Required Fields |
---|---|
Planned or Implemented | slcmCriticality, slcmFrequency, slcmMethod, slcmReporting, slcmTracking, slcmComments |
Not Applicable | naJustification |
Manually Inherited | commonControlProvider, slcmCriticality, slcmFrequency, slcmMethod, slcmReporting, slcmTracking, slcmComments |
NOTES:
Inherited
.naJustification
,responsibleEntities
,implementationNarrative
,slcmCriticality
slcmFrequency
,slcmMethod
,slcmReporting
,slcmTracking
,slcmComments
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for updating an existing control for a given system.
acronym | string [Required] Acronym of the system record. |
responsibleEntities | string [Required] Include written description of Responsible Entities that are responsible for the Security Control. Character Limit 2,000. |
controlDesignation | string Enum: "Common" "System-Specific" "Hybrid" [Required] Control designations |
estimatedCompletionDate | integer <int64> [Required] Field is required for Implementation Plan. Unix time format. |
implementationNarrative | string [Required] Includes security control comments. Character Limit 2,000. |
commonControlProvider | string or null Enum: "DoD" "Component" "Enclave" [Conditional] Indicate the type of Common Control Provider for an Inherited Security Control. |
naJustification | string or null [Conditional] Provide justification for Security Controls deemed Not Applicable to the system. |
slcmCriticality | string or null [Conditional] Criticality of Security Control regarding SLCM. Character Limit = 2,000. |
slcmFrequency | string or null Enum: "Constantly" "Daily" "Weekly" "Monthly" "Quarterly" "Semi-Annually" "Annually" "Every Two Years" "Every Three Years" "Undetermined" [Conditional] SLCM frequency |
slcmMethod | string or null Enum: "Automated" "Semi-Automated" "Manual" "Undetermined" [Conditional] SLCM method utilized |
slcmReporting | string or null [Conditional] Method for reporting Security Control for SLCM. Character Limit = 2,000. |
slcmTracking | string or null [Conditional] How Non-Compliant Security Controls will be tracked for SLCM. Character Limit = 2,000. |
slcmComments | string or null [Conditional] Additional comments for Security Control regarding SLCM. Character Limit = 4,000. |
implementationStatus | string or null Enum: "Planned" "Implemented" "Inherited" "Not Applicable" "Manually Inherited" [Optional] Implementation Status of the Security Control for the information system. |
severity | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
vulnerabiltySummary | string or null [Optional] Include vulnerability summary. Character Limit = 2,000. |
recommendations | string or null [Optional] Include recommendations. Character Limit = 2,000. |
relevanceOfThreat | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
likelihood | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impact | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impactDescription | string or null [Optional] Include description of Security Control's impact. |
residualRiskLevel | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
testMethod | string or null Enum: "Test" "Interview" "Examine" "Test, Interview" "Test, Examine" "Interview, Examine" "Test, Interview, Examine" [Optional] Identifies the assessment method / combination that will determine if the security requirements are implemented correctly. |
mitigations | string or null [Optional] Identify any mitigations in place for the Non-Compliant Security Control's vulnerabilities. Character Limit = 2,000. |
applicationLayer | string or null [Optional] If the Financial Management (Navy) overlay is applied to the system, this field appears and can be populated. Character Limit = 2,000. Navy only. |
databaseLayer | string or null [Optional] If the Financial Management (Navy) overlay is applied to the system, this field appears and can be populated. Navy only. |
operatingSystemLayer | string or null [Optional] If the Financial Management (Navy) overlay is applied to the system, this field appears and can be populated. Navy only. |
name | string or null [Read-only] Name of the system record. |
ccis | string or null [Read-only] Comma separated list of CCIs associated with the control. |
isInherited | boolean or null [Read-only] Indicates whether a control is inherited. |
modifiedByOverlays | string or null [Read-only] List of overlays that affect the control. |
includedStatus | string or null [Read-only] Indicates the manner by which a control was included in the system's categorization. |
complianceStatus | string or null [Read-only] Compliance of the control. |
[- {
- "acronym": "AC-3",
- "responsibleEntities": "Unknown",
- "controlDesignation": "Common",
- "estimatedCompletionDate": 1799644800,
- "implementationNarrative": "Test Imp. Narrative",
- "commonControlProvider": "DoD",
- "naJustification": "System EOL within 120 days",
- "slcmCriticality": "Test Criticality",
- "slcmFrequency": "Annually",
- "slcmMethod": "Automated",
- "slcmReporting": "Test Reporting",
- "slcmTracking": "Test Tracking",
- "slcmComments": "Test SLCM Comments",
- "implementationStatus": "Planned",
- "severity": "Low",
- "vulnerabiltySummary": "Test Vulnerability Summary",
- "recommendations": "Test Recommendations",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "testMethod": "Test",
- "mitigations": "Test Mitigations",
- "applicationLayer": "Cloud Computing",
- "databaseLayer": "Time Sharing Computing",
- "operatingSystemLayer": "Client Server Computing",
- "name": "System XYZ",
- "ccis": "000001,000002",
- "isInherited": true,
- "modifiedByOverlays": "Requirements",
- "includedStatus": "Manually",
- "complianceStatus": "Status"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "acronym": "AC-34",
- "success": true,
- "systemId": 33,
- "errors": [
- "key:value"
]
}
]
}
The Test Results endpoints provide the ability to view and add test results for a system's Assessment Procedures which determine Security Control compliance.
Returns system test results information for matching parameters.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
controlAcronyms | string Control Acronym: Filter query by given system acronym (single value or comma separated). |
assessmentProcedures | string Assessment Procedure: Filter query by given Security Control Assessment Procedure (single value or comma separated). |
ccis | string CCI System: Filter query by Control Correlation Identifiers (CCIs) (single value or comma separated). |
latestOnly | boolean Default: true Latest Results Only: Indicates that only the latest test resultes are retrieved. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "control": "AC-3",
- "cci": "000002",
- "assessmentProcedure": "AC-1.1",
- "isInherited": true,
- "testedBy": "Smith, Joe",
- "testDate": 1638741770,
- "description": "Test result description",
- "type": "Self-Assessment",
- "complianceStatus": "Compliant"
}
]
}
Adds test results for given systemId
Request Body Required Fields
testedBy
testDate
description
complianceStatus
assessmentProcedure
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body to add test results to a system (systemId)
testedBy | string [Required] Last Name, First Name. 100 Characters. |
testDate | integer <int64> [Required] Unix time format. |
description | string [Required] Include description of test result. 4000 Characters. |
complianceStatus | string [Required] Test result compliance status |
assessmentProcedure | string [Required] The Security Control Assessment Procedure being assessed. |
[- {
- "testedBy": "Smith, Joe",
- "testDate": 1638741660,
- "description": "Test result description",
- "complianceStatus": "Compliant",
- "assessmentProcedure": "AC-1.1"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "cci": "000001,000002",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The POA&Ms endpoints provide the ability to view, add, update, and remove Plan of Action and Milestones (POA&M) items and associated milestones for a system.
Returns system(s) containing POA&M items for matching parameters.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
scheduledCompletionDateStart | string Date Started: Filter query by the scheduled completion start date (Unix date format). |
scheduledCompletionDateEnd | string Date Ended: Filter query by the scheduled completion start date (Unix date format). |
controlAcronyms | string Control Acronym: Filter query by given system acronym (single value or comma separated). |
assessmentProcedures | string Assessment Procedure: Filter query by given Security Control Assessment Procedure (single value or comma separated). |
ccis | string CCI System: Filter query by Control Correlation Identifiers (CCIs) (single value or comma separated). |
systemOnly | boolean Default: true Systems Only: Indicates that only system(s) information is retrieved. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 830,
- "poamId": 45,
- "displayPoamId": 100000010,
- "status": "Completed",
- "vulnerabilityDescription": "Description text",
- "sourceIdentifyingVulnerability": "Source Indentifying Vulnerability text",
- "pocOrganization": "Army",
- "resources": "Resource text",
- "identifiedInCFOAuditOrOtherReview": true,
- "pocFirstName": "John",
- "pocLastName": "Smith",
- "pocEmail": "smith@ah.com",
- "pocPhoneNumber": "555-555-5555",
- "severity": "Low",
- "scheduledCompletionDate": 1799644800,
- "completionDate": 1745916276,
- "comments": "Comments text.",
- "personnelResourcesFundedBaseHours": 100,
- "personnelResourcesCostCode": 123456,
- "personnelResourcesUnfundedBaseHours": 100,
- "personnelResourcesNonfundingObstacle": "Not an system of interest",
- "personnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "nonPersonnelResourcesFundedAmount": 0,
- "nonPersonnelResourcesCostCode": "string",
- "nonPersonnelResourcesUnfundedAmount": 0,
- "nonPersonnelResourcesNonfundingObstacle": "Not an system of interest",
- "nonPersonnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "milestones": [
- {
- "systemId": 830,
- "milestoneId": 19,
- "poamId": 45,
- "description": "Description text",
- "scheduledCompletionDate": 1715312304,
- "reviewStatus": "Under Review",
- "createdBy": "Smith, John",
- "createdDate": 1715312304
}
], - "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "controlAcronym": "AC-3",
- "assessmentProcedure": "AC-1.4",
- "securityChecks": "SV-25123r1_rule,2016-A-0279",
- "rawSeverity": "Moderate",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "recommendations": "Recommendations text",
- "mitigations": "Mitigation text",
- "resultingResidualRiskLevelAfterProposedMitigations": "Low",
- "predisposingConditions": "The predisposing condition justification",
- "threatDescription": "The identified threat(s) description",
- "devicesAffected": "system",
- "conditionId": "TC-10100292",
- "isInherited": true,
- "cci": "000001,000002",
- "reviewStatus": "Under Review",
- "createdDate": 1715312304,
- "extensionDate": 1715312304,
- "pendingExtensionDate": 1715312304,
- "artifacts": "Test1.docx; Test2.xlsx"
}
]
}
Add a POA&M for given systemId
Request Body Required Fields
Field | Require/Condition |
---|---|
status | Always (every POST) |
vulnerabilityDescription | Always (every POST) |
sourceIdentifyingVulnerability | Always (every POST) |
pocOrganization | Always (every POST) |
resources | Always (every POST) |
identifiedInCFOAuditOrOtherReview | Required for VA. Optional for Army and USCG. |
scheduledCompletionDate | Required for ongoing and completed POA&M items |
pocFirstName | Only if Last Name, Email, or Phone Number have data |
pocLastName | Only if First Name, Email, or Phone Number have data |
pocEmail | Only if First Name, Last Name, or Phone Number have data |
pocPhoneNumber | Only if First Name, Last Name, or Email have data |
completionDate | For completed POA&M Item only |
comments | For completed or Risk Accepted POA&M Items only |
NOTE: Certain eMASS instances also require the Risk Analysis fields to be populated:
severity
relevanceOfThreat
likelihood
impact
residualRiskLevel
mitigations
The following rules apply to the Review Status status
field value:
Value | Rule |
---|---|
Not Approved | POA&M cannot be saved if Milestone Scheduled Completion Date exceeds POA&M Item Scheduled Completion Date |
Approved | POA&M can only be saved if Milestone Scheduled Completion Date exceeds POA&M Item Scheduled Completion Date |
Are required to have a Severity Value assigned | |
Completed or Ongoing | Cannot be saved without Milestones |
Risk Accepted | POA&M Item cannot be saved with a Scheduled Completion Date scheduledCompletionDate or have Milestones |
Approved or Completed or Ongoing | Cannot update Scheduled Completion Date |
Additional Rules
completionDate
) is in the future.Fields Characters Limitation
pocOrganization
pocFirstName
, pocLastName
, pocEmail
, pocPhoneNumber
resource
) field exceeds 250 charactersmitigations
, sourceIdentifyingVulnerability
, comments
description
description
) exceeds 2,000 characters.systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body to add POA&M(s) to a system (systemId)
status | string Enum: "Ongoing" "Risk Accepted" "Completed" "Not Applicable" "Archived" [Required] The POA&M status |
vulnerabilityDescription | string [Required] Provide a description of the POA&M Item. 2000 Characters. |
sourceIdentifyingVulnerability | string [Required] Include Source Identifying Vulnerability text. 2000 Characters. |
pocOrganization | string [Required] Organization/Office represented. 100 Characters. |
resources | string [Required] List of resources used. 250 Characters. |
identifiedInCFOAuditOrOtherReview | boolean [Required] If not specified, this field will be set to false because it does not accept a null value. VA only |
pocFirstName | string [Conditional] First name of POC. 100 Characters. |
pocLastName | string [Conditional] Last name of POC. 100 Characters. |
pocEmail | string [Conditional] Email address of POC. 100 Characters. |
pocPhoneNumber | string [Conditional] Phone number of POC (area code) -* format. 100 Characters. |
severity | string [Conditional] Required for approved items. Values include the following options: (Very Low, Low, Moderate,High,Very High) |
scheduledCompletionDate | integer or null <int64> [Conditional] Required for ongoing and completed POA&M items. Unix time format. |
completionDate | integer <int64> [Conditional] Field is required for completed POA&M items. Unix time format. |
comments | string [Conditional] Field is required for completed and risk accepted POA&M items. 2000 Characters |
personnelResourcesFundedBaseHours | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
personnelResourcesCostCode | string or null [Conditional] Required if Personnel Resources: Funded Base Hours is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
personnelResourcesUnfundedBaseHours | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
personnelResourcesNonfundingObstacle | string or null [Conditional] Required if Personnel Resources: Unfunded Base Hours is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
personnelResourcesNonfundingObstacleOtherReason | string or null [Conditional] Required if the value "Other" is populated for the field Personnel Resources: Non-Funding Obstacle. VA only. |
nonPersonnelResourcesFundedAmount | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
nonPersonnelResourcesCostCode | string or null [Conditional] Required if Non-Personnel Resources: Funded Amount is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
nonPersonnelResourcesUnfundedAmount | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
nonPersonnelResourcesNonfundingObstacle | string or null [Conditional] Required if Non-Personnel Resources: Unfunded Amount is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
nonPersonnelResourcesNonfundingObstacleOtherReason | string or null [Conditional] Required if the value "Other" is populated for the field Non-Personnel Resources: Non-Funding Obstacle. VA only. |
externalUid | string [Optional] Unique identifier external to the eMASS application for use with associating POA&Ms. 100 Characters. |
controlAcronym | string [Optional] Control acronym associated with the POA&M Item. NIST SP 800-53 Revision 4 defined. |
assessmentProcedure | string [Optional] The Security Control Assessment Procedure being associated with the POA&M Item. |
securityChecks | string [Optional] Security Checks that are associated with the POA&M. |
rawSeverity | string [Optional] Scan vulnerability ratting Values include the following options: (Very Low, Low, Moderate,High,Very High) |
relevanceOfThreat | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
likelihood | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impact | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impactDescription | string [Optional] Include description of Security Control's impact. |
residualRiskLevel | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
recommendations | string [Optional] Include recommendations. Character Limit = 2,000. |
mitigations | string [Optional] Include mitigation explanation. 2000 Characters. |
resultingResidualRiskLevelAfterProposedMitigations | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Indicate the risk level expected after any proposed mitigations are implemented. Proposed mitigations should be appropriately documented as POA&M milestones. Navy only. |
predisposingConditions | string or null [Optional] A predisposing condition is a condition existing within an organization, a mission or business process, enterprise architecture, information system/PIT, or environment of operation, which affects (i.e., increases or decreases) the likelihood that threat events, once initiated, result in adverse impacts. Navy only. |
threatDescription | string or null [Optional] Describe the identified threat(s) and relevance to the information system. Navy only. |
devicesAffected | string or null [Optional] List any affected devices by hostname. If all devices in the information system are affected, state 'system' or 'all'. Navy only |
Array of objects |
[- {
- "status": "Completed",
- "vulnerabilityDescription": "Description text",
- "sourceIdentifyingVulnerability": "Source Indentifying Vulnerability text",
- "pocOrganization": "Army",
- "resources": "Resource text",
- "identifiedInCFOAuditOrOtherReview": true,
- "pocFirstName": "John",
- "pocLastName": "Smith",
- "pocEmail": "smith@ah.com",
- "pocPhoneNumber": "555-555-5555",
- "severity": "Low",
- "scheduledCompletionDate": 1799644800,
- "completionDate": 1745916276,
- "comments": "Comments text.",
- "personnelResourcesFundedBaseHours": 100,
- "personnelResourcesCostCode": 123456,
- "personnelResourcesUnfundedBaseHours": 100,
- "personnelResourcesNonfundingObstacle": "Not an system of interest",
- "personnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "nonPersonnelResourcesFundedAmount": 0,
- "nonPersonnelResourcesCostCode": "string",
- "nonPersonnelResourcesUnfundedAmount": 0,
- "nonPersonnelResourcesNonfundingObstacle": "Not an system of interest",
- "nonPersonnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "controlAcronym": "AC-3",
- "assessmentProcedure": "AC-1.4",
- "securityChecks": "SV-25123r1_rule,2016-A-0279",
- "rawSeverity": "Moderate",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "recommendations": "Recommendations text",
- "mitigations": "Mitigation text",
- "resultingResidualRiskLevelAfterProposedMitigations": "Low",
- "predisposingConditions": "The predisposing condition justification",
- "threatDescription": "The identified threat(s) description",
- "devicesAffected": "system",
- "milestones": [
- {
- "description": "Description text",
- "scheduledCompletionDate": 1599644800
}
]
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 33,
- "poamId": 45,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Update a POA&M for given systemId
Request Body Required Fields
Field | Require/Condition |
---|---|
poamId | Always (every PUT) |
displayPoamId | Always (every PUT) |
status | Always (every PUT) |
vulnerabilityDescription | Always (every PUT) |
sourceIdentifyingVulnerability | Always (every PUT) |
pocOrganization | Always (every PUT) |
resources | Always (every PUT) |
identifiedInCFOAuditOrOtherReview | Required for VA. Optional for Army and USCG. |
scheduledCompletionDate | Required for ongoing and completed POA&M items |
pocFirstName | Only if Last Name, Email, or Phone Number have data |
pocLastName | Only if First Name, Email, or Phone Number have data |
pocEmail | Only if First Name, Last Name, or Phone Number have data |
pocPhoneNumber | Only if First Name, Last Name, or Email have data |
completionDate | For completed POA&M Item only |
comments | For completed or Risk Accepted POA&M Items only |
NOTES:
severity
relevanceOfThreat
likelihood
impact
residualRiskLevel
mitigations
isActive
field for the milestone and set it to equal to false (isActive=false)
.Business Rules: See business rules for the POST endpoint
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for updating a POA&M for a system (systemId)
systemId | integer <int64> [Required] Unique eMASS system identifier. |
poamId | integer <int64> [Required] Unique item identifier |
displayPoamId | integer <int64> [Required] Globally unique identifier for individual POA&M Items, seen on the front-end as ID. |
status | string Enum: "Ongoing" "Risk Accepted" "Completed" "Not Applicable" "Archived" [Required] The POA&M status |
vulnerabilityDescription | string [Required] Provide a description of the POA&M Item. 2000 Characters. |
sourceIdentifyingVulnerability | string [Required] Include Source Identifying Vulnerability text. 2000 Characters. |
pocOrganization | string [Required] Organization/Office represented. 100 Characters. |
resources | string [Required] List of resources used. 250 Characters. |
identifiedInCFOAuditOrOtherReview | boolean [Required] If not specified, this field will be set to false because it does not accept a null value. VA only |
pocFirstName | string [Conditional] First name of POC. 100 Characters. |
pocLastName | string [Conditional] Last name of POC. 100 Characters. |
pocEmail | string [Conditional] Email address of POC. 100 Characters. |
pocPhoneNumber | string [Conditional] Phone number of POC (area code) -* format. 100 Characters. |
severity | string [Conditional] Required for approved items. Values include the following options: (Very Low, Low, Moderate,High,Very High) |
scheduledCompletionDate | integer or null <int64> [Conditional] Required for ongoing and completed POA&M items. Unix time format. |
completionDate | integer <int64> [Conditional] Field is required for completed POA&M items. Unix time format. |
comments | string [Conditional] Field is required for completed and risk accepted POA&M items. 2000 Characters |
personnelResourcesFundedBaseHours | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
personnelResourcesCostCode | string or null [Conditional] Required if Personnel Resources: Funded Base Hours is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
personnelResourcesUnfundedBaseHours | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
personnelResourcesNonfundingObstacle | string or null [Conditional] Required if Personnel Resources: Unfunded Base Hours is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
personnelResourcesNonfundingObstacleOtherReason | string or null [Conditional] Required if the value "Other" is populated for the field Personnel Resources: Non-Funding Obstacle. VA only. |
nonPersonnelResourcesFundedAmount | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
nonPersonnelResourcesCostCode | string or null [Conditional] Required if Non-Personnel Resources: Funded Amount is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
nonPersonnelResourcesUnfundedAmount | number or null <float> [Conditional] At least one of the following is required and must be completed for each POA&M Item: Personnel Resources-> Funded Base Hours Personnel Resources-> Unfunded Base Hours Non-Personnel Resources-> Funded Amount Non-Personnel Resources-> Unfunded Amount Displays numbers to the second decimal point (e.g., 100.00). VA only. |
nonPersonnelResourcesNonfundingObstacle | string or null [Conditional] Required if Non-Personnel Resources: Unfunded Amount is populated. Only accepts values present in the field's lookup table (modifiable by eMASS System Admins). VA only. |
nonPersonnelResourcesNonfundingObstacleOtherReason | string or null [Conditional] Required if the value "Other" is populated for the field Non-Personnel Resources: Non-Funding Obstacle. VA only. |
externalUid | string [Optional] Unique identifier external to the eMASS application for use with associating POA&Ms. 100 Characters. |
controlAcronym | string [Optional] Control acronym associated with the POA&M Item. NIST SP 800-53 Revision 4 defined. |
assessmentProcedure | string [Optional] The Security Control Assessment Procedure being associated with the POA&M Item. |
securityChecks | string [Optional] Security Checks that are associated with the POA&M. |
rawSeverity | string [Optional] Scan vulnerability ratting Values include the following options: (Very Low, Low, Moderate,High,Very High) |
relevanceOfThreat | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
likelihood | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impact | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
impactDescription | string [Optional] Include description of Security Control's impact. |
residualRiskLevel | string [Optional] Values include the following options (Very Low, Low, Moderate,High,Very High) |
recommendations | string [Optional] Include recommendations. Character Limit = 2,000. |
mitigations | string [Optional] Include mitigation explanation. 2000 Characters. |
resultingResidualRiskLevelAfterProposedMitigations | string or null Enum: "Very Low" "Low" "Moderate" "High" "Very High" [Optional] Indicate the risk level expected after any proposed mitigations are implemented. Proposed mitigations should be appropriately documented as POA&M milestones. Navy only. |
predisposingConditions | string or null [Optional] A predisposing condition is a condition existing within an organization, a mission or business process, enterprise architecture, information system/PIT, or environment of operation, which affects (i.e., increases or decreases) the likelihood that threat events, once initiated, result in adverse impacts. Navy only. |
threatDescription | string or null [Optional] Describe the identified threat(s) and relevance to the information system. Navy only. |
devicesAffected | string or null [Optional] List any affected devices by hostname. If all devices in the information system are affected, state 'system' or 'all'. Navy only |
Array of objects |
[- {
- "systemId": 830,
- "poamId": 45,
- "displayPoamId": 100000010,
- "status": "Completed",
- "vulnerabilityDescription": "Description text",
- "sourceIdentifyingVulnerability": "Source Indentifying Vulnerability text",
- "pocOrganization": "Army",
- "resources": "Resource text",
- "identifiedInCFOAuditOrOtherReview": true,
- "pocFirstName": "John",
- "pocLastName": "Smith",
- "pocEmail": "smith@ah.com",
- "pocPhoneNumber": "555-555-5555",
- "severity": "Low",
- "scheduledCompletionDate": 1799644800,
- "completionDate": 1745916276,
- "comments": "Comments text.",
- "personnelResourcesFundedBaseHours": 100,
- "personnelResourcesCostCode": 123456,
- "personnelResourcesUnfundedBaseHours": 100,
- "personnelResourcesNonfundingObstacle": "Not an system of interest",
- "personnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "nonPersonnelResourcesFundedAmount": 0,
- "nonPersonnelResourcesCostCode": "string",
- "nonPersonnelResourcesUnfundedAmount": 0,
- "nonPersonnelResourcesNonfundingObstacle": "Not an system of interest",
- "nonPersonnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "controlAcronym": "AC-3",
- "assessmentProcedure": "AC-1.4",
- "securityChecks": "SV-25123r1_rule,2016-A-0279",
- "rawSeverity": "Moderate",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "recommendations": "Recommendations text",
- "mitigations": "Mitigation text",
- "resultingResidualRiskLevelAfterProposedMitigations": "Low",
- "predisposingConditions": "The predisposing condition justification",
- "threatDescription": "The identified threat(s) description",
- "devicesAffected": "system",
- "milestones": [
- {
- "description": "Description text",
- "scheduledCompletionDate": 1599644800,
- "isActive": true
}
]
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 33,
- "poamId": 45,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Remove the POA&M matching systemId
path parameter and poamId
Request Body
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Delete the given POA&M Id
poamId | integer <int64> [Required] Unique item identifier |
[- {
- "poamId": 45
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 33,
- "poamId": 45,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Returns system(s) containing POA&M items for matching parameters.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
{- "meta": {
- "code": 200
}, - "data": {
- "systemId": 830,
- "poamId": 45,
- "displayPoamId": 100000010,
- "status": "Completed",
- "vulnerabilityDescription": "Description text",
- "sourceIdentifyingVulnerability": "Source Indentifying Vulnerability text",
- "pocOrganization": "Army",
- "resources": "Resource text",
- "identifiedInCFOAuditOrOtherReview": true,
- "conditionId": "TC-10100292",
- "isInherited": true,
- "cci": "000001,000002",
- "reviewStatus": "Under Review",
- "createdDate": 1715312304,
- "extensionDate": 1715312304,
- "pendingExtensionDate": 1715312304,
- "artifacts": "Test1.docx; Test2.xlsx",
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "controlAcronym": "AC-3",
- "assessmentProcedure": "AC-1.4",
- "securityChecks": "SV-25123r1_rule,2016-A-0279",
- "rawSeverity": "Moderate",
- "relevanceOfThreat": "Low",
- "likelihood": "Low",
- "impact": "Low",
- "impactDescription": "Impact text",
- "residualRiskLevel": "Low",
- "recommendations": "Recommendations text",
- "mitigations": "Mitigation text",
- "resultingResidualRiskLevelAfterProposedMitigations": "Low",
- "predisposingConditions": "The predisposing condition justification",
- "threatDescription": "The identified threat(s) description",
- "devicesAffected": "system",
- "pocFirstName": "John",
- "pocLastName": "Smith",
- "pocEmail": "smith@ah.com",
- "pocPhoneNumber": "555-555-5555",
- "severity": "Low",
- "scheduledCompletionDate": 1799644800,
- "completionDate": 1745916276,
- "comments": "Comments text.",
- "personnelResourcesFundedBaseHours": 100,
- "personnelResourcesCostCode": 123456,
- "personnelResourcesUnfundedBaseHours": 100,
- "personnelResourcesNonfundingObstacle": "Not an system of interest",
- "personnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "nonPersonnelResourcesFundedAmount": 0,
- "nonPersonnelResourcesCostCode": "string",
- "nonPersonnelResourcesUnfundedAmount": 0,
- "nonPersonnelResourcesNonfundingObstacle": "Not an system of interest",
- "nonPersonnelResourcesNonfundingObstacleOtherReason": "Not an system of interest",
- "milestones": [
- {
- "systemId": 830,
- "milestoneId": 19,
- "poamId": 45,
- "description": "Description text",
- "scheduledCompletionDate": 1715312304,
- "reviewStatus": "Under Review",
- "createdBy": "Smith, John",
- "createdDate": 1715312304
}
]
}
}
The Milestones endpoints provide the ability to view, add, update, and remove milestones that are associated with Plan of Action and Milestones (POA&M) items for a system.
Returns system containing milestones for matching parameters.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
scheduledCompletionDateStart | string Date Started: Filter query by the scheduled completion start date (Unix date format). |
scheduledCompletionDateEnd | string Date Ended: Filter query by the scheduled completion start date (Unix date format). |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 830,
- "milestoneId": 19,
- "poamId": 45,
- "description": "Description text",
- "scheduledCompletionDate": 1715312304,
- "reviewStatus": "Under Review",
- "createdBy": "Smith, John",
- "createdDate": 1715312304
}
]
}
Adds a milestone for given systemId
and poamId
path parameters
Request Body Required Fields
description
scheduledCompletionDate
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
Example request body for adding milestones to an existing System (systemId) POA&M (poamId)
description | string [Required] Provide a description of the milestone. |
scheduledCompletionDate | integer <int64> [Required] Unix date format. |
[- {
- "description": "Description text",
- "scheduledCompletionDate": 1599644800
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "poamId": 45,
- "milestoneId": 77,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Updates a milestone for given systemId
and poamId
path parameters
Request Body Required Fields
milestoneId
description
scheduledCompletionDate
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
Example request body for updating milestones (milestoneId) of an existing System (systemId) POA&M (poamId)
milestoneId | integer <int64> [Required] Unique milestone identifier. |
description | string [Required] Provide a description of the milestone. |
scheduledCompletionDate | integer <int64> [Required] Unix date format. |
[- {
- "milestoneId": 19,
- "description": "Description text",
- "scheduledCompletionDate": 1599644800
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "poamId": 45,
- "milestoneId": 77,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Remove the POA&M matching systemId
and poamId
for path parameters and milstoneId
provide in the Request Body
NOTE
To delete a milestone the record must be inactive by having the field isActive set to false (isActive=false
).
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
Delete the given Milestone Id
milestoneId | integer <int64> [Required] Unique item identifier |
[- {
- "milestoneId": 19
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "poamId": 45,
- "milestoneId": 77,
- "externalUid": "d6d98b88-c866-4496-9bd4-de7ba48d0f52",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Returns systems containing milestones for matching parameters.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
poamId required | integer Example: 45 POA&M Id: The unique POA&M record identifier. |
milestoneId required | integer Example: 77 Milestone Id: The unique milestone record identifier. |
{- "meta": {
- "code": 200
}, - "data": {
- "systemId": 830,
- "milestoneId": 19,
- "poamId": 45,
- "description": "Description text",
- "scheduledCompletionDate": 1715312304,
- "reviewStatus": "Under Review",
- "createdBy": "Smith, John",
- "createdDate": 1715312304
}
}
The Artifacts endpoints provide the ability to view, add, update, and remove artifacts (supporting documentation/evidence) and associated files for a system.
Returns selected artifacts matching parameters to include the file name containing the artifacts.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
filename | string Example: filename=ArtifactsExporFile.pdf File Name: The file name (to include file-extension). |
controlAcronyms | string Control Acronym: Filter query by given system acronym (single value or comma separated). |
assessmentProcedures | string Assessment Procedure: Filter query by given Security Control Assessment Procedure (single value or comma separated). |
ccis | string CCI System: Filter query by Control Correlation Identifiers (CCIs) (single value or comma separated). |
systemOnly | boolean Default: true Systems Only: Indicates that only system(s) information is retrieved. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "filename": "AutorizationGuidance.pdf",
- "isTemplate": false,
- "type": "Policy",
- "category": "Change Request",
- "isInherited": true,
- "ccis": "000001,000002",
- "mimeContentType": "application/zip",
- "fileSize": "4MB",
- "name": "E-Authentication Assessment",
- "description": "Artifact description text",
- "referencePageNumber": "Reference page number",
- "assessmentProcedures": "AC-1.1",
- "controls": "AC-8,AC-2(4)",
- "expirationDate": 18089586892,
- "lastReviewedDate": 1757409188,
- "signedDate": 1767409188
}
]
}
Information About Adding Artifacts
The body of a request through the Artifacts POST endpoint accepts a single binary file. Two
Artifact POST methods are currently accepted: individual and bulk. Filename uniqueness within
an eMASS system will be enforced by the API for both methods.
For POST requests that should result in a single artifact, the request should include the file.
For POST requests that should result in the creation of many artifacts, the request should include
a single file with the extension ".zip" only and the parameter isBulk should be set to true. This
.zip file should contain one or more files corresponding to existing artifacts or new artifacts that
will be created upon successful receipt.
Upon successful receipt of one or many artifacts, if a file is matched via filename to an artifact
existing within the application, the file associated with the artifact will be updated. If no artifact
is matched via filename to the application, a new artifact will be created with the following
default values. Any values not specified below will be null
To update values other than the file itself, please submit a PUT request.
Business Rules
Artifact cannot be saved if the fields below exceed the following character limits:
Artifact version cannot be saved if an Artifact with the same file name (filename) already exist in the system.
Artifact cannot be saved if the file size exceeds 30MB.
Artifact cannot be saved if the following fields are missing data:
systemId required | integer Example: 35 System Id: The unique system record identifier. |
isBulk | boolean Default: false Is Bulk: If no value is specified, the default is false, and an individual artifact file is expected. When set to true, a .zip file is expected which can contain multiple artifact files. |
See Information
posted above for additional instructions
isTemplate | boolean Enum: true false Is the artifact a template? Indicates whether an artifact is a template |
type | string The type of artifact. Possible values are: Procedure, Diagram, Policy, Labor, Document, Image, Other, Scan Result, Auditor Report. May also accept custom artifact type values set by system administrators. |
category | string The category of artifact. Possible values are: Implementation Guidance, Evidence. May also accept custom artifact category values set by system administrators. |
filename required | string <binary> The file to upload. Must be a .zip file if isBulk is set to true, otherwise any acceptable artifact file. Max 30MB per artifact. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "filename": "AutorizationGuidance.pdf",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
Updates an artifact for given systemId
path parameter
Request Body Required Fields
filename
isTemplate
type
category
The example request provides all optional fields
Information About Updating Artifacts
The PUT request will replace all existing data with the field/value combinations included in the request body.
If any fields are not included, the absent fields will become null.
The fields name
and isTemplate
are non-nullable fields. If not specified in the PUT command
they will default to the following:
name=filename
isTemplate=false
Also, note that one-to-many fields (controls
and ccis
) will also be replaced with the values specified in the PUT.
If existing control or cci
mappings exist in eMASS, the values in the PUT will not append, but
rather replace all existing control and cci mappings with the values in the request body.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
See information
above for additional instructions
filename | string [Required] File name should match exactly one file within the provided zip file. 1000 Characters. or Application/zip file. Max 30MB per artifact. |
isTemplate | boolean or null [Required] Indicates whether an artifact template. |
type | string [Required] Artifact type options |
category | string [Required] Artifact category options |
name | string or null [Optional] Artifact name. Character Limit = 100. |
description | string or null [Optional] Artifact description. 10,000 Characters. |
referencePageNumber | string or null [Optional] Artifact reference page number. 50 Characters. |
assessmentProcedures | string [Optional] The Security Control Assessment Procedure being associated with the artifact. |
controls | string or null [Optional] Control acronym associated with the artifact. NIST SP 800-53 Revision 4 defined. |
expirationDate | integer or null <int64> [Optional] Date Artifact expires and requires review. In Unix Date format. |
lastReviewedDate | integer or null <int64> [Optional] Date Artifact was last reviewed. Unix time format. |
signedDate | integer or null <int64> [Optional] Date artifact was signed. Unix time format. |
[- {
- "filename": "AutorizationGuidance.pdf",
- "isTemplate": false,
- "type": "Policy",
- "category": "Change Request",
- "name": "E-Authentication Assessment",
- "description": "Artifact description text",
- "referencePageNumber": "Reference page number",
- "assessmentProcedures": "AC-1.1",
- "controls": "AC-8,AC-2(4)",
- "expirationDate": 18089586892,
- "lastReviewedDate": 1757409188,
- "signedDate": 1767409188
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "filename": "AutorizationGuidance.pdf",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
Remove the Artifact(s) matching systemId
path parameter and request body artifact(s) file name
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Delete artifact files for the given System Id
filename | string [Required] File name should match exactly one file within the provided zip file. 1000 Characters. |
[- {
- "filename": "AutorizationGuidance.pdf"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "filename": "AutorizationGuidance.pdf",
- "success": true,
- "systemId": 35
}
]
}
The Artifacts Export endpoint provides the ability to download artifact files for a system.
Sample Responce
Binary file associated with given filename.
If compress
parameter is specified, zip archive of binary file associated with given filename.
systemId required | integer Example: 35 System Id: The unique system record identifier. |
filename required | string Example: filename=ArtifactsExporFile.pdf File Name: The file name (to include file-extension). |
compress | boolean Default: true Compress File: Determines if returned file is compressed. |
{- "meta": {
- "code": 400,
- "errorMessage": "Request could not be understood by the server due to incorrect syntax or an unexpected format"
}
}
The Package Approval Chain (PAC) endpoints provide the ability to view the status of existing workflows and initiate new workflows for a system.
NOTES:
Returns the location of a system's package in the Package Approval Chain (PAC)
for matching systemId
path parameter
NOTES:
systemId required | integer Example: 35 System Id: The unique system record identifier. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "workflow": "Assess and Authorize",
- "name": "Package name text",
- "currentStageName": "SCA-R",
- "currentStage": 4,
- "totalStages": 6,
- "daysAtCurrentStage": 2,
- "comments": "PAC initial submition comments"
}
]
}
Adds a Package Approval Chain (PAC) for given systemId
path parameter
Request Body Required Fields
workflow
name
comments
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding system package to PAC for review
workflow | string [Required] The PAC workflow |
name | string [Required] Package name. 100 Characters. |
comments | string [Required] Character Limit = 4,000. |
[- {
- "workflow": "Assess and Authorize",
- "name": "Package name text",
- "comments": "Comments text."
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "workflow": "Assess and Authorize",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Control Approval Chain (CAC) endpoints provide the ability to view the status of Security Controls and submit them to the second stage in the Control Approval Chain.
Note:
Returns the location of a system's package in the Control Approval Chain (CAC) for matching systemId
path parameter
systemId required | integer Example: 35 System Id: The unique system record identifier. |
controlAcronyms | string Control Acronym: Filter query by given system acronym (single value or comma separated). |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 35,
- "controlAcronym": "AC-3",
- "complianceStatus": "Compliant",
- "currentStageName": "SCA-V",
- "currentStage": 2,
- "totalStages": 2,
- "comments": "Control Approval Chain comments text."
}
]
}
Request Body Required Fields
controlAcronym
comments
NOTES:
comments
are not required at the first role of the CAC but are required at the second role of
the CAC. Comments cannot exceed 10,000 characters.systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding control(s) to second role of CAC
controlAcronym | string [Required] System acronym name. |
comments | string [Conditional] Control Approval Chain comments - 2000 Characters. |
[- {
- "controlAcronym": "AC-3",
- "comments": "Control Approval Chain comments text."
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "controlAcronym": "AC-3",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Hardware Baseline endpoints provide the ability to view, add, update, and remove hardware assets for a system.
Returns the hardware baseline for a system matching the systemId
path parameter
systemId required | integer Example: 35 System Id: The unique system record identifier. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 75,
- "hardwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "assetName": "Test Asset Name 11",
- "componentType": "IDS/IPS",
- "nickname": "Hardware",
- "assetIpAddress": "79.102.116.145",
- "publicFacing": true,
- "virtualAsset": false,
- "manufacturer": "Test Manufacturer",
- "modelNumber": 1,
- "serialNumber": "5.2.1.5",
- "OsIosFwVersion": "Win Server 2000",
- "memorySizeType": "32 GB SIM",
- "location": "Test Location",
- "approvalStatus": "In Progress",
- "criticalAsset": false,
- "publicFacingFqdn": "test.com",
- "publicFacingIpAddress": "12.68.239.44",
- "publicFacingUrls": "test.com"
}
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Adds assets to the Hardware Baseline for given systemId
Request Body Required Fields
assetName
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding hardware baseline assets to an existing System (systemId)
assetName | string [Required] Name of the hardware asset. |
publicFacingFqdn | string or null [Conditional] Public facing FQDN. Only applicable if Public Facing is set to true. |
publicFacingIpAddress | string or null [Conditional] Public facing IP address. Only applicable if Public Facing is set to true. |
publicFacingUrls | string or null [Conditional] Public facing URLs. Only applicable if Public Facing is set to true. |
componentType | string or null [Optional] Type of the hardware asset. |
nickname | string or null [Optional] Nickname of the hardware asset. |
assetIpAddress | string or null [Optional] IP address of the hardware asset. |
publicFacing | boolean or null [Optional] Public facing is defined as any asset that is accessible from a commercial connection. |
virtualAsset | boolean or null [Optional] Determine if this is a virtual hardware asset. |
manufacturer | string or null [Optional] Manufacturer of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden. |
modelNumber | string or null [Optional] Model number of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden |
serialNumber | string or null [Optional] Serial number of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden. |
OsIosFwVersion | string or null [Optional] Operating System, IOS, or Firmware version of the hardware asset. |
memorySizeType | string or null [Optional] Memory size / type of the hardware asset. |
location | string or null [Optional] Location of the hardware asset. |
approvalStatus | string or null [Optional] Approval status of the hardware asset. |
criticalAsset | boolean or null [Optional] Indicates whether the asset is a critical information system asset. |
[- {
- "assetName": "Test Asset Name 11",
- "publicFacingFqdn": "test.com",
- "publicFacingIpAddress": "12.68.239.44",
- "publicFacingUrls": "test.com",
- "componentType": "IDS/IPS",
- "nickname": "Hardware",
- "assetIpAddress": "79.102.116.145",
- "publicFacing": true,
- "virtualAsset": false,
- "manufacturer": "Test Manufacturer",
- "modelNumber": 1,
- "serialNumber": "5.2.1.5",
- "OsIosFwVersion": "Win Server 2000",
- "memorySizeType": "32 GB SIM",
- "location": "Test Location",
- "approvalStatus": "In Progress",
- "criticalAsset": false
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 75,
- "hardwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Updates assets in the Hardware Baseline for given systemId
Request Body Required Fields
assetName
hardwareId
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for updating hardware baseline assets to an existing System (systemId)
hardwareId | string or null [Read-Only] GUID identifying the specific hardware asset. Required for a PUT call. |
assetName | string [Required] Name of the hardware asset. |
componentType | string or null [Optional] Type of the hardware asset. |
nickname | string or null [Optional] Nickname of the hardware asset. |
assetIpAddress | string or null [Optional] IP address of the hardware asset. |
publicFacing | boolean or null [Optional] Public facing is defined as any asset that is accessible from a commercial connection. |
virtualAsset | boolean or null [Optional] Determine if this is a virtual hardware asset. |
manufacturer | string or null [Optional] Manufacturer of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden. |
modelNumber | string or null [Optional] Model number of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden |
serialNumber | string or null [Optional] Serial number of the hardware asset. Populated with "Virtual" by default if Virtual Asset is true, however this can be overridden. |
OsIosFwVersion | string or null [Optional] Operating System, IOS, or Firmware version of the hardware asset. |
memorySizeType | string or null [Optional] Memory size / type of the hardware asset. |
location | string or null [Optional] Location of the hardware asset. |
approvalStatus | string or null [Optional] Approval status of the hardware asset. |
criticalAsset | boolean or null [Optional] Indicates whether the asset is a critical information system asset. |
publicFacingFqdn | string or null [Conditional] Public facing FQDN. Only applicable if Public Facing is set to true. |
publicFacingIpAddress | string or null [Conditional] Public facing IP address. Only applicable if Public Facing is set to true. |
publicFacingUrls | string or null [Conditional] Public facing URLs. Only applicable if Public Facing is set to true. |
[- {
- "hardwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "assetName": "Test Asset Name 11",
- "componentType": "IDS/IPS",
- "nickname": "Hardware",
- "assetIpAddress": "79.102.116.145",
- "publicFacing": true,
- "virtualAsset": false,
- "manufacturer": "Test Manufacturer",
- "modelNumber": 1,
- "serialNumber": "5.2.1.5",
- "OsIosFwVersion": "Win Server 2000",
- "memorySizeType": "32 GB SIM",
- "location": "Test Location",
- "approvalStatus": "In Progress",
- "criticalAsset": false,
- "publicFacingFqdn": "test.com",
- "publicFacingIpAddress": "12.68.239.44",
- "publicFacingUrls": "test.com"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 75,
- "hardwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Remove (delete) one or multiple assets from a system Hardware Baseline
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for deleting one or many Hardware Baseline assets
hardwareId | string |
[- {
- "hardwareId": "0da80542-daa0-4170-85ce-551bcaf4be15"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 75,
- "hardwareId": "0da80542-daa0-4170-85ce-551bcaf4be15",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
The Software Baseline endpoints provide the ability to view, add, update, and remove software assets for a system.
Returns the software baseline for a system matching the systemId
path parameter
systemId required | integer Example: 35 System Id: The unique system record identifier. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 85,
- "softwareId": "171fc7d0-6957-4f54-bd51-3b7cbc6c39d5",
- "softwareVendor": "Test Vendor",
- "softwareName": "Test Software Name 11",
- "version": 1,
- "softwareType": "COTS Application",
- "parentSystem": "Test Parent System",
- "subsystem": "Test Subsystem",
- "network": "Test Network",
- "hostingEnvironment": "Test Hosting Environment",
- "softwareDependencies": "Test Dependencies",
- "cryptographicHash": "Test Cryptographic Hash 32\"",
- "inServiceData": "Test In-Service Data",
- "itBudgetUii": "Test IT Budget Uii",
- "fiscalYear": 2021,
- "popEndDate": 1715312304,
- "licenseOrContract": "Test License Or Contract 25",
- "licenseTerm": "Test License Term 25",
- "costPerLicense": 250.25,
- "totalLicenses": 100,
- "totalLicenseCost": 2250.25,
- "licensesUsed": 100,
- "licensePoc": "Smith, Joe",
- "licenseRenewalDate": 1715312304,
- "licenseExpirationDate": 1715312304,
- "approvalStatus": "In Progress",
- "releaseDate": 1715312304,
- "maintenanceDate": 1715312304,
- "retirementDate": 1715312304,
- "endOfLifeSupportDate": 1715312304,
- "extendedEndOfLifeSupportDate": 1715312304,
- "criticalAsset": false,
- "location": "Test Location",
- "purpose": "Test Purpose",
- "unsupportedOperatingSystem": false,
- "unapprovedSoftwareFromTrm": false,
- "approvedWaiver": false
}
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Adds assets to the Software Baseline for given systemId
Request Body Required Fields
softwareVendor
softwareName
version
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding software baseline assets to an existing System (systemId)
softwareVendor | string [Required] Vendor of the software asset. |
softwareName | string [Required] Name of the software asset. |
version | string [Required] Version of the software asset. |
approvalDate | integer or null <int64> [Conditional] Approval date of the software asset. If Approval Status is set to "Unapproved" or "In Progress", Approval Date will be set to null. |
softwareType | string or null [Optional] Type of the software asset. |
parentSystem | string or null [Optional] Parent system of the software asset. |
subsystem | string or null [Optional] Subsystem of the software asset. |
network | string or null [Optional] Network of the software asset. |
hostingEnvironment | string or null [Optional] Hosting environment of the software asset. |
softwareDependencies | string or null [Optional] Dependencies of the software asset. |
cryptographicHash | string or null [Optional] Cryptographic hash of the software asset. |
inServiceData | string or null [Optional] In-service data of the software asset. |
itBudgetUii | string or null [Optional] IT budget UII of the software asset. |
fiscalYear | string or null [Optional] Fiscal year (FY) of the software asset. |
popEndDate | integer or null <int64> [Optional] Period of performance (POP) end date of the software asset. |
licenseOrContract | string or null [Optional] License or contract number of the software asset. |
licenseTerm | string or null [Optional] License term of the software asset. |
costPerLicense | number or null <double> [Optional] Cost per license of the software asset. Number will be converted to display 2 decimal points. |
totalLicenses | integer or null <int64> [Optional] Total licenses of the software asset. |
totalLicenseCost | number or null <double> [Optional] Total license cost of the software asset. Number will be converted to display 2 decimal points. |
licensesUsed | integer or null <int64> [Optional] Number of licenses used for the software asset. |
licensePoc | string or null [Optional] Point of contact (POC) for the software asset. |
licenseRenewalDate | integer or null <int64> [Optional] License renewal date for the software asset. |
licenseExpirationDate | integer or null <int64> [Optional] License expiration date for the software asset. |
approvalStatus | string or null [Optional] Approval status of the software asset. |
releaseDate | integer or null <int64> [Optional] Release date of the software asset. |
maintenanceDate | integer or null <int64> [Optional] Maintenance date of the software asset. |
retirementDate | integer or null <int64> [Optional] Retirement date of the software asset. |
endOfLifeSupportDate | integer or null <int64> [Optional] End of life support date of the software asset. |
extendedEndOfLifeSupportDate | integer or null <int64> [Optional] If set, the Extended End of Life/Support Date cannot occur prior to the End of Life/Support Date. |
criticalAsset | boolean or null [Optional] Indicates whether the asset is a critical information system asset. |
location | string or null [Optional] Location of the software asset. |
purpose | string or null [Optional] Purpose of the software asset. |
unsupportedOperatingSystem | boolean or null [Optional] Unsupported operating system. VA only. |
unapprovedSoftwareFromTrm | boolean or null [Optional] Unapproved software from TRM. VA only |
approvedWaiver | boolean or null [Optional] Approved waiver. VA only |
[- {
- "softwareVendor": "Test Vendor",
- "softwareName": "Test Software Name 11",
- "version": 1,
- "approvalDate": 1715312304,
- "softwareType": "COTS Application",
- "parentSystem": "Test Parent System",
- "subsystem": "Test Subsystem",
- "network": "Test Network",
- "hostingEnvironment": "Test Hosting Environment",
- "softwareDependencies": "Test Dependencies",
- "cryptographicHash": "Test Cryptographic Hash 32\"",
- "inServiceData": "Test In-Service Data",
- "itBudgetUii": "Test IT Budget Uii",
- "fiscalYear": 2021,
- "popEndDate": 1715312304,
- "licenseOrContract": "Test License Or Contract 25",
- "licenseTerm": "Test License Term 25",
- "costPerLicense": 250.25,
- "totalLicenses": 100,
- "totalLicenseCost": 2250.25,
- "licensesUsed": 100,
- "licensePoc": "Smith, Joe",
- "licenseRenewalDate": 1715312304,
- "licenseExpirationDate": 1715312304,
- "approvalStatus": "In Progress",
- "releaseDate": 1715312304,
- "maintenanceDate": 1715312304,
- "retirementDate": 1715312304,
- "endOfLifeSupportDate": 1715312304,
- "extendedEndOfLifeSupportDate": 1715312304,
- "criticalAsset": false,
- "location": "Test Location",
- "purpose": "Test Purpose",
- "unsupportedOperatingSystem": false,
- "unapprovedSoftwareFromTrm": false,
- "approvedWaiver": false
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 85,
- "softwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Updates assets in the Software Baseline for given systemId
Request Body Required Fields
softwareId
softwareVendor
softwareName
version
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for updating software baseline assets to an existing System (systemId)
softwareId | string or null [Read-Only] GUID identifying the specific software asset. |
softwareVendor | string [Required] Vendor of the software asset. |
softwareName | string [Required] Name of the software asset. |
version | string [Required] Version of the software asset. |
approvalDate | integer or null <int64> [Conditional] Approval date of the software asset. If Approval Status is set to "Unapproved" or "In Progress", Approval Date will be set to null. |
softwareType | string or null [Optional] Type of the software asset. |
parentSystem | string or null [Optional] Parent system of the software asset. |
subsystem | string or null [Optional] Subsystem of the software asset. |
network | string or null [Optional] Network of the software asset. |
hostingEnvironment | string or null [Optional] Hosting environment of the software asset. |
softwareDependencies | string or null [Optional] Dependencies of the software asset. |
cryptographicHash | string or null [Optional] Cryptographic hash of the software asset. |
inServiceData | string or null [Optional] In-service data of the software asset. |
itBudgetUii | string or null [Optional] IT budget UII of the software asset. |
fiscalYear | string or null [Optional] Fiscal year (FY) of the software asset. |
popEndDate | integer or null <int64> [Optional] Period of performance (POP) end date of the software asset. |
licenseOrContract | string or null [Optional] License or contract number of the software asset. |
licenseTerm | string or null [Optional] License term of the software asset. |
costPerLicense | number or null <double> [Optional] Cost per license of the software asset. Number will be converted to display 2 decimal points. |
totalLicenses | integer or null <int64> [Optional] Total licenses of the software asset. |
totalLicenseCost | number or null <double> [Optional] Total license cost of the software asset. Number will be converted to display 2 decimal points. |
licensesUsed | integer or null <int64> [Optional] Number of licenses used for the software asset. |
licensePoc | string or null [Optional] Point of contact (POC) for the software asset. |
licenseRenewalDate | integer or null <int64> [Optional] License renewal date for the software asset. |
licenseExpirationDate | integer or null <int64> [Optional] License expiration date for the software asset. |
approvalStatus | string or null [Optional] Approval status of the software asset. |
releaseDate | integer or null <int64> [Optional] Release date of the software asset. |
maintenanceDate | integer or null <int64> [Optional] Maintenance date of the software asset. |
retirementDate | integer or null <int64> [Optional] Retirement date of the software asset. |
endOfLifeSupportDate | integer or null <int64> [Optional] End of life support date of the software asset. |
extendedEndOfLifeSupportDate | integer or null <int64> [Optional] If set, the Extended End of Life/Support Date cannot occur prior to the End of Life/Support Date. |
criticalAsset | boolean or null [Optional] Indicates whether the asset is a critical information system asset. |
location | string or null [Optional] Location of the software asset. |
purpose | string or null [Optional] Purpose of the software asset. |
unsupportedOperatingSystem | boolean or null [Optional] Unsupported operating system. VA only. |
unapprovedSoftwareFromTrm | boolean or null [Optional] Unapproved software from TRM. VA only |
approvedWaiver | boolean or null [Optional] Approved waiver. VA only |
[- {
- "softwareId": "171fc7d0-6957-4f54-bd51-3b7cbc6c39d5",
- "softwareVendor": "Test Vendor",
- "softwareName": "Test Software Name 11",
- "version": 1,
- "approvalDate": 1715312304,
- "softwareType": "COTS Application",
- "parentSystem": "Test Parent System",
- "subsystem": "Test Subsystem",
- "network": "Test Network",
- "hostingEnvironment": "Test Hosting Environment",
- "softwareDependencies": "Test Dependencies",
- "cryptographicHash": "Test Cryptographic Hash 32\"",
- "inServiceData": "Test In-Service Data",
- "itBudgetUii": "Test IT Budget Uii",
- "fiscalYear": 2021,
- "popEndDate": 1715312304,
- "licenseOrContract": "Test License Or Contract 25",
- "licenseTerm": "Test License Term 25",
- "costPerLicense": 250.25,
- "totalLicenses": 100,
- "totalLicenseCost": 2250.25,
- "licensesUsed": 100,
- "licensePoc": "Smith, Joe",
- "licenseRenewalDate": 1715312304,
- "licenseExpirationDate": 1715312304,
- "approvalStatus": "In Progress",
- "releaseDate": 1715312304,
- "maintenanceDate": 1715312304,
- "retirementDate": 1715312304,
- "endOfLifeSupportDate": 1715312304,
- "extendedEndOfLifeSupportDate": 1715312304,
- "criticalAsset": false,
- "location": "Test Location",
- "purpose": "Test Purpose",
- "unsupportedOperatingSystem": false,
- "unapprovedSoftwareFromTrm": false,
- "approvedWaiver": false
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 85,
- "softwareId": "0bcaba59-a4f4-4918-a267-aedee3ea750d",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
Remove (delete) one or multiple assets from a system Software Baseline
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for deleting one or many Software Baseline assets
softwareId | string |
[- {
- "softwareId": "171fc7d0-6957-4f54-bd51-3b7cbc6c39d5"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "systemId": 85,
- "softwareId": "171fc7d0-6957-4f54-bd51-3b7cbc6c39d5",
- "success": true,
- "errors": [
- "key:value"
]
}
]
}
The Device Scan Results endpoint provides the ability to upload device scan results in the assets module for a system.
Request Body Required Field
scanType
Scan Type Allow Values:
Business Rules
The body of a request through the Device Scan Results POST endpoint accepts a single binary file. Specific file extensions are expected depending upon the scanType parameter. For example, .ckl or .cklb files are accepted when using scanType is set to disaStigViewerCklCklb.
When set to acasAsrArf or policyAuditor, a .zip file is expected which should contain a single scan result (for example, a single pair of .asr and .arf files). Single files are expected for all other scan types as this endpoint requires files to be uploaded consecutively as opposed to in bulk.
Current scan types that are supported:
systemId required | integer Example: 35 System Id: The unique system record identifier. |
scanType required | string Default: "disaStigViewerCklCklb" Enum: "acasAsrArf" "acasNessus" "disaStigViewerCklCklb" "disaStigViewerCmrs" "policyAuditor" "scapComplianceChecker" Scan Type: The file scan type to upload |
isBaseline | boolean Default: false Is Baseline: Indicates that the imported file represents a baseline scan that includes all findings and results. Importing as a baseline scan, which assumes a common set of scan policies are used when conducting a scan, will replace a device's findings for a specific Benchmark. Applicable to ASR/ARF scans only. |
See Business Rules
posted above for file type.
filename required | string <binary> The file to upload. Can be a single file or a .zip file. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "filename": "MySystemEntityScan.ckl",
- "assetsImported": 1,
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Cloud Resource Results endpoint provides the ability to add, update, and remove cloud resources and their scan results in the assets module for a system.
Add cloud resources and their scan results in the assets module for a system systemId
Request Body Required Fields
provider
resourceId
resourceName
resourceType
complianceResults
(Object Array)cspPolicyDefinitionId
isCompliant
policyDefinitionTitle
Example Request Body Required Fields
[
{
"provider": "provide name",
"resourceId": "resource identification",
"resourceName": "resource name",
"resourceType": "resource type",
"complianceResults": [
{
"cspPolicyDefinitionId": "CSP policy definition identification",
"policyDefinitionTitle": "policy definition title",
"isCompliant": [true or false]
}
]
}
]
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding cloud resources and their scan results
provider | string [Required] Cloud service provider name |
resourceId | string [Required] Unique identifier/resource namespace for policy compliance result |
resourceName | string [Required] Friendly name of Cloud resource |
resourceType | string [Required] Type of Cloud resource |
initiatedBy | string [Optional] Email of POC |
cspAccountId | string [Optional] System/owner's CSP account ID/number |
cspRegion | string [Optional] CSP region of system |
isBaseline | boolean [Optional] True/false flag for providing results as baseline. If true, all existing compliance results for the resourceId will be replaced by results in the current call |
object [Optional] Informational tags associated to results for other metadata | |
Array of objects |
[- {
- "provider": "azure",
- "resourceId": "/subscriptions/123456789/sample/resource/namespace/default",
- "resourceName": "Storage Resource",
- "resourceType": "Microsoft.storage.table",
- "initiatedBy": "john.doe.ctr@mail.mil",
- "cspAccountId": "123456789",
- "cspRegion": "useast2",
- "isBaseline": true,
- "tags": {
- "test": "testtag"
}, - "complianceResults": [
- {
- "cspPolicyDefinitionId": "/providers/sample/policy/namespace/au11_policy",
- "policyDefinitionTitle": "AU-11 - Audit Record Retention",
- "isCompliant": false,
- "complianceCheckTimestamp": 1644003780,
- "control": "AU-11",
- "assessmentProcedure": "000167,000168",
- "complianceReason": "retention period not configured",
- "policyDeploymentName": "testDeployment",
- "policyDeploymentVersion": "1.0.0",
- "severity": "High"
}
]
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "resourceId": "/subscriptions/123456789/sample/resource/namespace/default",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
Removes cloud resources and their scan results in the assets module for a system systemId
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Delete the given Cloud Resource Id
resourceId | string [Required] Unique item identifier |
[- {
- "resourceId": "/subscriptions/123456789/sample/resource/namespace/default"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "resourceId": "/subscriptions/123456789/sample/resource/namespace/default",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Container Scan Results endpoint provides the ability to add, update, and remove containers and their scan results in the assets module for a system.
Add containers and their scan results in the assets module for a system systemId
.
Request Body Required Fields
containerId
containerName
time
benchmarks
(Object Array)benchmark
results
(Object Array)ruleId
status
lastSeen
Example Request Body Required Fields
[
{
"containerId": "container identification",
"containerName": "container name",
"time": Datetime of scan/result (1648217219),
"benchmarks": [
{
"benchmark": "RHEL_8_STIG",
"results": [
{
"ruleId": "rule identification",
"status": [Pass,Fail,Other,Not Reviewed,Not Checked,Not Applicable],
"lastSeen": Unix date format (1648217219)
}, {
"ruleId": "rule identification",
"status": [Pass,Fail,Other,Not Reviewed,Not Checked,Not Applicable],
"lastSeen": Unix date format (1648217219)
}
]
}
]
}
]
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding containers and their scan results
containerId | string [Required] Unique identifier of the container |
containerName | string [Required] Friendly name of the container |
time | integer <int64> [Required] Datetime of scan/result. Unix date format |
podName | string [Optional] Name of pod (e.g. Kubernetes pod) |
podIp | string [Optional] IP address of pod |
namespace | string [Optional] Namespace of container in container orchestration (e.g. Kubernetes namespace) |
object [Optional] Informational tags associated to results for other metadata | |
Array of objects |
[- {
- "containerId": "157ac21c-49b4-4faf-a4ac-bfefd869ba3b",
- "containerName": "command-control",
- "time": 1648217219,
- "podName": "command-control-955596ffc",
- "podIp": "1.1.1.101",
- "namespace": "command-control",
- "tags": {
- "test": "testtag"
}, - "benchmarks": [
- {
- "benchmark": "RHEL_8_STIG",
- "isBaseline": false,
- "version": 2,
- "release": 4,
- "results": [
- {
- "ruleId": "SV-230221r743913_rule",
- "status": "Pass",
- "lastSeen": 1648217219,
- "message": "test message"
}
]
}
]
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "containerId": "command-control",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
Removes container scan resources and their scan results in the assets module for a system systemId
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Delete the given Container Scan Id
containerId | string [Required] Unique item identifier |
[- {
- "containerId": "157ac21c-49b4-4faf-a4ac-bfefd869ba3b"
}
]
{- "meta": {
- "code": 200
}, - "data": [
- {
- "containerId": "command-control",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Static Code Scans endpoint provides the ability to upload application scan findings into a system's assets module. Application findings can also be cleared from the system.
Upload or clear application scan findings into a system's systemId
assets module.
Request Body Required Fields
application
(Object)applicationName
version
applicationFindings
(Object Array)codeCheckName
count
scanDate
cweId
NOTE: To clear an application's findings, use only the field clearFindings
as
the Request body and set it to true. Example:
[
{
"application": {
"applicationName": "application name",
"version": "application version"
},
"applicationFindings": [
{ "clearFindings": true }
]
}
]
systemId required | integer Example: 35 System Id: The unique system record identifier. |
Example request body for adding static code scans or Clear static code scans
object | |
Array of objects (Static Code Application POST object") |
{- "application": {
- "applicationName": "Artemis",
- "version": "Version 5.0"
}, - "applicationFindings": [
- {
- "rawSeverity": "Moderate",
- "codeCheckName": "Hidden Field",
- "count": 14,
- "scanDate": 1625070000,
- "cweId": "155",
- "clearFindings": false
}
]
}
{- "meta": {
- "code": 200
}, - "data": [
- {
- "applicationName": "Artemis",
- "version": "Version 5.0",
- "success": true,
- "systemId": 35,
- "errors": [
- "key:value"
]
}
]
}
The Workflow Definitions endpoint provides the ability to view all workflow schemas available on the eMASS instance. Every transition for each workflow stage is included.
View all workflow schemas available on the eMASS instance filtered by
status includeInactive
and registration type registrationType
.
includeInactive | boolean Default: true Include Inactive: If no value is specified, the default returns false to not include outdated workflow definitions. |
registrationType | string Default: "regular" Registration Type: Filter record by selected registration type (single value or comma delimited values). Valid Options Are: assessAndAuthorize, assessOnly, guest, regular, functional, cloudServiceProvider, commonControlProvider, authorizationToUse, reciprocityAcceptanc |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "workflowUid": "6f810301-5b3b-4f89-81e7-587fef9142a9",
- "workflow": "RMF Step 1: Security Category",
- "version": "4",
- "description": "The workflow description",
- "isActive": false,
- "stages": [
- {
- "name": "Not Started",
- "transitions": [
- {
- "endStage": "Submit Categorization",
- "description": "Initiate Workflow",
- "roles": [
- "PM/ISO, System Admin, eMASS System Admin, ISSE, ISSM, IO"
]
}
]
}
]
}
]
}
The Workflow Instances endpoint provides the ability to view detailed information on all active and historical workflows for an eMASS instance.
View detailed information on all active and historical workflows filtered by provided parameters.
includeComments | boolean Default: true Include Comments: If no value is specified, the default returns true to not include transition comments. Note: Corresponds to the Comments textbox that is required at most workflow transitions. Does not include other text input fields such as Terms / Conditions for Authorization. |
includeDecommissionSystems | boolean Default: false Include Decommission Systems: If no value is specified, the default returns false to exclude decommissioned systems. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. Note: Pages contain 1000 workflow instances. |
sinceDate | string Example: sinceDate=1638764040 Date: Filter on authorization/assessment date (Unix date format). Note: Filters off the lastEditedDate field. Note: The authorization/assessment decisions on completed workflows can be edited for up to 30 days after the initial decision is made. |
status | string Default: "all" Enum: "active" "inactive" "all" Status: Filter by status. If no value is specified, the default returns all to include both active and inactive workflows. Note: Any workflows at a current stage of Complete or Cancelled are inactive. Ongoing workflows currently at other stages are active. |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "workflowUid": "6f810301-5b3b-4f89-81e7-587fef9142a9",
- "systemId": 35,
- "systemName": "Test system 1",
- "workflowInstanceId": 35,
- "packageName": "Test RMF Step 1 package",
- "createdDate": 1636124623,
- "lastEditedDate": 1631130837,
- "lastEditedBy": "john.doe.ctr@mail.mil",
- "workflow": "RMF Step 1: Security Category",
- "version": 11,
- "currentStage": "Echelon II",
- "transitions": [
- {
- "comments": "Approved the categorization",
- "createdBy": "john.doe.ctr@mail.mil",
- "createdDate": 1636124623,
- "description": "Submit New Package",
- "endStage": "Submit Categorization",
- "startStage": "Not Started"
}
]
}
], - "pagination": {
- "totalCount": 12,
- "totalPages": 2,
}
}
View detailed historical workflow information for workflowInstanceId
.
workflowInstanceId required | integer Example: 123 Workflow Instance Id: The unique workflow definition identifier. |
{- "meta": {
- "code": 200
}, - "data": {
- "workflowUid": "6f810301-5b3b-4f89-81e7-587fef9142a9",
- "systemId": 35,
- "systemName": "Test system 1",
- "workflowInstanceId": 35,
- "packageName": "Test RMF Step 1 package",
- "createdDate": 1636124623,
- "lastEditedDate": 1631130837,
- "lastEditedBy": "john.doe.ctr@mail.mil",
- "workflow": "RMF Step 1: Security Category",
- "version": 11,
- "currentStage": "Echelon II",
- "transitions": [
- {
- "comments": "Approved the categorization",
- "createdBy": "john.doe.ctr@mail.mil",
- "createdDate": 1636124623,
- "description": "Submit New Package",
- "endStage": "Submit Categorization",
- "startStage": "Not Started"
}
]
}
}
The Cybersecurity Maturity Model Certification (CMMC) Assessments endpoint provides the ability to view CMMC assessment information. It is available to CMMC eMASS only.
Get all CMMC assessment after the given date sinceDate
parameter. It is available
to CMMC eMASS only.
sinceDate required | string Example: sinceDate=1638764040 Date CMMC date (Unix date format) |
{- "meta": {
- "code": 200
}, - "data": [
- {
- "operation": "UPDATED",
- "hqOrganizationName": "Army",
- "uei": "9809123",
- "oscName": "UC Labs",
- "highestLevelOwnerCageCode": "99D8B",
- "cageCodesInScope": "89ED9; 99D8B",
- "numberOfEmployees": 100,
- "scope": "Enterprise",
- "scopeDescription": "Assessment of UC's Lab",
- "assessmentStandard": "NIST SP 800-171 Revision 2",
- "assessmentId": "41b89528-a7a8-470a-90f4-c3fd1267d6f7",
- "cmmcUid": "L20000003",
- "overallScore": 110,
- "cmmcStatus": "Conditional Level 2 (C3PAO)",
- "cmmcStatusDate": 1715312304,
- "cmmcStatusExpirationDate": 1715312304
}
]
}
The Dashboards endpoints provide the ability to view data contained in dashboard exports. In the eMASS frontend, these dashboard exports are generated as Excel exports.
Each dashboard dataset available from the API is automatically updated with the current configuration of the dashboard and the instance of eMASS as the dashboard changes.
Organization-specific fields may differ. Organization-specific Dashboards should only be used by that organization (e.g., VA [dashboard name] should be used by VA).
Get systems status detail dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems terms conditions summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems terms conditions details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems connectivity/CCSD summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems connectivity/CCSD details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems ATC/IATC details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems questionnaire summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems questionnaire details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems workflow history summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems workflow history details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems workflow history stage details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems control compliance summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems security control details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems assessment procedures details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get systems POA&Ms summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system POA&Ms details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system Artifacts summary information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system Artifacts details information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system hardware summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system hardware details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system sensor hardware summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system sensor hardware details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system software summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system software details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system sensor software summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system sensor hardsoftwareware details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system sensor hardsoftwareware count dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system critical assets summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system vulnerability summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system device findings summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get ssystem device findings details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system application findings summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system application findings details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system ports and protocols summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system ports and protocols details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system CONMON integration status dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system associations details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get user system assignments details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get organization migration status summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system migration status summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get system FISMA metrics dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get Coast Guard system FISMA metrics dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get user system privacy summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA OMB-FISMA SAOP summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system ICAMP Tableau POAM details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system A&A summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system A2.0 summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system P.L. 109 reporting summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system FISMA inventory summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system FISMA inventory crypto summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system threat risk summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system threat source details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get VA system threat architecture details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get CMMC assessment status summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get CMMC assessment requirements compliance summary dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get CMMC assessment security requirements details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}
Get CMMC assessment requirement objectives details dashboard information.
orgId required | integer Example: orgId=1 Organization Id: The unique organization identifier. |
excludeinherited | boolean Default: false Exclude Inherited: If no value is specified, the default returns false to include inherited data. |
pageIndex | integer Default: 0 Page Index: If no value is specified, the default returns results from the first page with an index of 0. |
pageSize | integer Default: 20000 Page Size: If no value is specified, the default returns 20000 per page. |
{- "meta": {
- "code": 200
}, - "data": [
- { }
], - "pagination": {
- "pageIndex": 1,
- "pageSize": 20000,
- "totalCount": 4,
- "totalPages": 1,
}
}