---
title: "WRITE: record that the traveller actually stood at one of their OWN saved places"
method: POST
path: "/actions/check_in_place"
tags: ["places"]
---

# WRITE: record that the traveller actually stood at one of their OWN saved places

`POST /actions/check_in_place`

## Request

- Base URL: `https://findinghorizons.ca/api/v1`
- URL: `https://findinghorizons.ca/api/v1/actions/check_in_place`
- Auth: OAuth 2 (authorization code, authorization URL `https://findinghorizons.ca/api/mcp/authorize`, token URL `https://findinghorizons.ca/api/mcp/oauth/token`, scopes: `places:write`)

WRITE: record that the traveller actually stood at one of their OWN saved places. Writes the point_visits ledger and recomputes XP / rank / season / badges from it. Same place, same day is a no-op (recorded:false), never a second award. Requires `date` (YYYY-MM-DD) — the server will not guess the traveller's calendar day from its own clock.

## Headers

- `Idempotency-Key` string, required
- `X-FH-Task` string

## Request body

- object
  - `pointId` string, required: Point id from get_my_points / search_my_places
  - `date` string, required: The traveller's calendar date, YYYY-MM-DD
  - `notes` string
  - `rating` number: 1–5
  - `today` string: The traveller's own date, YYYY-MM-DD, where the action needs one
  - `expectedVersion` integer: For a change to a trip: the planVersion you last read

## Response `200`

Done — { ok, api, action, result, card, operation? }

## Other responses

- `202`: Waiting for the traveller's approval in Finding Horizons
- `400`: Bad body / missing Idempotency-Key
- `401`: No or invalid token
- `403`: Scope not granted
- `409`: Conflict: the plan changed since expectedVersion, or the same key is still running
- `422`: The action said no
- `429`: Rate limited

---

[API](https://skmtc.dev/findinghorizons/apis/finding-horizons-api.md) · [All operations](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/llms.txt) · [OpenAPI document](https://skmtc.dev/findinghorizons/apis/finding-horizons-api/revisions/e347f6070173?raw)