---
title: "Plan, renewal or expiry, the plans with their prices, and the Customer Portal link (null without the billing scope): billing_status"
method: GET
path: "/api/me/billing"
tags: ["owner"]
---

# Plan, renewal or expiry, the plans with their prices, and the Customer Portal link (null without the billing scope): billing_status

`GET /api/me/billing`

## Request

- Base URL: `https://daycal.io`
- URL: `https://daycal.io/api/me/billing`
- Auth: HTTP bearer

## Response `200`

OK

- object
  - `plan` 'free' | 'pro', required
  - `renews` string, date-time, nullable, required
  - `expires` string, date-time, nullable, required
  - `portalUrl` string, nullable, required
  - `plans` object, required

## Other responses

- `401`: Missing, unknown, expired or revoked token: sign in again (RFC 6750 invalid_token)
- `403`: Outside this token's access (RFC 6750 insufficient_scope): the owner scopes are read, write, billing and secrets; the challenge names the ones to sign in again for
- `429`: Rate limited. Retry-After is set when a rate-limit window is spent (not on a booking's own budget)
- `default`: Error

---

[API](https://skmtc.dev/daycal/apis/daycal-api.md) · [All operations](https://skmtc.dev/daycal/apis/daycal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daycal/apis/daycal-api/revisions/7103ffff4e8c?raw)