---
title: "Start a page claim"
method: POST
path: "/v1/pages/claims"
tags: ["Suite"]
---

# Start a page claim

`POST /v1/pages/claims`

## Request

- Base URL: `https://api.farofinance.app`
- URL: `https://api.farofinance.app/v1/pages/claims`
- Auth: none declared

## Request body

- ClaimIn
  - `identifier` string, required
  - `sector` string, required
  - `display_name` string, nullable
  - `email` string, nullable

## Response `200`

Successful Response

- ClaimOut
  - `claim_id` string, required
  - `entity_id` string, required
  - `identifier` string, required
  - `sector` 'd2c' | 'b2b' | 'marketplace' | 'services' | 'cross_border', required
  - `status` 'pending' | 'control_verified' | 'checked' | 'published' | 'abandoned', required
  - `known_history` boolean
  - `history_summary` string, nullable
  - `proof_mode` string
  - `control_verified` boolean
  - `proof_token` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/farofinance/apis/faro.md) · [All operations](https://skmtc.dev/farofinance/apis/faro/llms.txt) · [OpenAPI document](https://skmtc.dev/farofinance/apis/faro/revisions/205cdf54420b?raw)