---
title: "Re-read this user's entitlement from the store"
method: POST
path: "/subscription/reconcile"
tags: ["Subscription"]
---

# Re-read this user's entitlement from the store

`POST /subscription/reconcile`

## Request

- Base URL: `https://api.caliuapp.com`
- URL: `https://api.caliuapp.com/subscription/reconcile`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `caliu_session`

Asks the billing provider for the current entitlement and stores it. Used after sign-in when a purchase was made before an account existed. Takes no body: the account is the authenticated caller.

## Response `200`

Entitlement after reconciliation

- object
  - `reconciled` boolean, required
  - `entitlement` object, required
    - `isPro` boolean, required
    - `source` 'grandfathered' | 'app_store' | 'play_store' | 'stripe' | 'promotional' | 'none', required
    - `expiresAt` string, nullable, required
    - `willRenew` boolean, required
    - `plan` 'subscription' | 'lifetime' | 'null', nullable, required: What backs a paid entitlement: a renewing `subscription` or the one-time `lifetime` purchase. Both unlock the same features. `null` when Pro comes from no store purchase.
    - `noteLimit` integer, nullable, required: Free note limit for this account (notes outside the trash), or `null` for unlimited. A client-side guard only: note writes and sync are never rejected by the server.
    - `noteCount` integer, nullable, required: Notes that count toward `noteLimit`, or `null` when `noteLimit` is. The apps count locally; the MCP server reads this to guard `create_note`.

## Other responses

- `401`: Not authenticated
- `429`: Rate limited

## Changes

- **2026-10-19** `1ba4d3f687fe`: 1 info
  - added the required property `entitlement/noteCount` to the response with the `200` status

[Operation history](https://skmtc.dev/caliuapp/apis/caliu-api/changes/subscription/reconcile/post.md)

---

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