# Fetch detailed information from an existing diff

**GET /diffs/{id}**

Fetch the result of a previously created diff with the
[`POST /diffs` API endpoint](#operation-post-diffs).



## Servers
- https://bump.sh/api/v1: https://bump.sh/api/v1 ()



## Parameters

#### Path parameters
- **id** (string)
  UUID of an existing diff from which to fetch diff details

#### Query parameters
- **formats** (array[string])
  A list of formats to render in the response. Possible
values are `text`, `markdown`, `html` or `json`. If not
provided defaults to render both `text` and `markdown`
formats.



## Responses
### 200: Diff successfully retrieved

#### Body Parameters: application/json (object)
- **id** (string)
  Unique id of your diff
- **title** (string)
  The title of the last parsed definition
- **public_url** (string)
  The public URL of your diff
- **breaking** (boolean)
  Identifies if the diff includes breaking changes
- **details** (array[object])
  Details of each change as a list of diff items. Present only if `json` format has been requested
- **previous_version_url** (string)
  URL of previous version specification, in JSON format
- **current_version_url** (string)
  URL of current version specification, in JSON format
- **markdown** (string)
  The comparaison diff summary in markdown format. Present only if `markdown` format has been requested.
- **html** (string)
  The comparaison diff summary in HTML format. Present only if `html` format has been requested.
- **text** (string)
  The comparaison diff summary in plain text format. Present only if `text` format has been requested.

### 202: Diff is still being processed. Please try again later

### 404: Diff not found


[Powered by Bump.sh](https://bump.sh)