---
title: "Get recent saved alignments"
method: GET
path: "/v1/catalog/{org_name}/{project}/alignments"
tags: ["Alignments"]
---

# Get recent saved alignments

`GET /v1/catalog/{org_name}/{project}/alignments`

Gets a list of all the saved alignments from the previous three weeks

## Path parameters

- `org_name` string, required
- `project` string, required

## Query parameters

- `branch` string
- `revision` string

## Response `200`

List of saved alignments

- AlignmentFragment[]
  - `alignment_id` string — Unique identifier for the alignment results.
  - `revision` string — Revision of the project that was used for alignment analysis.
  - `finished_at` string, nullable — Time when the alignment finished analyzing release data.
  - `release_count` integer, nullable — Number of releases included in the alignment results.
  - `newly_introduced_count` integer — Number of new issues found since the baseline alignment.
  - `alignment_pct` number, float, nullable — Percentage of releases that are aligned to the catalog's configured standards.
  - `branch` string — Branch name of the project that was used for alignment analysis.
  - `status` 'scheduled' | 'running' | 'complete' | 'error', nullable — Status to indicate if the alignment has finished analyzing or is still running.
  - `result` 'success' | 'failure', nullable — Status of whether all releases are in alignment or not.
  - `error` ScanLog, nullable — Information about a scan problem, if there was one.
    - `code` 'inexact_versions' | 'invalid_version' | 'invalid_packages' — Machine-readable code for the issue.
    - `message` string — Human-readable message about the issue.
    - `details` object — List of details about the issue.
      - `platform` string, nullable — Relevant platform that triggered the issue.
      - `path` string, nullable — Relevant manifest path that triggered the issue.
      - `kind` 'lockfile' | 'manifest', nullable — Relevant manifest kind that triggered the issue.
      - `message` string, nullable — Relevant human-readable message about this detail.
  - `error_code` 'retriable_error' | 'manifest_parse' | 'no_manifests_found' | 'no_packages_found' | 'retries_exhausted' | 'canceling_obsolete_scans' | 'multiple_manifests_same_platform' | 'inexact_versions' | 'marked_failed' | 'invalid_external_identifier' | 'invalid_version' | 'invalid_packages', nullable — Short code to represent an error encountered during analysis.
  - `error_message` string, nullable — A more descriptive summary of any error encountered during analysis.
  - `error_details` string, nullable — String representation of some more metadata of an error encountered during analysis.
  - `warnings` object[], nullable — A list of warnings encountered during the analysis.
    - `code` 'inexact_versions' | 'invalid_version' | 'invalid_packages', nullable — Short code to represent a warning encountered during analysis.
    - `message` string, nullable — A more descriptive summary of any warning encountered during analysis.
    - `details` string, nullable — String representation of some more metadata of a warning encountered during analysis.

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/tidelift/apis/tidelift-external-api.md) · [All operations](https://skmtc.net/tidelift/apis/tidelift-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tidelift/tidelift-external-api/revisions/5f36bed372bb/schema)