---
title: "Get Copilot seat information and settings for an organization"
method: GET
path: "/orgs/{org}/copilot/billing"
tags: ["copilot"]
---

# Get Copilot seat information and settings for an organization

`GET /orgs/{org}/copilot/billing`

> [!NOTE]
> This endpoint is in public preview and is subject to change.

Gets information about an organization's Copilot subscription, including seat breakdown
and feature policies. To configure these settings, go to your organization's settings on GitHub.com.
For more information, see "[Managing policies for Copilot in your organization](https://docs.github.com/enterprise-cloud@latest/copilot/managing-copilot/managing-policies-for-copilot-business-in-your-organization)."

Only organization owners can view details about the organization's Copilot Business or Copilot Enterprise subscription.

OAuth app tokens and personal access tokens (classic) need either the `manage_billing:copilot` or `read:org` scopes to use this endpoint.

## Path parameters

- `org` string, required

## Response `200`

OK

- CopilotOrganizationDetails — Information about the seat breakdown and policies set for an organization with a Copilot Business or Copilot Enterprise subscription.
  - `seat_breakdown` CopilotOrganizationSeatBreakdown, required — The breakdown of Copilot Business seats for the organization.
    - `total` integer — The total number of seats being billed for the organization as of the current billing cycle.
    - `added_this_cycle` integer — Seats added during the current billing cycle.
    - `pending_cancellation` integer — The number of seats that are pending cancellation at the end of the current billing cycle.
    - `pending_invitation` integer — The number of users who have been invited to receive a Copilot seat through this organization.
    - `active_this_cycle` integer — The number of seats that have used Copilot during the current billing cycle.
    - `inactive_this_cycle` integer — The number of seats that have not used Copilot during the current billing cycle.
  - `public_code_suggestions` 'allow' | 'block' | 'unconfigured', required — The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).
  - `ide_chat` 'enabled' | 'disabled' | 'unconfigured' — The organization policy for allowing or disallowing Copilot Chat in the IDE.
  - `platform_chat` 'enabled' | 'disabled' | 'unconfigured' — The organization policy for allowing or disallowing Copilot features on GitHub.com.
  - `cli` 'enabled' | 'disabled' | 'unconfigured' — The organization policy for allowing or disallowing Copilot CLI.
  - `seat_management_setting` 'assign_all' | 'assign_selected' | 'disabled' | 'unconfigured', required — The mode of assigning new seats.
  - `plan_type` 'business' | 'enterprise' — The Copilot plan of the organization, or the parent enterprise, when applicable.

## Other responses

- `401` — Requires authentication
- `403` — Forbidden
- `404` — Resource not found
- `422` — There is a problem with your account's associated payment method.
- `500` — Internal Error

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-2.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-2/versions/8ae6d0c8716e/schema)