---
title: "Add Comparison"
method: POST
path: "/api/comparisons"
tags: ["Comparisons"]
---

# Add Comparison

`POST /api/comparisons`

## Request

- Base URL: `https://data.getplace.io` (the document declares no server; this is the origin it was published from)
- URL: `https://data.getplace.io/api/comparisons`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`

Add a chain to comparison list.

## Request body

- ComparisonCreate
  - `chain_id` integer, required
  - `chain_name` string, required
  - `country_code` string, nullable
  - `entity_type` string
  - `fr_id` integer, nullable

## Response `200`

Successful Response

- ComparisonResponse
  - `id` integer, required
  - `chain_id` integer, required
  - `chain_name` string, required
  - `country_code` string, nullable
  - `entity_type` string, required
  - `fr_id` integer, nullable
  - `city_name` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getplace/apis/getplace-insights-api.md) - [All operations](https://skmtc.dev/getplace/apis/getplace-insights-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getplace/apis/getplace-insights-api/revisions/0f337387603f?raw)