> ## Documentation Index
> Fetch the complete documentation index at: https://docs.githits.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHits API

> Code discovery infrastructure for software factories and agents, with evidence for the exact versions your software depends on.

GitHits is code discovery infrastructure for software factories and agents. Use the API to retrieve source code, documentation and dependency evidence for the exact versions your software depends on—including package metadata, vulnerabilities, licenses, changelogs and upgrade evidence.

## Build with the versions you use

Your agents need to understand the libraries your software actually uses. With GitHits, you can inspect a specific package release, read its documentation and source code, and examine its dependency graph. When considering an upgrade, compare your current and target versions using vulnerability information, release notes and source changes.

Returned version information and source references let you trace the evidence behind a generated change or an upgrade decision. Your workflow can keep those references alongside its results for review.

## Connect your workflow

Use the REST API to add GitHits to your applications, automated checks and agent systems. Requests use HTTPS and return JSON. You can call the API from any language with an HTTP client.

| Item           | Value                                                                                               |
| -------------- | --------------------------------------------------------------------------------------------------- |
| API address    | `https://api.githits.dev`                                                                           |
| Path prefix    | `/v1`                                                                                               |
| Authentication | An API token in the `Authorization: Bearer` header                                                  |
| API definition | [OpenAPI JSON](https://api.githits.dev/v1/openapi.json), which describes the requests and responses |

Start with the [API quickstart](/api/quickstart) to inspect an exact package version. Then read [Requests and responses](/api/requests-and-responses) to choose the information returned by `fields`, pass request parameters and interpret results. The endpoint reference lists the inputs and response details for each endpoint.

For an existing AI coding tool, you can also connect GitHits through [MCP](/quickstart). For shell commands, use the [CLI](/cli/commands).

<Note>
  The API is available for evaluation. The v1 contract is not yet finalized. See [versioning](/api/versioning) before building a production integration.
</Note>
