---
title: "List competitors"
method: GET
path: "/api/v1/competitors"
tags: ["API v1"]
---

# List competitors

`GET /api/v1/competitors`

## Request

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

List tracked competitors across all projects for the authenticated user, alphabetically, paged with `limit` (1-100, default 100) and `offset`. `pagination.total` is the full count, so a caller pages until offset + data.length reaches it. By default only active competitors are returned; pass include_inactive=true to also include removed (soft-deleted) competitors. A `project_id` that is not one of your projects is a 404 PROJECT_NOT_FOUND.

## Query parameters

- `project_id` string, uuid
- `include_inactive` boolean
- `limit` integer
- `offset` integer

## Response `200`

Default Response

- object
  - `data` object[]
  - `pagination` object
    - `total` integer
    - `limit` integer
    - `offset` integer

## Other responses

- `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)