---
search:
  tags:
    - artifacts
    - GET
seo:
  description: >-
    Check the status of Remote Caching for the authenticated user or team.…
    Reference for the GET /artifacts/status endpoint in the Turborepo Remote
    Cache API.
sidebar:
  label: Get remote caching status
  badge: GET
title: Get remote caching status
type: openapi-operation
---
Check the status of Remote Caching for the authenticated user or team. Returns a JSON-encoded status indicating if Remote Caching is enabled, disabled, or disabled due to usage limits.

Implementers should return `enabled` if the authenticated principal is allowed to use the cache, or `disabled` if not. The `over_limit` and `paused` statuses are optional and can be used to indicate usage limits or temporary suspension.

`GET /artifacts/status`

**Responses**

- `200` — Remote caching status retrieved successfully
- `400` — Bad request. One or more of the provided values in the request query, headers, or body is invalid.
- `401` — Unauthorized. The request is missing a valid authentication token or the token is invalid.
- `403` — Forbidden. The authenticated user does not have permission to access this resource.

Response example, 200:

```json
{
  "status": "disabled"
}
```