---
title: "GET /v1/workspaces/{workspaceId}/billing/subscription"
method: GET
path: "/v1/workspaces/{workspaceId}/billing/subscription"
tags: ["Billing"]
---

# GET /v1/workspaces/{workspaceId}/billing/subscription

`GET /v1/workspaces/{workspaceId}/billing/subscription`

## Request

- Base URL: `https://api.atlas-compiler.com`
- URL: `https://api.atlas-compiler.com/v1/workspaces/{workspaceId}/billing/subscription`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Query parameters

- `sync` 'true' | 'false'

## Response `200`

Success

- object
  - `cancelAtPeriodEnd` boolean, required
  - `graceExpiresAt` string, date-time, nullable, required
  - `pendingPlan` object, nullable, required
    - `effectiveAt` string, date-time, required
    - `planCode` string, required
    - `planVersion` integer, required
  - `periodEnd` string, date-time, nullable, required
  - `periodStart` string, date-time, nullable, required
  - `planCode` string, required
  - `planVersion` integer, required
  - `status` 'none' | 'incomplete' | 'incomplete_expired' | 'trialing' | 'active' | 'past_due' | 'canceled' | 'unpaid' | 'paused', required
  - `updatedAt` string, date-time, required
  - `workspaceId` string, required

## Other responses

- `400`: RFC 9457 problem.
- `401`: RFC 9457 problem.
- `403`: RFC 9457 problem.
- `404`: RFC 9457 problem.
- `409`: RFC 9457 problem.
- `500`: RFC 9457 problem.
- `503`: RFC 9457 problem.

---

[API](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api.md) · [All operations](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api/revisions/a43b60619cdf?raw)