Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/soker90/finper/llms.txt

Use this file to discover all available pages before exploring further.

The Stores API exposes a read-only merchant registry. Stores are never created directly — they are created implicitly whenever a Transaction is posted with a store field that does not already exist for the authenticated user. The store lookup is case- and accent-insensitive (collation es, strength 2), so "amazon" and "Amazon" resolve to the same store.

​
GET /api/stores

List all stores belonging to the authenticated user. 
curl http://localhost:3008/api/stores \
  -H 'token: <your-jwt>'
Response 200 
[
  {
    "_id": "69a1f...",
    "name": "Amazon",
    "user": "alice"
  },
  {
    "_id": "69b2g...",
    "name": "Mercadona",
    "user": "alice"
  }
]
​
_id
string
Unique store identifier.
​
name
string
Store name as originally provided in the first transaction that referenced it.
​
user
string
Username of the owner. Stores are tenant-scoped — each user has their own store list.
Stores are created implicitly when you POST /api/transactions with a new store name. If a transaction references a store name that already exists (case-insensitive match), the existing store is reused and no duplicate is created.

Build docs developers (and LLMs) love

Get started for freeTalk to us