---
title: "Competitor changes"
method: GET
path: "/api/v1/competitors/{id}/changes"
tags: ["API v1"]
---

# Competitor changes

`GET /api/v1/competitors/{id}/changes`

## Request

- Base URL: `https://api.rivalize.ai`
- URL: `https://api.rivalize.ai/api/v1/competitors/{id}/changes`
- Auth: HTTP bearer

Recent changes for a competitor, filterable by type, priority, and date.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `severity` string
- `type` string
- `min_severity` 'critical' | 'high' | 'medium' | 'low'
- `sort` 'date' | 'significance'
- `since` string
- `limit` string
- `offset` string

## Response `200`

Success. The collection is returned in the `data` envelope.

- object: Success. The collection is returned in the `data` envelope.
  - `data` object[], required

## Other responses

- `400`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).
- `404`: Error. Carries a stable `code`, a human `message`, the HTTP `status`, and the `request_id` (also on the x-request-id response header).

---

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