---
title: "All upstream fixes applicable to a version"
method: GET
path: "/api/v1/{distribution}/versions/{version}/upstream-fixes"
tags: ["upstream-fixes"]
---

# All upstream fixes applicable to a version

`GET /api/v1/{distribution}/versions/{version}/upstream-fixes`

## Request

- Base URL: `https://magento.watch`
- URL: `https://magento.watch/api/v1/{distribution}/versions/{version}/upstream-fixes`
- Auth: none required

Community fixes merged upstream whose `affectedVersions` include this release, sorted by `pr.mergedAt` descending. Mage-OS returns `status: "unknown"` until its tags are checked separately.

## Path parameters

- `distribution` 'magento-community' | 'magento-commerce' | 'mage-os', required
- `version` string, required

## Response `200`

All upstream fixes applicable to a version

- UpstreamFixSearchResponse
  - `data` FindUpstreamFixResult, required
    - `status` 'ok' | 'unknown' | 'unknown-version', required
    - `mode` 'list' | 'ranked', required
    - `distribution` string, required
    - `version` string, required
    - `hits` UpstreamFixHit[], required
      - `id` string, required
      - `score` integer
      - `title` string, required
      - `prUrl` string, uri, required
      - `issueUrls` string[], required
      - `fixedIn` string, nullable, required
      - `reportedOn` string, nullable, required
      - `codeMatch` 'clean' | 'conflict' | 'file-missing' | 'error', required
      - `tests` UpstreamFixTests, required: fail to pass: fails before, passes after. not-runnable to pass: test could not run before the patch, passes after (the test references code the patch adds, or its file did not apply to this release). not-runnable to error: test files do not apply to this release. pass to pass: passes before and after (test does not cover the fix), a warning. Other passing before or non-passing after outcomes are warnings retaining the after value. adapted adds (test header adapted).
        - `suites` object: Per-suite outcomes underlying the aggregate runtime result.
          - `unit` object
            - `before` 'fail' | 'pass' | 'not-runnable', required
            - `after` 'pass' | 'fail' | 'error', required
          - `integration` object
            - `before` 'fail' | 'pass' | 'not-runnable', required
            - `after` 'pass' | 'fail' | 'error', required
          - `api-functional` object
            - `before` 'fail' | 'pass' | 'not-runnable', required
            - `after` 'pass' | 'fail' | 'error', required
        - `before` 'fail' | 'pass' | 'not-runnable', required
        - `after` 'pass' | 'fail' | 'error', required: error means the code patch did not apply or the suite could not run after it.
        - `adapted` boolean, required
        - `runAt` string, date-time, required: RFC 3339 timestamp; fractional seconds and numeric offsets or Z are accepted. Stored as UTC Z with millisecond precision.
        - `releaseCommit` string, required
      - `affectedVersions` string[], required
      - `components` string[], required
      - `categories` string[], required
      - `labels` UpstreamFixLabels, required
        - `area` string[], required
        - `component` string[], required
        - `priority` string, nullable, required
        - `severity` string, nullable, required
        - `reportedOn` string[], required
      - `issueKind` 'human' | 'pr-derived', required
      - `excluded` 'test-only-or-non-code' | 'change-kind' | 'feature-request-label' | 'not-bugfix', required: Why the entry is left out of default lists and search. `not-bugfix`: no linked issue is confirmed and Clef triage does not classify the change as a bug fix.
      - `triage` object, nullable
        - `changeKind` string, required
        - `risk` number, required
        - `backportWorthy` number, required
      - `install` UpstreamFixInstall, required
        - `composer` object, required
          - `zipUrl` string, uri, required
      - `matchedOn` string[]
    - `knownVersions` string[]
    - `coverage` object, required
      - `magento2Commit` string, required
      - `tags` integer, required
      - `entries` integer, required
      - `excluded` integer, required
  - `_documentation` string, uri, required
  - `_description` string, required

## Other responses

- `404`: Unknown distribution or version absent from its data file

---

[API](https://skmtc.dev/magento/apis/magento-watch-api.md) · [All operations](https://skmtc.dev/magento/apis/magento-watch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magento/apis/magento-watch-api/revisions/e542302fb8a0?raw)