# Data retrieval APIs for AWS Security Hub
<a name="awssecurityhub"></a>

AWS Security Hub provides the following APIs for data retrieval.


****  

| Actions | Description | Access level | 
| --- | --- | --- | 
| <a name="securityhub-BatchGetAutomationRules"></a>[https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules](https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules) | Retrieve a list of details for automation rules from Security Hub based on rule Amazon Resource Names (ARNs) | Read | 
| <a name="securityhub-BatchGetConfigurationPolicyAssociations"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetConfigurationPolicyAssociations.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetConfigurationPolicyAssociations.html) | Retrieve information about configuration policies associated with a specific list of member accounts and organizational units of the calling account's organization | Read | 
| <a name="securityhub-BatchGetControlEvaluations"></a>[https://docs.aws.amazon.com/securityhub/latest/userguide/iam-permissions-controls-standards.html](https://docs.aws.amazon.com/securityhub/latest/userguide/iam-permissions-controls-standards.html) | Get the enablement and compliance status of controls, the findings count for controls, and the overall security score for controls on the Security Hub console | Read | 
| <a name="securityhub-BatchGetSecurityControls"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetSecurityControls.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetSecurityControls.html) | Get details about specific security controls identified by ID or ARN | Read | 
| <a name="securityhub-BatchGetStandardsControlAssociations"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetStandardsControlAssociations.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_BatchGetStandardsControlAssociations.html) | Get the enablement status of a batch of security controls in standards | Read | 
| <a name="securityhub-DescribeActionTargets"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeActionTargets.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeActionTargets.html) | Retrieve a list of custom actions using the API | Read | 
| <a name="securityhub-DescribeHub"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeHub.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeHub.html) | Retrieve information about the hub resource in your account | Read | 
| <a name="securityhub-DescribeOrganizationConfiguration"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeOrganizationConfiguration.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeOrganizationConfiguration.html) | Describe the organization configuration for Security Hub | Read | 
| <a name="securityhub-DescribeProducts"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeProducts.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeProducts.html) | Retrieve information about the available Security Hub product integrations | Read | 
| <a name="securityhub-DescribeProductsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeProductsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeProductsV2.html) | Retrieve information about the available Security Hub V2 product integrations | Read | 
| <a name="securityhub-DescribeSecurityHubV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeSecurityHubV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeSecurityHubV2.html) | Retrieve information about the hub V2 resource in your account | Read | 
| <a name="securityhub-DescribeStandards"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeStandards.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeStandards.html) | Retrieve information about Security Hub standards | Read | 
| <a name="securityhub-DescribeStandardsControls"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeStandardsControls.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_DescribeStandardsControls.html) | Retrieve information about Security Hub standards controls | Read | 
| <a name="securityhub-GetAdhocInsightResults"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingStatisticsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingStatisticsV2.html) | Retrieve aggregated statistical data about the findings | Read | 
| <a name="securityhub-GetAdministratorAccount"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetAdministratorAccount.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetAdministratorAccount.html) | Retrieve details about the Security Hub administrator account | Read | 
| <a name="securityhub-GetAggregatorV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetAggregatorV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetAggregatorV2.html) | Retrieve details for an aggregatorV2, which configures data aggregation across Regions | Read | 
| <a name="securityhub-GetAutomationRuleV2"></a>[https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules](https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules) | Retrieve details for an automation rule V2 from Security Hub based on rule Amazon Resource Name (ARN) | Read | 
| <a name="securityhub-GetConfigurationPolicy"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConfigurationPolicy.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConfigurationPolicy.html) | Get a complete overview of one configuration policy created by the calling account | Read | 
| <a name="securityhub-GetConfigurationPolicyAssociation"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConfigurationPolicyAssociation.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConfigurationPolicyAssociation.html) | Retrieve information about a configuration policy associated with a member account or organizational unit of the calling account's organization | Read | 
| <a name="securityhub-GetConnectorV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConnectorV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetConnectorV2.html) | Retrieve details for a connector V2 from Security Hub based on connector id | Read | 
| <a name="securityhub-GetControlFindingSummary"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetControlFindingSummary.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetControlFindingSummary.html) | Retrieve a security score and counts of finding and control statuses for a security standard | Read | 
| <a name="securityhub-GetEnabledStandards"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetEnabledStandards.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetEnabledStandards.html) | Retrieve a list of the standards that are enabled in Security Hub | List | 
| <a name="securityhub-GetFindingAggregator"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingAggregator.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingAggregator.html) | Retrieve details for a finding aggregator, which configures finding aggregation across Regions | Read | 
| <a name="securityhub-GetFindingHistory"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingHistory.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingHistory.html) | Retrieve a list of finding history from Security Hub | Read | 
| <a name="securityhub-GetFindings"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingsV2.html) | Retrieve a list of findings from Security Hub | Read | 
| <a name="securityhub-GetFindingsTrendsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingsTrendsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFindingsTrendsV2.html) | Retrieve findings trends | Read | 
| <a name="securityhub-GetFreeTrialEndDate"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFreeTrialEndDate.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFreeTrialEndDate.html) | Retrieve the end date for an account's free trial of Security Hub | Read | 
| <a name="securityhub-GetFreeTrialUsage"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFreeTrialUsage.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetFreeTrialUsage.html) | Retrieve information about Security Hub usage during the free trial period | Read | 
| <a name="securityhub-GetInsightFindingTrend"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsightFindingTrend.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsightFindingTrend.html) | Retrieve an insight finding trend from Security Hub in order to generate a graph | Read | 
| <a name="securityhub-GetInsightResults"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsightResults.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsightResults.html) | Retrieve insight results from Security Hub | Read | 
| <a name="securityhub-GetInsights"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsights.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInsights.html) | Retrieve Security Hub insights | List | 
| <a name="securityhub-GetInvitationsCount"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInvitationsCount.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetInvitationsCount.html) | Retrieve the count of Security Hub membership invitations sent to the account | Read | 
| <a name="securityhub-GetMasterAccount"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetMasterAccount.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetMasterAccount.html) | Retrieve details about the Security Hub master account | Read | 
| <a name="securityhub-GetMembers"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetMembers.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetMembers.html) | Retrieve the details of Security Hub member accounts | Read | 
| <a name="securityhub-GetResourcesStatisticsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesStatisticsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesStatisticsV2.html) | Retrieve aggregate statistics about resources | Read | 
| <a name="securityhub-GetResourcesTrendsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesTrendsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesTrendsV2.html) | Retrieve resources trends | Read | 
| <a name="securityhub-GetResourcesV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetResourcesV2.html) | Retrieve a list of resources | Read | 
| <a name="securityhub-GetSecurityControlDefinition"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetSecurityControlDefinition.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetSecurityControlDefinition.html) | Get the definition details of a specific security control identified by ID | Read | 
| <a name="securityhub-GetUsage"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetUsage.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_GetUsage.html) | Retrieve information about Security Hub usage by accounts | Read | 
| <a name="securityhub-ListAggregatorsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListAggregatorsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListAggregatorsV2.html) | Retrieve a list of aggregatorsV2, which configures data aggregation across Regions | List | 
| <a name="securityhub-ListAutomationRules"></a>[https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules](https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules) | Retrieve a list of automation rules and their metadata for the calling account from Security Hub | List | 
| <a name="securityhub-ListAutomationRulesV2"></a>[https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules](https://docs.aws.amazon.com/securityhub/latest/userguide/automation-rules) | Retrieve a list of automation rules V2 and their metadata for the calling account from Security Hub | List | 
| <a name="securityhub-ListConfigurationPolicies"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConfigurationPolicies.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConfigurationPolicies.html) | List the summaries of all configuration policies created by the calling account | List | 
| <a name="securityhub-ListConfigurationPolicyAssociations"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConfigurationPolicyAssociations.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConfigurationPolicyAssociations.html) | Retrieve information about all configuration policies associationed with all member accounts and organizational units of the calling account's organization | List | 
| <a name="securityhub-ListConnectorsV2"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConnectorsV2.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListConnectorsV2.html) | Retrieve a list of connectors V2 and their metadata for the calling account from Security Hub | List | 
| <a name="securityhub-ListControlEvaluationSummaries"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListControlEvaluationSummaries.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListControlEvaluationSummaries.html) | Retrieve a list of controls for a standard, including the control IDs, statuses and finding counts | Read | 
| <a name="securityhub-ListEnabledProductsForImport"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListEnabledProductsForImport.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListEnabledProductsForImport.html) | Retrieve the Security Hub integrated products that are currently enabled | List | 
| <a name="securityhub-ListFindingAggregators"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListFindingAggregators.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListFindingAggregators.html) | Retrieve a list of finding aggregators, which contain the cross-Region finding aggregation configuration | List | 
| <a name="securityhub-ListInvitations"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListInvitations.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListInvitations.html) | Retrieve the Security Hub invitations sent to the account | List | 
| <a name="securityhub-ListMembers"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListMembers.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListMembers.html) | Retrieve details about Security Hub member accounts associated with the administrator account | List | 
| <a name="securityhub-ListOrganizationAdminAccounts"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListOrganizationAdminAccounts.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListOrganizationAdminAccounts.html) | List the Security Hub administrator accounts for your organization | List | 
| <a name="securityhub-ListSecurityControlDefinitions"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListSecurityControlDefinitions.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListSecurityControlDefinitions.html) | Retrieve a list of security control definitions, which contain details for security controls in the current region | List | 
| <a name="securityhub-ListStandardsControlAssociations"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListStandardsControlAssociations.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListStandardsControlAssociations.html) | List the enablement status of a security control in standards | List | 
| <a name="securityhub-ListTagsForResource"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListTagsForResource.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_ListTagsForResource.html) | List of tags associated with a resource | Read | 
| <a name="securityhub-SendFindingEvents"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_SendFindingEvents.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_SendFindingEvents.html) | Use a custom action to send Security Hub findings to Amazon EventBridge | Read | 
| <a name="securityhub-SendInsightEvents"></a>[https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_SendInsightEvents.html](https://docs.aws.amazon.com/securityhub/1.0/APIReference/API_SendInsightEvents.html) | Use a custom action to send Security Hub insights to Amazon EventBridge | Read |