GitHub API (unofficial showcase)
GET/orgs/{org}/copilot/billing

Get Copilot seat information and settings for an organization

Retrieves an organization's Copilot subscription details, including its seat breakdown and feature policies. Use org to identify the organization; only organization owners can view these details. OAuth app tokens and classic personal access tokens need the manage_billing:copilot or read:org scope.

1 parameter
orgstringrequired
The organization name. The name is not case sensitive.

6 status codes
200Returns the organization's Copilot seat breakdown and policy settings, including public code suggestions, IDE chat, platform chat, CLI, seat management, and plan type.
seat_breakdownobjectrequired
The breakdown of Copilot Business seats for the organization.
public_code_suggestionsstringrequired
The organization policy for allowing or blocking suggestions matching public code (duplication detection filter).
Allowed:allowblockunconfigured
ide_chatstringoptional
The organization policy for allowing or disallowing Copilot Chat in the IDE.
Allowed:enableddisabledunconfigured
platform_chatstringoptional
The organization policy for allowing or disallowing Copilot features on GitHub.com.
Allowed:enableddisabledunconfigured
clistringoptional
The organization policy for allowing or disallowing Copilot CLI.
Allowed:enableddisabledunconfigured
seat_management_settingstringrequired
The mode of assigning new seats.
Allowed:assign_allassign_selecteddisabledunconfigured
plan_typestringoptional
The Copilot plan of the organization, or the parent enterprise, when applicable.
Allowed:businessenterprise
401Returned when the request is not authenticated.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
403Returned when the authenticated user is not authorized to view the organization's Copilot subscription details.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
404Returned when the organization resource is not found.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
422Returned when there is a problem with the account's associated payment method.
500Returned when an internal error occurs.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 401 is returned when authentication is missing or invalid, and a 403 when the authenticated user lacks access; OAuth app tokens and classic personal access tokens need either manage_billing:copilot or read:org, and only organization owners can view these details. A 404 is returned when the organization resource is not found; the org path parameter must identify the organization. A 422 indicates a problem with the account's associated payment method, and a 500 indicates an internal error.