---
title: "POST /freetrialinfo/batchget"
method: POST
path: "/freetrialinfo/batchget"
---

# POST /freetrialinfo/batchget

`POST /freetrialinfo/batchget`

Gets free trial status for multiple Amazon Web Services accounts.

## Request body

- object
  - `accountIds` MeteringAccountId[], required — The account IDs to get free trial status for.

## Response `200`

Success

- BatchGetFreeTrialInfoResponse
  - `accounts` FreeTrialAccountInfo[], required — An array of objects that provide Amazon Inspector free trial details for each of the requested accounts.
    - `accountId` string, required — The account associated with the Amazon Inspector free trial information.
    - `freeTrialInfo` FreeTrialInfo[], required — Contains information about the Amazon Inspector free trial for an account.
      - `type` 'EC2' | 'ECR' | 'LAMBDA' | 'LAMBDA_CODE' | 'CODE_REPOSITORY' | 'VM' | 'CONTAINER_IMAGE' | 'SERVERLESS_FUNCTION', required — The type of scan covered by the Amazon Inspector free trail.
      - `start` string, date-time, required — The date and time that the Amazon Inspector free trail started for a given account.
      - `end` string, date-time, required — The date and time that the Amazon Inspector free trail ends for a given account.
      - `status` 'ACTIVE' | 'INACTIVE', required — The order to sort results by.
      - `cloudProvider` 'AWS' | 'AZURE' | 'NOT_APPLICABLE' — The cloud provider associated with the free trial information.
  - `failedAccounts` FreeTrialInfoError[], required — An array of objects detailing any accounts that free trial data could not be returned for.
    - `accountId` string, required — The account associated with the Amazon Inspector free trial information.
    - `code` 'ACCESS_DENIED' | 'INTERNAL_ERROR', required — The error code.
    - `message` string, required — The error message returned.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/inspector2.md) · [All operations](https://skmtc.net/aws/apis/inspector2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/inspector2/versions/c51110c7cd43/schema)