> For the complete documentation index, see [llms.txt](https://docs.logilica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logilica.com/integration/connecting-tools/codecov.md).

# Codecov

The Codecov connector imports per-commit coverage data and individual test results into Logilica, so code coverage trends and test reliability sit alongside the rest of your engineering data.

## Authentication

Codecov is a standalone connector authenticated with a Codecov API token. Logilica sends the token as a Bearer credential against the Codecov v2 API (`https://api.codecov.io/api/v2`) and reads coverage for the repository you connect. See [Connecting Tools](/integration/connecting-tools.md) for how to add the token.

Each connection is scoped to a single repository, identified by its version control service (GitHub, GitLab, or Bitbucket), owner, and repository name.

## What's Imported

For each connected repository, Logilica imports two kinds of data:

* **Per-commit coverage** — for every commit, the overall coverage percentage, total lines of code, hits, partials, and misses, the number of files, the branch, the commit state, and whether CI passed. The commit author is recorded as a contributor identity.
* **File-level coverage** — within each commit, per-file coverage, lines of code, hits, partials, and misses, where Codecov has a full report for that commit.
* **Test results** — individual test outcomes (pass, fail, skip, or error), test duration, the test name, the branch, and any failure message. All imported test results are marked as automated.

Coverage and test result pages in Codecov are linked back to the Codecov app so you can open the original report.

## Test Outcomes

Test outcomes are shown in a consistent category:

| Codecov outcome                      | Logilica category |
| ------------------------------------ | ----------------- |
| `pass`, `passed`, `success`          | Pass              |
| `fail`, `failed`, `failure`, `error` | Failure           |
| `skip`, `skipped`                    | Skipped           |
| anything else                        | Unknown           |

## Good to Know

* **Kept in sync automatically.** After the initial import, Logilica refreshes this connection on a regular schedule — you don't need to re-trigger imports.
* **First import covers the last 6 months.** The initial scan imports commit coverage from the last 6 months, paging back through history until it reaches that window. Later scans pick up data added since the previous import. Importing older history requires a configuration change by Logilica — contact support.
* **Coverage is only as complete as Codecov's report.** If Codecov has no full report for a commit (for example, an incomplete or in-progress upload), that commit is imported with its overall totals but without file-level breakdown.
* **One repository per connection.** A connection covers a single repository. Connect each repository whose coverage you want in Logilica.
* **Test results are dated from their commit.** A test result whose commit falls outside the import window is not imported.