> ## Documentation Index > Fetch the complete documentation index at: https://ona.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get Co Author Summary > Gets aggregated co-author summary for the organization or a specific project. `Unary` ยท [`Usage`](https://ona.com/docs/api-reference/generated/usage/overview) Gets aggregated co-author summary for the organization or a specific project. Use this method to: * Measure AI-assisted commits and line changes * Scope co-author insights to a project, user, or team * Compare the requested date range against the previous period ### Example ```yaml theme={null} dateRange: startTime: "2024-01-01T00:00:00Z" endTime: "2024-02-01T00:00:00Z" projectId: "d2c94c27-3b76-4a42-b88c-95a85e392c68" ``` ## Endpoint ```text theme={null} POST /api/gitpod.v1.UsageService/GetCoAuthorSummary ``` Send a Bearer token as described in [Authentication](https://ona.com/docs/api-reference.md#authenticate-requests). If your organization uses a custom management-plane domain, replace `https://app.ona.com` with that domain. ## Request example ```bash cURL theme={null} export ONA_HOST=https://app.ona.com export ONA_API_KEY= curl --request POST \ --url "$ONA_HOST/api/gitpod.v1.UsageService/GetCoAuthorSummary" \ --header "Authorization: Bearer $ONA_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "dateRange": { "endTime": "2026-01-01T00:00:00Z", "startTime": "2026-01-01T00:00:00Z" } }' ``` ```python Python theme={null} import gitpod.v1.usage_pb2 as usage_pb2 import google.protobuf.timestamp_pb2 as timestamp_pb2 from ona_sdk import create_client_from_env ona = create_client_from_env() request = usage_pb2.GetCoAuthorSummaryRequest( date_range=usage_pb2.DateRange( start_time=timestamp_pb2.Timestamp(seconds=1767225600), end_time=timestamp_pb2.Timestamp(seconds=1767225600), ), ) response = ona.services.usage.get_co_author_summary(request) print(response) ``` ```typescript TypeScript theme={null} import { create } from "@bufbuild/protobuf"; import { createClientFromEnv } from "@gitpod/sdk"; import { GetCoAuthorSummaryRequestSchema } from "@gitpod/sdk/gitpod/v1/usage_pb"; import { timestampFromDate } from "@bufbuild/protobuf/wkt"; async function main() { const ona = createClientFromEnv(); const request = create(GetCoAuthorSummaryRequestSchema, { dateRange: { startTime: timestampFromDate(new Date("2026-01-01T00:00:00Z")), endTime: timestampFromDate(new Date("2026-01-01T00:00:00Z")), }, }); const response = await ona.services.usage.getCoAuthorSummary(request); console.log(response); } main().catch(console.error); ``` ```go Go theme={null} package main import ( "context" "fmt" "log" "connectrpc.com/connect" "github.com/gitpod-io/gitpod-sdk-go/sdk" gitpodpb "github.com/gitpod-io/gitpod-sdk-go/v1" timestamppb "google.golang.org/protobuf/types/known/timestamppb" ) func main() { ona, err := sdk.NewFromEnv() if err != nil { log.Fatal(err) } request := connect.NewRequest(&gitpodpb.GetCoAuthorSummaryRequest{ DateRange: &gitpodpb.DateRange{ StartTime: ×tamppb.Timestamp{Seconds: 1767225600}, EndTime: ×tamppb.Timestamp{Seconds: 1767225600}, }, }) response, err := ona.Services.Usage.GetCoAuthorSummary(context.Background(), request) if err != nil { log.Fatal(err) } fmt.Println(response.Msg) } ``` ```json Request body theme={null} { "dateRange": { "endTime": "2026-01-01T00:00:00Z", "startTime": "2026-01-01T00:00:00Z" } } ``` ## Request `gitpod.v1.GetCoAuthorSummaryRequest` | Field | Type | Required | Description | | - | - | - | - | | `dateRange` | [DateRange](#type-gitpod-v1-date-range) | Yes | Date range to query within. Constraints: `required=true`. | | `projectId` | string | No | Optional project ID to scope results. | | `userId` | string | No | Optional user ID to scope results to a specific user. Mutually exclusive with team\_id. | | `teamId` | string | No | Optional team ID to scope results to a specific team. Mutually exclusive with user\_id. | ## Response `gitpod.v1.GetCoAuthorSummaryResponse` | Field | Type | Required | Description | | - | - | - | - | | `summary` | [CoAuthorSummary](#type-gitpod-v1-co-author-summary) | No | Summary totals and trends for the requested date range. | | `sparkline` | array of [TimeSeriesPoint](#type-gitpod-v1-time-series-point) | No | Sparkline data for card rendering. | ## Related types > [accordion] CoAuthorSummary > > CoAuthorSummary contains aggregate totals for a date range. > > `gitpod.v1.CoAuthorSummary` > > | Field | Type | Required | Description | > | - | - | - | - | > | `totalCommits` | 64-bit integer string | No | Total number of commits in the date range. | > | `totalLinesAdded` | 64-bit integer string | No | Total lines added across all commits. | > | `totalLinesRemoved` | 64-bit integer string | No | Total lines removed across all commits. | > | `distinctAuthors` | 64-bit integer string | No | Number of distinct authors (by author\_hash). | > | `byTool` | array of [ToolBreakdown](#type-gitpod-v1-tool-breakdown) | No | Per-tool breakdown of contribution stats. | > | `totalCommitsTrend` | number | No | Fractional change in total\_commits compared to the previous period of equal length. Computed as (current - previous) / previous. Zero when there is no previous data. | > | `totalLinesAddedTrend` | number | No | Fractional change in total\_lines\_added compared to the previous period. | > | `totalLinesRemovedTrend` | number | No | Fractional change in total\_lines\_removed compared to the previous period. | > | `distinctAuthorsTrend` | number | No | Fractional change in distinct\_authors compared to the previous period. | > [accordion] DateRange > > DateRange specifies a time period for queries. > > `gitpod.v1.DateRange` > > | Field | Type | Required | Description | > | - | - | - | - | > | `startTime` | RFC 3339 timestamp | Yes | Start time of the date range (inclusive). Constraints: `required=true`. | > | `endTime` | RFC 3339 timestamp | Yes | End time of the date range (exclusive). Constraints: `required=true`. | > [accordion] TimeSeriesPoint > > `gitpod.v1.TimeSeriesPoint` > > | Field | Type | Required | Description | > | - | - | - | - | > | `time` | RFC 3339 timestamp | No | Timestamp for this data point. | > | `value` | integer | No | The numerical value for this data point. | > [accordion] ToolBreakdown > > ToolBreakdown contains stats for a single AI tool (or human). > > `gitpod.v1.ToolBreakdown` > > | Field | Type | Required | Description | > | - | - | - | - | > | `tool` | [CoAuthorTool](#enum-gitpod-v1-co-author-tool) | No | The tool these stats are for. | > | `commits` | 64-bit integer string | No | Number of commits attributed to this tool. | > | `linesAdded` | 64-bit integer string | No | Lines added by this tool. | > | `linesRemoved` | 64-bit integer string | No | Lines removed by this tool. | > | `distinctAuthors` | 64-bit integer string | No | Distinct authors who used this tool. | > [accordion] CoAuthorTool > > CoAuthorTool identifies the AI tool that co-authored a commit. > UNSPECIFIED (0) is the proto default and must not appear in reported data. > Use HUMAN for commits with no AI co-author. > > | Value | Number | Description | > | - | -: | - | > | `CO_AUTHOR_TOOL_UNSPECIFIED` | 0 | | > | `CO_AUTHOR_TOOL_NO_COAUTHOR` | 1 | Commit has no Co-authored-by trailer at all (solo commit). | > | `CO_AUTHOR_TOOL_HUMAN_COAUTHOR` | 2 | Commit has a Co-authored-by trailer, but the co-author is human. | > | `CO_AUTHOR_TOOL_ONA` | 3 | Ona agent. | > | `CO_AUTHOR_TOOL_GITHUB_COPILOT` | 4 | GitHub Copilot. | > | `CO_AUTHOR_TOOL_CURSOR` | 5 | Cursor. | > | `CO_AUTHOR_TOOL_OTHER` | 6 | An AI tool not in the known list. | > | `CO_AUTHOR_TOOL_CLAUDE` | 7 | Claude (Anthropic). | > | `CO_AUTHOR_TOOL_CODEX` | 8 | Codex. | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.