Items

All endpoints are POST with a JSON body, authenticated with your secret key (Authentication). Errors use the standard envelope; money is in major units with an iso_currency_code; dates are YYYY-MM-DD strings.

An item is one user's connection to one institution — the thing an access_token points at. It owns accounts, transactions, and sync cursors.

Get item

curl https://api.feelconnect.dev/v1/items/get \
  -H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"access_token":"fc_at_…"}'

{
  "item": {
    "item_id": "item_7dJ3nWqZ5xC9vK1mTf4g",
    "institution_id": "inst_meridian_trust",
    "institution_name": "Meridian Trust",
    "connector": "sandbox",
    "status": "active",
    "error": null,
    "consented_products": [
      "transactions",
      "balances",
      "recurring"
    ],
    "last_successful_sync": "2026-07-27T06:00:41.000Z"
  }
}

Item status

Remove item

Disconnects the item and invalidates its access token permanently. Emits an item.removed webhook. Remove items when a user disconnects an account or deletes their profile — it is the API form of consent revocation.

curl https://api.feelconnect.dev/v1/items/remove \
  -H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"access_token":"fc_at_…"}'

{
  "removed": true
}

Refresh item

Requests an on-demand data refresh ahead of the normal schedule. Refresh is asynchronous: the call returns immediately and a transactions.sync_updates_available webhook fires when new data is ready.

curl https://api.feelconnect.dev/v1/items/refresh \
  -H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"access_token":"fc_at_…"}'

{
  "refreshing": true
}