{"content":[{"text":"total 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Sep 19 07:40 ..\ndrwxr-xr-x 8 root root 4096 Sep 18 08:00 .git\n-rw-r--r-- 1 root root  408 Sep 18 08:00 .gitignore\n","type":"text"}]}

{"content":[{"text":"PI_CODING_AGENT=<redacted>\nPI_REASONING_LEVEL=<redacted>\nPI_SESSION_FILE=<redacted>\nPI_PROVIDER=<redacted>\nPI_MODEL=<redacted>\nPI_SESSION_ID=<redacted>\nPI_GATEWAY_API_KEY=<redacted>\nGIT_CONFIG_KEY_0=<redacted>\n","type":"text"}]}

{"content":[{"text":"# Keep generated and vendored files out of source diffs.\n\n# Logs / OS cruft\n*.log\n.DS_Store\n\n# JavaScript / TypeScript\nnode_modules/\n.next/\ndist/\nbuild/\ncoverage/\n\n# Python\n.venv/\nvenv/\n__pycache__/\n*.py[cod]\n.pytest_cache/\n*.egg-info/\n\n# Rust\ntarget/\n\n# Go / PHP / Ruby vendored deps\nvendor/\n.bundle/\n\n# Java / Kotlin / Scala\n.gradle/\n\n# .NET\nbin/\nobj/\n\n# Elixir\n_build/\ndeps/\n\n# Dart / Flutter\n.dart_tool/\n9ebf5fb Initial workspace\n","type":"text"}]}

timeout 20 curl -sS "https://registry.npmjs.org/-/v1/search?text=puzzle&size=20" | python3 -c "
import json,sys
d=json.load(sys.stdin)
for o in d['objects']:
    p=o['package']
    print(p['name'], '|', p['version'], '|', p.get('description','')[:90])
" 2>&1 | head -30

{"content":[{"text":"crypto-puzzle | 5.0.3 | A time-lock puzzle generator\npuzzle | 0.0.1 | c++ wrapper for libpuzzle\nvue3-puzzle-vcode | 1.1.7 | **DEMO**: https://isluo.com/work/vue-puzzle-vcode/\n@puzzleitc/puzzle-shell | 5.1.3 | The standard design for Puzzle tools\nsudoku-gen | 1.0.3 | Sudoku puzzle generator\n15-puzzle | 6.2.3 | A simple 15 puzzle library\n@magmacrunch/adenosine-puzzle | 0.4.0 | Sliding tile puzzle framework — grid engine, input, rendering, scoring\n@thenewestera/puzzle-ng | 1.0.19 | OpenAPI client for @thenewestera/puzzle-ng\nmbt-puzzle-preview-lb | 1.0.2011-beta-1 | `puzzle-view` is the source package for `mbt-puzzle-preview-lb`. It exports the core puzzl\nlogic-puzzle-generator | 1.4.1 | A headless, TypeScript-based Logic Grid Puzzle Engine.\npuzzle-lib | 1.8.1 | Library of puzzle-solving algorithms\n@puzzlehq/types | 1.0.34 | Puzzle <3 Typescript\n@blex41/word-search | 1.2.0 | Word search puzzle generator\n@some-ui/some-hexagon | 0.0.9 | WebAssembly game engine for the Some Hexagon puzzle game.\n@class100/puzzle-libs | 0.3.0-beta.87 | ``` import {TestPaper, TypeEnum} from '@class100/puzzle-libs' import '@class100/puzzle-lib\n@magic-spells/puzzle-pieces | 0.7.0 | Copy-in UI component registry for the Puzzle framework. Fetched by `puzzle add piece` — ne\nreact-puzzle-captcha | 1.0.2 | Puzzle Slider - Slide verification component based on react\n@hongtangyun/puzzle-libs | 0.2.12 | ``` import {TestPaper, TypeEnum} from '@hongtangyun/puzzle-libs' import '@hongtangyun/puzz\njigsawpuzzlegame | 1.0.16 | A class for creating a jigsaw puzzle\ndsh-puzzle | 0.0.1 | Puzzle corner for dsh - name reserved; first release in development.\n","type":"text"}]}

for u in https://puzzle.io https://www.puzzle.io https://docs.puzzle.io https://api.puzzle.io https://puzzle.dev; do echo "== $u"; timeout 12 curl -sS -o /dev/null -w "%{http_code} %{redirect_url}\n" "$u" 2>&1; done

{"content":[{"text":"== https://puzzle.io\n200 \n== https://www.puzzle.io\n301 https://puzzle.io/\n== https://docs.puzzle.io\ncurl: (6) Could not resolve host: docs.puzzle.io\n000 \n== https://api.puzzle.io\n307 https://app.puzzle.io/api/login?next=%2F\n== https://puzzle.dev\n200 \n","type":"text"}]}

timeout 15 curl -sSL https://puzzle.dev 2>/dev/null | python3 -c "
import sys,re,html
t=sys.stdin.read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S)
t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>',' ',t)
print(html.unescape(re.sub(r'\s+',' ',t))[:1500])
"

timeout 15 curl -sSL https://puzzle.io 2>/dev/null | python3 -c "
import sys,re,html
t=sys.stdin.read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S)
t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>',' ',t)
print(html.unescape(re.sub(r'\s+',' ',t))[:2000])
"

{"content":[{"text":" Puzzle AI Native Accounting Software & Startup Accounting Services Puzzle 2.0 is here. Our software, plus a vetted firm to close your books. See our new services and pricing → Puzzle 2.0: software plus a real firm Resources Get Support Resources Puzzle Launches AI Suite, Betting on Accountants in the Age of AI Find accounting services Help center Contact support Security Blog & news Customer stories Partner rewards Time saving calculator Companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Accounting Firms Puzzle for Firms Scale revenue without scaling headcount Puzzle for Accountants AI-powered, accountant designed AI Field Guide for Accounting Firms Two questions to ask to every AI vendor Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Resources Get Support Resources Puzzle Launches AI Suite, Betting on Accountants in the Age of AI Find accounting services Help center Contact support Security Blog & news Customer stories Partner rewards Time saving calculator PRODUCT Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy\n","type":"text"}]}

timeout 20 curl -sSL https://puzzle.io/pricing 2>/dev/null | python3 -c "
import sys,re,html
t=sys.stdin.read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S); t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>',' ',t); print(html.unescape(re.sub(r'\s+',' ',t))[:3000])
"

{"content":[{"text":" Puzzle Pricing - Accounting Software & Services for Startups 50% faster month-end close — or your money back Puzzle customers who fully onboard and connect supported integrations can reduce the time required to complete their monthly close by 50% or more compared to QuickBooks or similar general ledger software. If you do not experience at least a 50% reduction in your month-end close time within your first 60 days, we will refund your Puzzle subscription fees. Guarantee eligibility requirements: ‍ ‍ To qualify, customers must: • Complete Puzzle onboarding and setup call within 7 days of subscription start • Connect all primary financial data sources using supported live API integrations, including bank accounts, credit cards, payroll, invoicing, and payment processors • Use Puzzle as the primary general ledger for at least one full monthly close cycle • Categorize transactions, reconcile all connected accounts, and use Puzzle’s tranaction, vendor AI Month-End Close Accuracy reviews • For single-entity accounting structures only • Not rely on CSV uploads, PDF uploads, or unsupported integrations ‍ ‍ Measurement of time savings ‍ ‍ Month-end close time is defined as the total time required to categorize transactions, reconcile accounts, and complete the accuracy review necessary to finalize financial statements. Time savings are measured based on customer-reported comparisons between their prior general ledger software and Puzzle. ‍ ‍ Refund terms ‍ ‍ If you do not experience at least a 50% reduction in month-end close time in your second month close, you may request a refund of your Puzzle subscription fees within 30 days (up to 90 days from original subscription date). Refunds apply only to Puzzle subscription fees and exclude third-party fees, implementation fees, taxes, and pass-through costs. Resources Get Support Resources Puzzle Launches AI Suite, Betting on Accountants in the Age of AI Find accounting services Help center Contact support Security Blog & news Customer stories Partner rewards Time saving calculator Companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Accounting Firms Puzzle for Firms Scale revenue without scaling headcount Puzzle for Accountants AI-powered, accountant designed AI Field Guide for Accounting Firms Two questions to ask to every AI vendor Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Companies Pu\n","type":"text"}]}

for u in https://puzzle.io/api https://developers.puzzle.io https://docs.puzzle.io/api https://api.puzzle.io/docs https://puzzle.io/docs; do echo "== $u"; timeout 12 curl -sSL -o /dev/null -w "%{http_code} %{url_effective}\n" "$u" 2>&1; done

{"content":[{"text":"== https://puzzle.io/api\n200 https://puzzle.io/api\n== https://developers.puzzle.io\ncurl: (6) Could not resolve host: developers.puzzle.io\n000 https://developers.puzzle.io/\n== https://docs.puzzle.io/api\ncurl: (6) Could not resolve host: docs.puzzle.io\n000 https://docs.puzzle.io/api\n== https://api.puzzle.io/docs\n500 https://app.puzzle.io/api/login?next=%2Fdocs\n== https://puzzle.io/docs\n404 https://puzzle.io/docs\n","type":"text"}]}

timeout 20 curl -sSL https://puzzle.io/api 2>/dev/null | python3 -c "
import sys,re,html
t=sys.stdin.read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S); t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>',' ',t); print(html.unescape(re.sub(r'\s+',' ',t))[:4000])
"

{"content":[{"text":" API | Puzzle Resources Get Support Resources Puzzle Launches AI Suite, Betting on Accountants in the Age of AI Find accounting services Help center Contact support Security Blog & news Customer stories Partner rewards Time saving calculator Companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Accounting Firms Puzzle for Firms Scale revenue without scaling headcount Puzzle for Accountants AI-powered, accountant designed AI Field Guide for Accounting Firms Two questions to ask to every AI vendor Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Product Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit Companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Resources Get Support Resources Puzzle Launches AI Suite, Betting on Accountants in the Age of AI Find accounting services Help center Contact support Security Blog & news Customer stories Partner rewards Time saving calculator PRODUCT Accrual Automation Prepaid expenses, fixed assets and more Invoicing Send, track, and reconcile invoices Integrations Stripe, Mercury, Ramp, Brex, Gusto & more Revenue Recognition Cash and accrual revenue, automated API / MCP Build on Puzzle's agent-native architecture Accuracy AI Accuracy you can audit companies Puzzle for Startups Know your numbers every day Puzzle for SMBs Real-time, accurate books Accounting Partners Puzzle vs QuickBooks Pricing Resources Get support Find accounting services Help center Security Resources Blog & news Customer stories Partner rewards Already have an account? Sign in Book a demo Book a demo Try for free Sign in Transform your product with real-time AI-powered accounting inside With Puzzle’s Embedded Accounting—powered by our API, your platform gets automated AI bookkeeping, real-time financial insights, and a clean data foundation built to scale Request API Access Explore Documentation Become a Partner Note: Puzzle Embedded Accounting is for tech platforms and accounting firms serving multiple customers. Individual companies, please join our waitlist. Join hundreds of forward-thinking firms differentiating their practice with Puzzle Joint customers love our integrations. Bekah Fields Operations Engineer at Finfuego. “Brex and Puzzle’s one-click integration has taken a big load off our backs and frees us up to do more important work,” Bekah shared. “It was perfectly seamless, very helpful –I would recommend it to any founder” Maggie Isaac Operations Engineer at Finfuego. \"People in this industry work crazy hours. You don't need to. The right tools can give you some of your life back.\" Aaron Ressel Operations Engineer at Finfuego. \"People in this industry work crazy hours. You don't need to. The right tools can give you some of your life back.\" Maggie Isaac Operations Engineer at Finfuego. \"People in this industry work crazy hours. You don't need to. The right tools can give you some of your life back.\" Sharad Singh Operations Engineer at Finfuego. \"Puzzle saved time and days by removing the need to ask the client to review categorizations, help us understand what was missing, and then make those corrections in the accounting software.\" Susan Wozena Operations Engineer at Finfuego. \"To sort through 1,200 Stripe transactions in QuickBooks would have been a nightmare. With Puzzle, it just does it. We can actually integrate, so we've got all that detail in there. It's a huge time savings.\" Tobias Müller Operations En\n","type":"text"}]}

timeout 20 curl -sSL https://puzzle.io/pricing 2>/dev/null > /tmp/pricing.html; python3 - <<'EOF'
import re,html
t=open('/tmp/pricing.html').read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S); t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>','|',t); t=html.unescape(re.sub(r'[|\s]+',' ',t))
# find price mentions
for m in re.finditer(r'.{120}\$\d[\d,]*.{120}', t):
    print(m.group(0),'\n---')
EOF

{"content":[{"text":"the categorizing, reconciling, and drafting. You review and approve. Monthly Yearly · Save 20% Starter Your first books $30 /mo Try for Free AI Suite Included Chat Cowork Close 25 lifetime AI credits Seats 1 Starter includes: Up to 98% auto-ca \n---\nooks Unlimited connections 1-click tax report CPA-approved Chart of Accounts templates Core Your QuickBooks replacement $72 /mo Try for Free AI Suite Included Chat Cowork Close 25 lifetime AI credits Seats 5 Everything in Starter, plus Insight \n---\n Multi-entity (via Integration) Advanced reporting Custom chart of accounts Complete Most popular Your business upgrade $120 /mo Try for Free AI Suite Included Chat Cowork Close 100 AI credits / month Seats Unlimited Everything in Core, plus AI \n---\nts Revenue recognition Priority support Integrates with Stripe, Ramp, Mercury, Brex & more Scale High volume accounting $360 /mo Try for Free AI Suite Included Chat Cowork Close 300 AI credits / month Seats Unlimited Everything in Complete, plu \n---\n of your Puzzle subscription. Choose your software plan and your monthly expenses below. Choose your Puzzle plan Core — $72/Mo Complete — $120/Mo Core is only available for Up to $10K / mo in expenses. Monthly expenses Up to $10K Move the slid \n---\nvery month. For straightforward companies that want closed books without paying for a full-time bookkeeper's attention. $171 /mo For Up to $10K / mo in expenses · Includes software + service Talk to us Book a demo Core includes AI Suite Include \n---\nh Eligibility Expert Reviewed is designed for straightforward businesses that meet all of the following criteria. Up to $10K in monthly expenses One entity and one accounting basis No payroll processing, accounts payable/receivable, or invento \n---\ny email Month-end summary Add-ons One-off work, priced up front Available with an active Puzzle subscription. Migration $149 We move your books into Puzzle for you, from QuickBooks, Xero or whatever you use today. Your history comes with you an \n---\ny back. We prepare the study that claims it and hand your accountant everything they need to file. A company that spent $500,000 on R&D pays $7,500. Catch-up bookkeeping From $300 /mo of books We review, clean up and close every month you never fin \n---\n. Tax Filing From $1,250 /yr A partner firm prepares and files your return. The price depends on your entity type, plus $250 for each state you file in. Not sure which side you're on? Tell us your expense volume and entity setup. We'll tell you \n---\n who runs your entire close — accruals, reconciliations, and regular calls included. Expert Reviewed is available up to $10K in monthly expenses. Can I purchase accounting services without a Puzzle subscription? No. Expert Reviewed, Full Servi \n---\n choices. The selector sets your software; the expense slider sets your service. What add-ons are available? Migration ($149 one-time — white-glove QuickBooks migration), R&D Study (1.5% of qualified research expenses), Catch-up bookkeeping ($3 \n---\n","type":"text"}]}

{"content":[{"text":"href=\"/accounting-partners\"\nhref=\"/api-mcp\"\nhref=\"/partner-rewards\"\nhref=\"https://fonts.googleapis.com\"\nhref=\"https://puzzle-api.readme.io/docs/welcome\"\nhref=\"https://puzzle.io/api\"\nhref=\"https://ramp.com/partner-profiles/parallel-story\"\nhref=\"mailto:api@puzzle.io\"\n","type":"text"}]}

timeout 12 curl -sS -o /dev/null -w "%{http_code}\n" https://puzzlehq.com 2>&1; timeout 15 curl -sS "https://registry.npmjs.org/-/v1/search?text=puzzlehq&size=10" | python3 -c "
import json,sys
for o in json.load(sys.stdin)['objects']:
    p=o['package']; print(p['name'],'|',p['version'],'|',p.get('description','')[:80])
"

{"content":[{"text":"@puzzlehq/sdk-core | 1.0.4 | Your portal to privacy\n@puzzlehq/types | 1.0.34 | Puzzle <3 Typescript\n@puzzlehq/sdk | 1.0.4 | Your portal to privacy\n@puzzlehq/aleo-wasm-web | 0.10.0 | Aleo SDK WASM\n@puzzlehq/wasm | 0.7.0 | Wasm build for the SDK\n@puzzlehq/walletconnect-core | 2.14.1 | Core for WalletConnect Protocol\n@puzzlehq/walletconnect-modal | 0.0.9 | #### 🔎 [Examples](https://github.com/WalletConnect/web3modal-examples)\n@puzzlehq/walletconnect-modal-ui | 0.0.9 | #### 🔎 [Examples](https://github.com/WalletConnect/web3modal-examples)\n@puzzlehq/walletconnect-jsonrpc-provider | 0.0.1 | Provider for JSON-RPC\n@puzzlehq/sdk-react | 0.2.23 | Your portal to privacy\n","type":"text"}]}

timeout 20 curl -sSL https://puzzle-api.readme.io/docs/welcome 2>/dev/null | python3 -c "
import sys,re,html
t=sys.stdin.read()
t=re.sub(r'<script.*?</script>','',t,flags=re.S); t=re.sub(r'<style.*?</style>','',t,flags=re.S)
t=re.sub(r'<[^>]+>',' ',t); print(html.unescape(re.sub(r'\s+',' ',t))[:4000])
"

{"content":[{"text":" Welcome For AI agents: visit https://puzzle-api.readme.io/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI. Append .md to any documentation page URL to get its markdown version. Jump to Content Guides API Reference v1.0 Log In Guides Log In v1.0 Guides API Reference Welcome INTRODUCTION Welcome What is Puzzle? Embedding Puzzle Use Cases Scopes Getting Started Errors GUIDES One-Click Onboarding One-Click Onboarding w/ Journal Entry Synch Bookkeeping Accounts Payable Accounts Receivable Payroll Transactions Account Balances Powered by Welcome Welcome to the Puzzle Accounting API The Puzzle Accounting API gives you secure, real-time access to your company’s financial data — so you can automate bookkeeping, power insightful dashboards, and build connected financial experiences without the busywork. Whether you’re a founder tracking burn and runway, a developer building integrations, or an accounting team automating workflows, the Puzzle API makes modern accounting data accessible and developer-friendly. Build with Confidence The Puzzle API extends the full power of the Puzzle platform — giving you programmatic access to the same reliable data that drives your books, metrics, and insights. You can use the API to: Retrieve transactions, accounts, and journal entries Generate financial statements or reports in real time Automate categorization, reconciliation, or data syncs Embed accounting data directly into your product or internal dashboards Each request is RESTful , secured with API key authentication , and returns clean, structured JSON so you can focus on building — not parsing data. Secure, Transparent, and Audit-Ready Every request to the Puzzle API is encrypted and logged for full traceability. The underlying ledger is append-only , ensuring every change is trackable, auditable, and compliant. SOC 2–compliant. Immutable ledger. Audit-ready by design. Puzzle was built for modern finance and engineering teams who expect reliability, visibility, and trust from their financial data. Updated 10 months ago What is Puzzle? Did this page help you? Yes No Copy Page Welcome to the Puzzle Accounting API Build with Confidence Secure, Transparent, and Audit-Ready \n","type":"text"}]}

timeout 20 curl -sSL https://puzzle-api.readme.io/openapi 2>/dev/null | head -c 300; echo; timeout 20 curl -sSL -o /dev/null -w "%{http_code} %{url_effective}\n" https://puzzle-api.readme.io/reference 2>&1; timeout 20 curl -sSL https://puzzle-api.readme.io/docs/welcome 2>/dev/null | grep -oE 'href="/[^"]+"' | sort -u | head -40

{"content":[{"text":"<!DOCTYPE html><html lang=\"en\" style=\"\" data-color-mode=\"system\" class=\" useReactApp  \"><head><meta charset=\"utf-8\"><link rel=\"preconnect\" href=\"https://cdn.readme.io\"><link rel=\"preconnect\" href=\"https://cdn.readme.io\" crossorigin><meta name=\"readme-deploy\" content=\"5.894.1\"><meta name=\"readme-subd\n200 https://puzzle-api.readme.io/reference/createclassification\nhref=\"/docs\"\nhref=\"/docs/account-balances-in-puzzle\"\nhref=\"/docs/accounts-payable\"\nhref=\"/docs/accounts-receivable\"\nhref=\"/docs/bookkeeping\"\nhref=\"/docs/copy-of-one-click-onboarding-w-journal-entry-synch\"\nhref=\"/docs/embedding-puzzle\"\nhref=\"/docs/errors\"\nhref=\"/docs/getting-started\"\nhref=\"/docs/one-click-onboarding\"\nhref=\"/docs/payroll\"\nhref=\"/docs/scopes\"\nhref=\"/docs/transactions\"\nhref=\"/docs/use-cases\"\nhref=\"/docs/welcome\"\nhref=\"/docs/what-is-puzzle\"\nhref=\"/login?redirect_uri=/docs/welcome\"\nhref=\"/reference\"\n","type":"text"}]}

{"content":[{"text":"---\nupdatedAt: 2025-11-10T18:53:23.000Z\n---\n\nFetch the complete documentation index at: https://puzzle-api.readme.io/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.\n\n# Getting Started\n\n<br />\n\nOur API is currently under development. We will be continually adding new features and endpoints. You can expect that what is currently documented here and released will remain stable for the indefinite future. We will work with you on any potential changes to assure a smooth transition.\n\n**Sandbox Server:** `https://staging.southparkdata.com`\\\n**Production Server:** `https://api.puzzle.io`\n\n## Get your credentials\n\nRequest your sandbox credentials by emailing us at <api@puzzle.io> or contacting your point of contact at Puzzle directly. You will need to provide us with a list of valid redirect URIs and we will provide you with a client ID, a client secret, and a key.\n\n**Example**\n\n```env\nPUZZLE_CLIENT_ID=cid_test_123\nPUZZLE_CLIENT_SECRET=sk_test_123\nPUZZLE_CONNECTION_KEY=acme\n```\n\n<br />\n\nThe client ID and client secret will be used for authentication and the connection key will be used for building URLs that your users can use to manage their Puzzle account.\n\n## Authentication\n\nAuthentication with our API is done using [OAuth2](https://oauth.net/2/).\n\n> We are encouraging partners to use the OAuth flow moving forward, but if you are an existing partner and you are already set up to use the link token flow, you can find the link token flow instructions [here](../reference/Accounting.yaml/paths/~1linkToken/post).\n\n### Outline of the flow\n\n1. The user is directed to the Puzzle authorize URL.\n2. The user authorizes your application and grants access to one of their companies.\n3. The user is redirected to your application with an authorization code.\n4. Your application exchanges the authorization code for an access token and refresh token pair.\n5. Your application makes requests using that access token.\n6. Your application uses the refresh token to obtain fresh access tokens.\n\n### Direct the user to connect their Puzzle account\n\nThe first step is to have the user authorize your application to access their Puzzle information. To do this, you'll create a link to Puzzle where they approve access.\n\n```html\n<a\n  href=\"https://staging.southparkdata.com/oauth/authorize\n    ?client_id={{PUZZLE_CLIENT_ID}}\n    &redirect_uri=https://example.com/callback\n    &response_type=code\n    &state=a8e6a88f137b4b1a921155c8157907f3\"\n>\n  Connect your Puzzle account\n</a>\n```\n\n> Additional information on the parameters can be found [here](../reference/Authentication.yaml/paths/~1authorize/get).\n\nThe user will be redirected to Puzzle where they can log in to their account (or create a new account) and authorize the integration with your application for one of their companies.\n\nAfter accepting, the user will be redirected to the `redirect_uri` with a `code` and the original `state` value in the query params.\n\n```text\nhttps://example.com/callback?code=123456&state=a8e6a88f137b4b1a921155c8157907f3\n```\n\nYou will need to verify that the provided `state` value matches the original `state` that your application sent and you will use the provided `code` value to get an access token and refresh token pair.\n\n### Get an access token on behalf of the user\n\nNext, your application will request an access token from the Puzzle API using the `code` from the previous step.\n\n<br />\n\n```http\nPOST https://staging.southparkdata.com/oauth/token\nContent-Type: application/json\n\n{\n  \"client_id\": \"{{PUZZLE_CLIENT_ID}}\",\n  \"client_secret\": \"{{PUZZLE_CLIENT_SECRET}}\",\n  \"redirect_uri\": \"https://example.com/callback\",\n  \"code\": \"123456\",\n  \"grant_type\": \"authorization_code\"\n}\n```\n\n<br />\n\n**Response**\n\n```json\n{\n  \"access_token\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c\",\n  \"refresh_token\": \"3aecd59e7834be2c637a9ee260f24wIAbJunx6Gy\",\n  \"scope\": \"read:company offline_access\",\n  \"expires_in\": 86400,\n  \"token_type\": \"Bearer\"\n}\n```\n\n> Include the access token in the `Authorization` HTTP header with every call to the Accounting API.\n\n### Refresh an expired access token\n\nAccess tokens expire 24 hours after they have been issued, so you will need to call the `/token` endpoint again but this time using your refresh token instead of a code.\n\n```http\nPOST https://staging.southparkdata.com/oauth/token\nContent-Type: application/json\n\n{\n  \"client_id\": \"{{PUZZLE_CLIENT_ID}}\",\n  \"client_secret\": \"{{PUZZLE_CLIENT_SECRET}}\",\n","type":"text"}]}

{"content":[{"text":"# Puzzle API Documentation\n\n> Documentation for Puzzle API\n\nAppend .md to any documentation page URL to get its markdown version.\n\n## Guides\n- [Welcome](https://puzzle-api.readme.io/docs/welcome.md)\n- [What is Puzzle?](https://puzzle-api.readme.io/docs/what-is-puzzle.md)\n- [Embedding Puzzle](https://puzzle-api.readme.io/docs/embedding-puzzle.md)\n- [Use Cases](https://puzzle-api.readme.io/docs/use-cases.md)\n- [Scopes](https://puzzle-api.readme.io/docs/scopes.md)\n- [Getting Started](https://puzzle-api.readme.io/docs/getting-started.md)\n- [Errors](https://puzzle-api.readme.io/docs/errors.md)\n- [One-Click Onboarding](https://puzzle-api.readme.io/docs/one-click-onboarding.md)\n- [One-Click Onboarding w/ Journal Entry Synch](https://puzzle-api.readme.io/docs/copy-of-one-click-onboarding-w-journal-entry-synch.md)\n- [Bookkeeping](https://puzzle-api.readme.io/docs/bookkeeping.md)\n- [Accounts Payable](https://puzzle-api.readme.io/docs/accounts-payable.md)\n- [Accounts Receivable](https://puzzle-api.readme.io/docs/accounts-receivable.md)\n- [Payroll](https://puzzle-api.readme.io/docs/payroll.md)\n- [Transactions](https://puzzle-api.readme.io/docs/transactions.md)\n- [Account Balances](https://puzzle-api.readme.io/docs/account-balances-in-puzzle.md)\n\n## API Reference\n- [Create Classifications](https://puzzle-api.readme.io/reference/createclassification.md): Creates a classification.  Requires scope: write:classification\n- [Get Company](https://puzzle-api.readme.io/reference/company-1.md)\n- [Disconnect Company](https://puzzle-api.readme.io/reference/disconnect.md)\n- [Initiate Creating a Company](https://puzzle-api.readme.io/reference/createcompanyapi.md): Call this endpoint to pass some company information that is usually asked for during Puzzle's onboarding flow. A URL will be returned. When you redirect your user to this URL, the company information that was passed the original request will be prefilled for them in Puzzle's UI, allowing them to skip a few steps and create their Puzzle account more quickly.\n- [Get companies](https://puzzle-api.readme.io/reference/companiesapi.md): Returns a list of companies the calling user has access to.  Required scope: read:company\n- [Create Integration Connection](https://puzzle-api.readme.io/reference/createintegrationconnection.md): Creates an integration connection for the company that you can use to push data into Puzzle.  Required scope: write:integration_connection\n- [Get Chart of Accounts](https://puzzle-api.readme.io/reference/chartofaccounts.md): Retrieves the company's chart of accounts (COA), which defines the financial statement categories used for accounting purposes.  By default, all accounts are returned and the balances are calculated using cash basis.  Required scope: read:company\n- [Get Classifications](https://puzzle-api.readme.io/reference/classifications.md): Retrieves a list of all classifications available for the calling company.  Requires scope: read:company\n- [Get Classification](https://puzzle-api.readme.io/reference/classification.md): Retrieves a classification available for the calling company.  Requires scope: read:company\n- [Get Trial Balance Report](https://puzzle-api.readme.io/reference/ledgerreportdownload.md): This endpoint generates a trial balance report. You can specify the time period for the report using either:  dateMacro (a predefined date range) startDate and endDate (a custom date range)  If all three are provided, dateMacro takes precedence.  Required scope: read:company\n- [Initiate Prefilled Onboarding](https://puzzle-api.readme.io/reference/initiateprefilledonboarding.md): Call this endpoint to pass some company information that is usually asked for during Puzzle's onboarding flow. A URL will be returned. When you redirect your user to this URL, the company information that was passed the original request will be prefilled for them in Puzzle's UI, allowing them to skip a few steps and create their Puzzle account more quickly.\n- [Get Monthly Checklist](https://puzzle-api.readme.io/reference/monthlychecklists.md): This endpoint retrieves the monthly checklist for the given company and month.  Required scope: read:company\n- [Create Financial Account](https://puzzle-api.readme.io/reference/createfinancialaccount.md): Creates a financial account for the specified Puzzle company.  The created account will have a status of Syncing until data is added to it, then it will be Ready. Please allow a couple of minutes for this status to update after the data has been added to the account.  The type of data that can be added to an account depends on the account type.  Required scope: write:account\n- [Get Financial Accounts](https://puzzle-api.readme.io/reference/financialaccounts.md): Retrieves a list of all of the company's financial accounts.  Required scope: read:company\n- [Create Account Balance](https://puzzle-api.readme.io/reference/createaccountbalance.md): Creates a balance for a financial account.  Note that Puzzle stores all account balances trending towards positive, regardless of account type. Additional details can be found here.  Required scope: write:account_balance\n- [Get Financial Account Balances](https://puzzle-api.readme.io/reference/balances.md): Returns the balances on a company's financial accounts on the provided dates. A balance is the balance on the account at the start of the day provided.  If we have an official institution account balance for that date, we will use the institution's provided account balance. If the institution has not provided an account balance for the requested date, we will calculate the balance by summing transactions in the account that have occurred between the target data and the closest balance we have available.  Note that Puzzle stores all account balances trending towards positive, regardless of account type. Additional details can be found here.  If any of the company accounts are currently syncing or processing, this endpoint will return a 409 error.  You can check the status of an account in the company object on the FinancialInstitutionAccount object. If the status is UpToDate then these balances can be retrieved without error.  Required scope: read:company\n- [Get Ledger Account](https://puzzle-api.readme.io/reference/ledgeraccount.md): Retrieves a specific account in the company's chart of accounts.  By default, the balances on the account are calculated using cash basis.  Required scope: read:company\n- [Get Bills](https://puzzle-api.readme.io/reference/billsapi.md): Retrieves bills.  Required scope: read:company\n- [Create Bill](https://puzzle-api.readme.io/reference/createbillapi.md): Creates a bill for the company.  Required scope: write:bill\n- [Get Bill](https://puzzle-api.readme.io/reference/billapi.md): Retrieves a bill.  Required scope: read:company\n- [Update Bill](https://puzzle-api.readme.io/reference/updatebillapi.md): Updates an existing bill with new values.  Required scope: write:bill\n- [Update Bill Status](https://puzzle-api.readme.io/reference/updatebillstatusapi.md): Updates an existing Bill's sStatus.  Required scope: write:bill\n- [Get Invoices](https://puzzle-api.readme.io/reference/invoicesapi.md): Retrieves invoices.  Required scope: read:company\n- [Create Invoice](https://puzzle-api.readme.io/reference/createinvoiceapi.md): Creates an invoice for the company.  Required scope: write:invoice\n- [Get Invoice](https://puzzle-api.readme.io/reference/invoiceapi.md): Retrieves an invoice.  Required scope: read:company\n- [Update Invoice](https://puzzle-api.readme.io/reference/updateinvoiceapi.md): Updates an invoice.  Required scope: write:invoice\n- [Get Vendors](https://puzzle-api.readme.io/reference/vendors-1.md): Retrieves a list of all of the company's vendors.  Required scope: read:company\n- [Create Vendor](https://puzzle-api.readme.io/reference/createvendorapi.md): Creates a new Vendor for the company.  Required scope: write:vendor\n- [Update Vendor](https://puzzle-api.readme.io/reference/updatevendorapi.md): Updates an existing Vendor for the company.  Required scope: write:vendor\n- [Get Customers](https://puzzle-api.readme.io/reference/customersapi.md): Retrieves a list of all of the company's customers.  Required scope: write:customer\n- [Create Customer](https://puzzle-api.readme.io/reference/createcustomerapi.md): Creates a new Customer for the company.  Required scope: write:customer\n- [Update Customer](https://puzzle-api.readme.io/reference/updatecustomerapi.md): Updates a Customer for the company.  Required scope: write:customer\n- [Create Requests](https://puzzle-api.readme.io/reference/createrequests.md): Creates category, documentation, and message requests in a company for a transaction.  Required scope: write:request\n- [Create Task](https://puzzle-api.readme.io/reference/createtask.md): This endpoint is experimental and is subject to change  Click here for more information.  Create a task for the given company.  Required scope: write:task\n- [Update Task](https://puzzle-api.readme.io/reference/updatetask.md): This endpoint is experimental and is subject to change  Click here for more information.  Update a task for the given company.  Required scope: write:task\n- [Get Requests](https://puzzle-api.readme.io/reference/requests.md): Retrieve a list of requests in a company.  Required scope: read:company\n- [Get Tasks](https://puzzle-api.readme.io/reference/tasks.md): This endpoint is experimental and is subject to change  Retrieves a list of tasks for the company. Tasks represent work items that need to be completed, such as categorization reviews, documentation requests, or messages.  Required scope: read:company\n- [Get Vendor Spending Report](https://puzzle-api.readme.io/reference/vendorspendingreportapi.md): Retrieves a report of the company's vendor spending.  Required scope: read:company\n- [Get Income Statement](https://puzzle-api.readme.io/reference/incomestatementapi.md): Retrieves the income statement for a company with flexible filtering options.  This endpoint returns income statement data broken down by the specified time interval (month, quarter, or year). You can filter results by departments and locations.  Required scope: read:company\n- [Get Balance Sheet Statement](https://puzzle-api.readme.io/reference/balancesheetstatementapi.md): Retrieves the balance sheet statement for a company with flexible filtering options.  This endpoint returns balance sheet statement data broken down by the specified time interval (month, quarter, or year).  Required scope: read:company\n- [Get Cash Activity Statement](https://puzzle-api.readme.io/reference/cashactivitystatementapi.md): Retrieves the cash activity statement for a company with flexible filtering options.  This endpoint returns cash activity statement data broken down by the specified time interval (month, quarter, or year).   Required scope: read:company\n- [Get Income Statement (Interop Format)](https://puzzle-api.readme.io/reference/incomestatementinteropformatapi.md): Retrieves the income statement in QuickBooks-compatible format with hierarchical row structure.  This endpoint returns income statement data in the same format as QuickBooks Online API, with nested sections and summary rows. Supports filtering by accounting method, and department.  Required scope: read:company\n- [Get Balance Sheet (Interop Format)](https://puzzle-api.readme.io/reference/balancesheetinteropformatapi.md): Retrieves the balance sheet in QuickBooks-compatible format with hierarchical row structure.  This endpoint returns balance sheet data in the same format as QuickBooks Online API, with nested sections and summary rows. Supports filtering by accounting method, and department.  Required scope: read:company\n- [Get Financial Statements](https://puzzle-api.readme.io/reference/financialstatements.md): Retrieve the financial statements of a company. Currently supports the Cash Activity Report, Income Statement, and Balance Sheet.  Required scope: read:company\n- [Get Expense Metrics](https://puzzle-api.readme.io/reference/expensemetrics.md): Retrieves a summary of a company's expenses for a given time span, broken into chunks as specified in the 'interval' param  Currently only the 'month' interval is supported, but will soon support 'quarter' and 'year'.  The array of metrics will be returned in ascending order from earliest time interval to latest.  Required scope: read:company\n- [Get Categorization Metrics](https://puzzle-api.readme.io/reference/categorizationmetrics.md): Retrieves categorization metrics for the company.  Required scope: read:company\n- [Get Revenue Metrics](https://puzzle-api.readme.io/reference/revenuemetrics.md): Retrieves a summary of a company's revenue for a given time span, broken into chunks as specified in the 'interval' param. We will soon support additional revenue metrics such as ARR and accrual-based ARR.  Currently only the 'month' interval is supported, but will soon support 'quarter' and 'year'.  The array of metrics will be returned in ascending order from earliest time interval to latest.  Required scope: read:company\n- [Get Employee Metrics](https://puzzle-api.readme.io/reference/employeemetrics.md): Retrieves a summary of a company's employees for a given time span, broken into chunks as specified in the 'interval' param. The metrics are currently across all departments. We will support filtering by department in the near future.  Currently only the 'month' interval is supported, but will soon support 'quarter' and 'year'.  The array of metrics will be returned in ascending order from earliest time interval to latest.  Required scope: read:company\n- [Get Spending Metrics](https://puzzle-api.readme.io/reference/spendingmetrics.md): Retrieves payroll and non-payroll spending metrics for the given period range. Provide startPeriod and endPeriod in YYYY-MM format.  Required scope: read:company\n- [Get Current User](https://puzzle-api.readme.io/reference/me.md): Gets information about the current user. Only valid for OAuth connections.\n- [Fetch a Link Token](https://puzzle-api.readme.io/reference/createtemporarylinktoken.md): This authentication method has been deprecated. Please use the Authentication endpoints instead. Additional details can be found here.  Creates a link token that can be used to authenticate a user when directing them to the connection flow. The token expires after 30 minutes.  After obtaining your link token, create a link to Puzzle so the user can connect their Puzzle account.  <a    href=\"https://staging.southparkdata.com/connect/{your_company_name} \t?token=REDACTED \t&redirect_uri={your_redirect_uri}\" >   Connect your Puzzle account </a>  They will see your welcome page and an opportunity to log in or sign up with Puzzle.\n- [Get Workers](https://puzzle-api.readme.io/reference/workerslist.md): Retrieves a list of all of the company's workers, both employees and contractors.  Required scope: read:worker\n- [Create Contractor](https://puzzle-api.readme.io/reference/createcontractor.md): Create a contractor for the given company.  Requires scope: write:worker\n- [Create Employee](https://puzzle-api.readme.io/reference/createemployee.md): Create an employee for the given company.  Required scope: write:worker\n- [Get Benefits](https://puzzle-api.readme.io/reference/benefits.md): Retrieves a list of all benefits for the given company. These benefits represent company-level benefits that can have both an employee contribution and a company contribution.  Payrolls will reference these benefits and provide details on the employee and company contribution amounts.  Requires scope: read:company\n- [Create Benefit](https://puzzle-api.readme.io/reference/createbenefit.md): Create a benefit for the given company.  Requires scope: write:benefit\n- [Create Payroll](https://puzzle-api.readme.io/reference/createdetailedpayroll.md): Create a single payroll.  Payrolls can only be added to accounts with the Payroll type. All the amounts on the top-level payroll object are the totals for all the associated compensations Payrolls must have at least one employeeCompensation OR contractorCompensation The transactionAmounts field should contain a list of all the amounts for all the non-reimbursement transactions that were used to fund this payroll. If no transactionAmounts are provided, the companyDebit amount will be used instead Puzzle uses this information to link this payroll with all the transactions that funded it to ensure everything gets represented in the general ledger correctly. Puzzle currently only supports USD currencies  Required scope: write:payroll\n- [Get Payroll](https://puzzle-api.readme.io/reference/getpayroll.md): Get a single payroll by ID  Required scope: read:company\n- [Create Journal Entry](https://puzzle-api.readme.io/reference/upsertjournalentry.md): Required scope: write:journal  Journal entries are the entries made in a company's ledger accounts as a way of recording financial impact. The line items for each journal entry should balance to 0.  Create Journal Entries endpoint creates a Journal Entry into our Gateway and not on our Ledger. Once the Gateway receives a Journal Entry, you get an OK response. Ledger Journal Entries are created async and can be retrieved through the Get Journal Entries endpoint.  Puzzle journal entries are immutable. This means that when an update is made, 2 additional journal entries get created - one to reverse the original journal entry and another to reflect the updates. Reversal journal entries can be identified by their description field - they will have descriptions matching \"Reversal of {{journal entry id}}\".  All Puzzle companies have both cash and accrual journal entries; they are distinct populations.\n- [Delete Journal Entry](https://puzzle-api.readme.io/reference/deletejournalentry.md): Required scope: write:journal  Journal entries are the entries made in a company's ledger accounts as a way of recording financial impact.  Delete Journal Entry endpoint will delete a draft journal entry and void a posted one.\n- [Get Journal Entries](https://puzzle-api.readme.io/reference/journalentries-1.md): Required scope: read:company\n- [Create Journal Entry](https://puzzle-api.readme.io/reference/upsertjournalentries.md): Required scope: write:journal  Journal entries are the entries made in a company's ledger accounts as a way of recording financial impact. The line items for each journal entry should balance to 0.  Create Journal Entries endpoint creates a Journal Entry into our Gateway and not on our Ledger. Once the Gateway receives a Journal Entry, you get an OK response. Ledger Journal Entries are created async and can be retrieved through the Get Journal Entries endpoint.  Puzzle journal entries are immutable. This means that when an update is made, 2 additional journal entries get created - one to reverse the original journal entry and another to reflect the updates. Reversal journal entries can be identified by their description field - they will have descriptions matching \"Reversal of {{journal entry id}}\".  All Puzzle companies have both cash and accrual journal entries; they are distinct populations.\n- [Create Document](https://puzzle-api.readme.io/reference/createjournalentrydocument.md): Create a document for a given journal entry.  Required scope: write:journal\n- [Get Puzzle Categories](https://puzzle-api.readme.io/reference/puzzlecategories.md): Retrieves all of the valid Puzzle categories that can be used to categorize transactions.  Only valid for OAuth connections.\n- [Get Transactions](https://puzzle-api.readme.io/reference/gettransactions.md): Get transactions by filter  Required scope: read:company\n- [Create Transactions](https://puzzle-api.readme.io/reference/createtransactions.md): Create multiple transactions for a single financial account.  You can create up to 500 transactions per request Transactions can only be added to …

for u in "https://staging.southparkdata.com/companies" "https://api.puzzle.io/companies" "https://staging.southparkdata.com/v1/me"; do echo "== $u"; timeout 15 curl -sS -o /tmp/o -w "%{http_code}\n" "$u" 2>&1; head -c 200 /tmp/o; echo; done

{"content":[{"text":"== https://staging.southparkdata.com/companies\n307\n\n== https://api.puzzle.io/companies\n307\n\n== https://staging.southparkdata.com/v1/me\n307\n\n","type":"text"}]}

timeout 20 curl -sSL https://puzzle-api.readme.io/llms.txt 2>/dev/null | grep -icE "mcp"; timeout 20 curl -sSL https://puzzle-api.readme.io/llms.txt 2>/dev/null | grep -iE "mcp|sdk|quickstart|sandbox" | head -10; echo "--- npm/pypi official sdk:"; timeout 20 curl -sS "https://registry.npmjs.org/-/v1/search?text=puzzle%20accounting%20api&size=5" | python3 -c "
import json,sys
for o in json.load(sys.stdin)['objects']:
    p=o['package']; print(p['name'],'|',p.get('description','')[:70])
"; timeout 20 curl -sS "https://pypi.org/search/?q=puzzle" -o /dev/null -w "pypi:%{http_code}\n" 2>&1

{"content":[{"text":"0\n--- npm/pypi official sdk:\nxero-node | Xero NodeJS OAuth 2.0 client for xero-node\naccounting | number, money and currency formatting library\n@mergeapi/merge-sdk-typescript | NodeJS client for Merge API, Inc's unified API's.\n@types/accounting | TypeScript definitions for accounting\ncrypto-puzzle | A time-lock puzzle generator\npypi:200\n","type":"text"}]}