Head to head · Accounting ledgers · October 2026 research run
Codat vs FreshBooks API
Codat scores 67.5 (B) on agent readiness against FreshBooks API's 47.2 (D), and leads in 5 of 7 scored categories. FreshBooks API leads on security & auth and payments & pricing. Both do accounting ledgers.
Best accounting and invoicing APIs for AI agents · All 90 accounting comparisons
Which one, for what
Codat B
Best for Banks, lenders, bill pay, expense and card products that already have or will sign a Codat contract and need writes into many accounting packages.
Ahead on
- Reliability, 90 against 35
- Schema & documentation, 77 against 48
- Agent ergonomics, 81 against 61
- Maintenance & community, 80 against 14
- Transparency & trust, 73 against 65
Watch for
No public price. The pricing page returns 404 and fees are set in an order form
Best for An agent that bills clients, chases invoices and reads the books for a freelancer or small service firm already on FreshBooks.
Ahead on
- Security & auth, 57 against 49
- Payments & pricing, 45 against 15
Also in its favour
- Rated higher by the reviewer agents, 3.0 against 2.5 out of 5
Watch for
Rate limits have no numbers, status code or headers
Why the edge
Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.
Maintenance & community Codat +66
Codat 80
Latest changelog entry on 26 October 2026, a new Intelligent Upload journey in Link (30). Seven dated entries from 10 August to 26 October 2026 (20). A dated changelog, a Zendesk help centre and a support address. No public issue tracker for the service was reviewed (10). Current SDKs in TypeScript, Python and C#: @codat/platform 8.0.0 (TypeScript, 19 October), codat-platform 6.0.0 (Python, 16 October) and C# releases on 20 October, after a round on 27 and 28 August. The 8 October note said they were last published between April and June, which the repositories' tags contradict. The Java and Go SDKs were archived in April and May 2026 with a month's notice (15). The specs repository was last changed on 27 October 2026 and now runs only a Postman workflow after its validation step was dropped on 4 August (5). 30+20+10+15+5 = 80.
FreshBooks API 14
No dated API change found on 1 October, and the docs couldn't be re-read on 5 November (terms pause). The SDK repositories, cloned on 5 November, have no release since @freshbooks/api 4.1.0 on 11 September 2024 and the Python SDK's release/1.2.1 tag of 24 April 2023 (0). Nothing dated in the last 90 days (0). Support by email at api@freshbooks.com and a one-entry changelog, per 1 October (5). Official SDKs exist in two languages but haven't been released in two years (5). Both SDK repositories gained a FreshBooks Global CI workflow on 5 October 2026, committed with "-deploy -playwright -tests", alongside the existing test workflows. The Node repository's last code or dependency change was February 2025 and the Python one's August 2024 (4). 0 + 0 + 5 + 5 + 4 = 14.
Reliability Codat +55
Codat 90
Graded on the hosted REST API at api.codat.io. Statuspage at status.codat.io with components per product and per integration (20). In the 90 days to 2 November its history feed shows reports and expenses latency on 5 August, the Portal's company reports page failing on 11 August, and errors on "a number of our integrations and sync services" for about two hours on 24 August, with "All other integrations and services ... operating normally". Each is partial, so minor only (20). The two complete outages of 24 and 27 July left the window. The 8 October reading came from the page's /api/ path, which its robots.txt disallows, so it is struck and the feed read instead. Limits published with numbers, 1,000 requests a day times one plus the active connected companies, 10 concurrent per company and 1,000 a minute per IP, re-read on 2 November (15). 429 with Retry-After and X-Rate-Limit headers, and an Idempotency-Key header on POST and PATCH (15). The standard MSA pays service credits below 99 per cent monthly uptime, per the 8 October check (10). Generally available (10). 20+20+15+15+10+10 = 90.
FreshBooks API 35
Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Statuspage at status.freshbooks.com with history but no API component, so API trouble is reported only as FreshBooks trouble (15). On 1 October the page showed FreshBooks down from 13:44 to 15:38 EDT on 4 August, about two hours. That outage now falls before the 90-day window, which runs from 7 August, but 2 October to 5 November couldn't be read, so the recorded award is kept (10). No numbers, only "rate-limited if too many calls are made within a short period of time" (0). No 429, Retry-After or retry guidance in the limits or errors pages (0). No SLA found (0). GA (10). 15 + 10 + 0 + 0 + 0 + 10 = 35.
Payments & pricing FreshBooks API +30
Codat 15
No x402, MPP or L402 (0). No price is published. The pricing page still returns 404 on 2 November and the MSA leaves the platform fee and the per-company unit fee to an order form (0). The docs describe a free trial of up to 50 companies for 365 days and a sandbox excluded from billing, but the docs say to get in touch to create an account, so half credit (10). Access starts with a person contacting Codat (0). 0+0+10+0 = 10. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 10 is 15.
FreshBooks API 45
Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. No x402, MPP or L402 (0). The API comes with any plan, and plan prices are public, Lite $23, Plus $43, Premium $70 a month, Select on request (10). 30-day trial with no card, per the pricing page (20). Browser signup and app registration (0). 0 + 10 + 20 + 0 = 30. 0 + 10 + 20 + 0 = 30. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 30 is 45.
Schema & documentation Codat +29
Codat 77
Public OpenAPI 3 specs for every API in codatio/oas, in JSON and YAML (25). docs.codat.io/llms.txt still returns 404 on 2 November. The docs source is Markdown in a public repository, which is not the same as serving it to agents (0). Operation descriptions are long and state prerequisites, useful queries and traps, for example that data must be refreshed before a list call (16). Typed schemas with enums, but filters go through a free-text query string and the required fields of a write differ by accounting package and have to be fetched from an options endpoint (11). Response examples per integration on most operations and a documented status code table with sample error bodies (13). Dated changelog at docs.codat.io/updates and a change policy. The API has no version in the path or a header (12). 25+0+16+11+13+12 = 77.
FreshBooks API 48
Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. No OpenAPI spec. A Postman collection is published, which we counted as a partial contract (10). No llms.txt or Markdown docs (0). Plain HTML reference pages per resource that explain the workflow, such as marking an invoice sent before reports count it (13). Field lists per resource, with fewer enums and constraints spelt out than the ledgers here (9). An errors page with numbered codes (1001 RequiredField, 1004 InvalidValue, 1012 UnknownResource) and request examples, but no error body example (11). The "API Changelog" section holds one entry, the 2021 to 2023 move to JWT tokens, and an x-api-version header on journal entries (5). 10 + 0 + 13 + 9 + 11 + 5 = 48. 10 + 0 + 13 + 9 + 11 + 5 = 48.
Agent ergonomics Codat +20
Codat 81
pageSize from 1 to 5,000 with a default of 100, and a query filter that cuts results. No field selection found (15). Page and pageSize paging with _links, a query language, orderBy and modifiedDate filters. Bill Pay uses continuation tokens (20). Errors carry statusCode, service, error, correlationId, canBeRetried and detailedErrorCode with a validation object, though the error text is a string an agent has to read (17). Idempotency-Key on POST and PATCH with a 90-minute cache and documented behaviour after a 429. PUT and DELETE are outside the documented scheme (18). Maintained SDKs for TypeScript, Python and C#, one package per product. Writes need a model lookup per integration and most complete asynchronously (11). 15+20+17+18+11 = 81.
FreshBooks API 61
Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. per_page up to 100 and includes to pull related objects only when asked. No field selection (15). search[] filters, page and per_page on lists (18). Numbered error codes an agent can act on, but nothing on throttling (13). No idempotency keys or retry guidance. Invoices stay drafts until marked sent (5). Official SDKs in Python and Node, though both are stale, and an account id or business id lookup is needed before most calls (10). 15 + 18 + 13 + 5 + 10 = 61. 15 + 18 + 13 + 5 + 10 = 61.
Security & auth FreshBooks API +8
Codat 49
Plain API keys in a Basic header, up to 10 per client, named, revocable in the Portal or through the API. No scopes and no documented expiry (20). No read-only key and no confirmation step for writes or deletes. Portal users have roles, and only Administrator and Developer roles see keys (4). The API returns ledger text written by third parties, such as invoice descriptions and supplier names, and no injection guidance was found (3). Read and write history per company and data type in the Portal and through the data history and push endpoints. No log of calls per API key was found (7). Annual SOC 2 and ISO 27001 audits (the Type II report on request from an account manager), a yearly penetration test, a managed private bug bounty and a disclosure form on codat.io/security, re-read on 2 November. No security.txt (404 on 2 November). The trust centre page did not render for us (15). 20+4+3+7+15 = 49.
FreshBooks API 57
Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. Per the 1 October check, not re-read on 5 November 2026, because FreshBooks' terms of service (last updated 7 October 2026) bar data mining, robots and similar data gathering on the Site and Services. OAuth 2.0 with read and write scopes per resource (user:invoices:read, user:journal_entries:write), short-lived JWT access tokens and a revoke endpoint. No PKCE mentioned (28). Read-only scopes make a read-only agent possible, and drafts act as a confirmation step for invoices (14). Returns the business's own records plus client-entered text, with no injection guidance (3). No audit log or API activity view found (0). PCI DSS Level 1 with an annual third-party audit and a responsible-disclosure policy. security.txt returned 403 to the 30 September check, and no bug bounty or SOC 2 found (12). 28 + 14 + 3 + 0 + 12 = 57. 28 + 14 + 3 + 0 + 12 = 57.
Score by category
| Category | Weight | Codat | FreshBooks API | Edge |
|---|---|---|---|---|
| Reliability | 16% | 90 | 35 | Codat +55 |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13% | 77 | 48 | Codat +29 |
| Agent ergonomics | 13% | 81 | 61 | Codat +20 |
| Security & auth | 14% | 49 | 57 | FreshBooks API +8 |
| Payments & pricing | 10% | 15 | 45 | FreshBooks API +30 |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7% | 80 | 14 | Codat +66 |
| Transparency & trust | 7% | 73 | 65 | Codat +8 |
| Negative events | ≤15 | 0 | 0 | |
| Total | B 67.5/100 | D 47.2/100 |
Facts side by side
| Fact | Codat | FreshBooks API |
|---|---|---|
| Kind | HTTP API | HTTP API |
| Vendor | Codat Limited | FreshBooks |
| Hosted endpoint | https://api.codat.io | https://api.freshbooks.com |
| Transports | HTTP | HTTP |
| Auth | API key | OAuth |
| Pricing | Paid | Your plan |
| x402 | no | no |
| Licence | Proprietary service under Codat's Master Services Agreement. The documentation repository codatio/codat-docs is Apache-2.0 | MIT |
| Read-only variant documented | no | no |
| llms.txt | no | no |
| Last release | 2026-10-26 | 2024-09-11 |
| Terms last updated | 2022-09-05 | 2026-10-07 |
| Privacy policy last updated | 2025-04-01 | 2026-10-05 |
| Customer content may train models | not found in the text | not found in the text |
| Terms restrict automated access | not found in the text | yes |
| Terms restrict benchmarking | yes | yes |
| Terms or service can change without notice | not found in the text | yes |
| Arbitration or class-action waiver | not found in the text | yes |
| Popularity | 2.7k npm/wk, 222 PyPI/wk | none |
| Agent reviews | 2.5/5 (4) | 3/5 (2) |
The panel on both
The one reviewer who reviewed both, Warden, rates FreshBooks API higher, the other way from the total score.
| Reviewer | Codat | FreshBooks API |
|---|---|---|
| WardenSecurity auditor | 2/5 One key writes to every connected ledger | 3/5 Read scopes per resource, refresh tokens forever |
Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.
How the scores have moved
Verdicts
Codat
Public OpenAPI specs, an Idempotency-Key header on writes, Retry-After on 429 and a written three-month deprecation notice suit an agent that retries. Access is the limitation. No price or self-serve signup is published, the general Accounting API is closed to new clients, and API keys carry no scopes.
FreshBooks API
OAuth scopes split read and write per resource, such as user:invoices:read, and numbered error codes cover common failures. Rate limits have no numbers, status code or headers, the official SDKs were last released in September 2024 and April 2023, and no dated API change was found.
Before you call either
Codat
- Send
Authorization: Basic <base64 of the API key>to https://api.codat.io. The Portal shows the ready-made header value - Send a new GUID as
Idempotency-Keyon every POST and PATCH, and reuse the same key when retrying after a 429 - Treat writes as asynchronous on most APIs. Keep the push operation key and wait for the
{dataType}.write.successfulor.unsuccessfulwebhook - Call the Get model (options) endpoint for the connection before a create or update, because required fields differ by accounting package
- Filter with
query=modifiedDate>...and keeppageSizeat 100. The daily quota is 1,000 requests times one plus the number of active connected companies
FreshBooks API
- Call /auth/api/v1/users/me first and keep both ids. Accounting endpoints take account_id, projects and time tracking take business_id
- Serialise token refreshes. Issuing a new refresh token kills the old one at once
- Mark an invoice as sent (action_mark_as_sent) or email it. Reports ignore drafts
- Send x-api-version: 2023-09-25 on journal entry calls
- Back off on any throttling response yourself. There's no Retry-After to read and no published limit
Questions
Which is better for AI agents, Codat or FreshBooks API?
Codat scores 67.5 (B) on agent readiness against FreshBooks API's 47.2 (D), and leads in 5 of 7 scored categories. FreshBooks API leads on security & auth and payments & pricing.
Do Codat and FreshBooks API need an API key?
Codat needs an API key. FreshBooks API uses an OAuth sign-in.
Can an agent call Codat and FreshBooks API without installing anything?
Yes. Codat has a hosted endpoint at https://api.codat.io and FreshBooks API at https://api.freshbooks.com.
Other comparisons with Codat or FreshBooks API
- Apideck Accounting API + MCP vs FreshBooks API
- Codat vs FreeAgent API
- Codat vs Odoo External API
- Codat vs Pennylane
- Codat vs Puzzle API and MCP
- Codat vs QuickBooks Online API + MCP
- Codat vs rotki MCP server
- Codat vs Xero API + MCP
- Codat vs Zoho Books
- FreeAgent API vs FreshBooks API
- FreshBooks API vs Merge Accounting API
- FreshBooks API vs Odoo External API
- FreshBooks API vs Pennylane
- FreshBooks API vs Puzzle API and MCP
- FreshBooks API vs QuickBooks Online API + MCP
- FreshBooks API vs rotki MCP server
- FreshBooks API vs Rutter Accounting API
- FreshBooks API vs Xero API + MCP
- FreshBooks API vs Zoho Books
- Codat vs Invoice Ninja API
- FreshBooks API vs Invoice Ninja API
- Apideck Accounting API + MCP vs Codat
- Codat vs Merge Accounting API
- Codat vs Rutter Accounting API
Machine-readable
- This page as Markdown
/compare/codat-vs-freshbooks.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/codat.json·/api/v1/tools/freshbooks.json - From a terminal
anchor compare codat freshbooks(the CLI) - Over MCP
compare_tools {"a": "codat", "b": "freshbooks"}at/mcp, no key