---
title: "Get organization billing"
method: GET
path: "/api/v1/organizations/{organizationId}/billing"
tags: ["Organizations"]
---

# Get organization billing

`GET /api/v1/organizations/{organizationId}/billing`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/organizations/{organizationId}/billing`
- Auth: API key in cookie `better-auth.session_token`

Get an organization's plan, subscription and lifetime plan purchase, and whether it has a Stripe customer. Requires the `billing: ["read"]` permission (owners and admins)

## Path parameters

- `organizationId` string, uuid, required

## Response `200`

OK

- object
  - `enabled` boolean, required
  - `planId` string, required
  - `hasCustomer` boolean, required
  - `subscription` object, nullable, required
    - `id` string, uuid, required
    - `status` string, required
    - `billingInterval` string, nullable, required
    - `seats` integer, nullable, required
    - `periodEnd` string, date-time, nullable, required
    - `trialEnd` string, date-time, nullable, required
    - `cancelAtPeriodEnd` boolean, required
    - `cancelAt` string, date-time, nullable, required
    - `planId` string, required
  - `purchase` object, nullable, required
    - `id` string, uuid, required
    - `amount` integer, required
    - `currency` string, required
    - `createdAt` string, date-time, required
    - `planId` string, required

## Other responses

- `400`: 400
- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 1 info
  - added the non-success response with the status `400`
- **2026-10-31** `3e642e95991a`: 1 breaking, 5 info
  - added `subschema #2` to the response body `oneOf` list for the response status `403`
  - added the non-success response with the status `429`
  - response property `subscription/anyOf[subschema #1]/cancelAtPeriodEnd` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - added the required property `hasCustomer` to the response with the `200` status
  - …2 more
- **2026-10-09** `db32553c29a6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/organizations/:organizationId/billing/get.md)

---

[API](https://skmtc.dev/easyscraper/apis/easy-scraper-api.md) - [All operations](https://skmtc.dev/easyscraper/apis/easy-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyscraper/apis/easy-scraper-api/revisions/a12cef98c52b?raw)