---
title: "List all test environments"
method: GET
path: "/test-environments"
tags: ["Test Environments"]
---

# List all test environments

`GET /test-environments`

Use this operation to retrieves a list of all Test Environments. 
It returns an ArrayResponse containing TestEnvironmentResponse objects, 
representing the available Test Environments in the system. 

### User Access Permission

You must be assigned the **Refresh Central Sandbox** permission to run 
this operation.

## Headers

- `Zuora-Entity-Ids` string
- `Zuora-Track-Id` string
- `Accept-Encoding` string
- `Content-Encoding` string

## Response `200`

Successfully retrieved a list of Test Environment responses

- TestEnvironmentArrayResponse — Container for array of objects
  - `result` TestEnvironmentResponse[] — Array of objects
    - `createTime` string, date-time — The date and time when the Test Environment was first synced to self-service
    - `createdById` string — The automatically generated ID of the Zuora user who created the Test Environment object
    - `dataCopyType` 'FULL' | 'CONFIGURATION' — The data copy approach for the Test Environment
    - `deactivationTime` string, date-time — The date and time when the Test Environment will be deactivated
    - `environmentType` 'TEST' | 'ENTERPRISE' | 'TRIAL' | 'DEMO' | 'DEVELOPER' — The type of tenant for the Test Environment
    - `id` string — The unique ID (UUID) of the Test Environment
    - `lastRefreshTime` string, date-time — The date and time when the Test Environment was last refreshed
    - `nextRefreshTime` string, date-time — The date and time when the Test Environment can be refreshed again
    - `provisionTime` string, date-time — The date and time when the Test Environment was provisioned
    - `revenueTenantId` string — The revenue tenant ID if a revenue sandbox is attached
    - `revenueTenantName` string — The revenue tenant name if a revenue sandbox is attached
    - `sourceTenantId` string — The source tenant ID from which the Test Environment was created
    - `status` 'ACTIVE' | 'PROCESSING' | 'INACTIVE' | 'DEACTIVATED' | 'DELETED' — The current status of the Test Environment
    - `tenantId` string — The tenant ID of the Test Environment
    - `tenantName` string — The tenant name of the Test Environment
    - `updateTime` string, date-time — The date and time when the Test Environment was last synced to self-service
    - `updatedById` string — The automatically generated ID of the Zuora user who updated the Test Environment object
  - `size` integer

## Other responses

- `400` — Bad request
- `500` — Internal Error

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)