PocketSmith

```json
{
  "service_type": "platform",
  "base_url": "https://api.pocketsmith.com",
  "auth_method": "oauth2_and_api_key",
  "auth_config": {
    "api_key": {
      "location": "query_param_or_header",
      "param_name": "api_key",
      "header_name": "X-Api-Key",
      "notes": "Developer keys are generated in the user's PocketSmith account under Settings > Security > Developer. Two key types exist: 'developer' (per-user, permanent) and 'oauth' keys obtainable via the OAuth2 flow."
    },
    "oauth2": {
      "authorization_url": "https://pocketsmith.com/oauth/authorize",
      "token_url": "https://api.pocketsmith.com/v2/oauth/token",
      "flows": ["authorization_code", "refresh_token"],
      "notes": "OAuth2 for third-party apps acting on behalf of users."
    }
  },
  "endpoints": [
    {
      "path": "/v2/me",
      "method": "GET",
      "description": "Get the currently authenticated user"
    },
    {
      "path": "/v2/users/{id}",
      "method": "GET",
      "description": "Get a user by ID"
    },
    {
      "path": "/v2/users/{id}/accounts",
      "method": "GET",
      "description": "List all accounts for a user"
    },
    {
      "path": "/v2/accounts/{id}",
      "method": "GET",
      "description": "Get a single account"
    },
    {
      "path": "/v2/accounts/{id}/transactions",
      "method": "GET",
      "description": "List transactions for an account"
    },
    {
      "path": "/v2/accounts/{id}/transactions",
      "method": "POST",
      "description": "Create a transaction in an account"
    },
    {
      "path": "/v2/transactions/{id}",
      "method": "PUT",
      "description": "Update a transaction"
    },
    {
      "path": "/v2/transactions/{id}",
      "method": "DELETE",
      "description": "Delete a transaction"
    },
    {
      "path": "/v2/transactions/{id}/attachments",
      "method": "GET",
      "description": "List attachments for a transaction"
    },
    {
      "path": "/v2/users/{id}/categories",
      "method": "GET",
      "description": "List categories for a user"
    },
    {
      "path": "/v2/users/{id}/category_rules",
      "method": "GET",
      "description": "List category rules"
    },
    {
      "path": "/v2/users/{id}/transaction_accounts",
      "method": "GET",
      "description": "List transaction accounts"
    },
    {
      "path": "/v2/users/{id}/budget",
      "method": "GET",
      "description": "Get budget summary data"
    },
    {
      "path": "/v2/users/{id}/event",
      "method": "GET",
      "description": "List events (calendar-based forecasting)"
    },
    {
      "path": "/v2/users/{id}/institutions",
      "method": "GET",
      "description": "List financial institutions associated with the user"
    },
    {
      "path": "/v2/currencies",
      "method": "GET",
      "description": "List available currencies"
    },
    {
      "path": "/v2/time_zones",
      "method": "GET",
      "description": "List supported time zones"
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "notes": "PocketSmith offers a free tier with limited features and paid subscription plans (e.g., Foundation, Flourish, Fortune) with increasing feature limits. API access is available to users; usage of your own data via the API is generally available across tiers, but some automation and banking feed features are restricted by tier.",
      "api_cost": "No separate API fee; access included with account."
    }
  },
  "rate_limits": {
    "notes": "PocketSmith documents API rate limiting but specific numeric values are not publicly and consistently published. The API returns HTTP 429 on throttling. Reasonable request volumes are expected for typical personal-finance integrations.",
    "status_code_on_limit": 429
  },
  "capabilities": [
    "Personal finance and budgeting platform",
    "Aggregation of bank/institution transaction data (bank feeds)",
    "Transaction management: create, read, update, delete",
    "Category management and automatic category rules",
    "Budgeting and forecasting (events/calendar-based projections)",
    "Multi-currency support",
    "Transaction attachments",
    "REST JSON API (v2) with developer API keys and full OAuth2",
    "Account and institution metadata access",
    "Read/write access to financial data for automation and third-party apps"
  ],
  "raw_analysis": "PocketSmith is a personal finance and budgeting SaaS platform (New Zealand-based) that aggregates a user's bank and financial accounts, presents transactions in a budgeting/forecasting interface, and exposes a documented REST API (v2) so users and third-party developers can read and manipulate that financial data programmatically. Its primary audience is individual consumers doing personal budgeting and forecasting, with secondary appeal to developers building personal-finance automations or integrations.\n\nMaturity and integrations: PocketSmith is a long-established, mature product in the personal-finan

1/3 tests passed

{
  "overall": 62,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 6.0,
    "response_parseability": 7.0,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 5.0,
    "latency": 9.0,
    "consistency": 6.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "api_cost": "No separate API fee; access included with account",
    "notes": "Free tier limited; paid tiers (Foundation, Flourish, Fortune) gate some automation and bank feed features. No dedicated API pricing."
  },
  "issues": [
    "No llms.txt found (404) — reduces agent discoverability of a machine-readable surface.",
    "Root homepage returned 404 in the uptime check, which may signal an unexpected routing state or a scrape issue.",
    "OAuth2/full-token flow adds onboarding friction versus simpler auth; getting productive for an agent isn't instantaneous.",
    "Feature gating by subscription tier makes behavior/capabilities ambiguous for agents unless the user's plan is known.",
    "No status page or explicit uptime/rate-limit signals observed in the check results."
  ],
  "recommendations": [
    "Publish an llms.txt and/or a concise API overview page to boot agent discovery and token-efficient summarization.",
    "Verify the homepage routing/404 behavior; ensure 200s on canonical entry points to project reliability.",
    "Provide a clear rate-limit and error-code reference to improve error_clarity and first_try_success.",
    "Document plan-tier gating in one table so agents can state capability scope without trial-and-error.",
    "Expose a status/health endpoint to support consistency judgments.",
    "Consider a magic-link or streamlined token flow to simplify auth for agent onboarding."
  ]
}