# Fictix Docs

> Fictix generates a synthetic company — accounting, banking, CRM, payroll,
> tasks, and native-shaped connector records — with known issues planted on
> request, so you can test a product against believable, reconciled data.
> Customers start in the Fictix Console (console.fictix.ai) to create a
> company and get a project API key; approved server-to-server integrations
> use the `/api/v1/demo-jobs` control plane. Every page on this site is also
> available as raw Markdown by appending `.md` to its URL. Full concatenated
> content: /llms-full.txt. Repo-level agent brief: /AGENTS.md.

## Get Started

- [Overview](https://fictix-docs.vercel.app/get-started/overview.md): What Fictix is, the main API surface, base URLs, auth models.
- [Start In The Fictix Console](https://fictix-docs.vercel.app/get-started/console-onboarding.md): Create an account, generate a company, create a project API key.
- [Quickstart](https://fictix-docs.vercel.app/get-started/quickstart.md): Connect to an existing company and fetch data in under 5 steps.
- [Authentication](https://fictix-docs.vercel.app/get-started/authentication.md): Project runtime keys, the Fictix-supplied admin-key management credential, idempotency, and browser safety.
- [One key for multiple companies](https://fictix-docs.vercel.app/get-started/organization-api-keys.md): Staging organization keys, company directory pagination, scope selection, rotation, and revocation.

## Concepts

- [Demo Jobs](https://fictix-docs.vercel.app/concepts/demo-jobs.md): The external resource wrapping one generated company; lifecycle, create/reset/clone/publish.
- [Company Blueprints](https://fictix-docs.vercel.app/concepts/company-blueprints.md): How Fictix decides a generated company's shape; company_dna vs generation_company_dna.
- [Entities, Counts, And Lineage](https://fictix-docs.vercel.app/concepts/entities-and-lineage.md): Canonical entity families, aliases, pagination, lineage fields, referential integrity.
- [Simulation And Time](https://fictix-docs.vercel.app/concepts/simulation.md): Advancing the company clock, dials, checkpoints, events, scenario manifests.

## Guides

- [Connect your software](https://fictix-docs.vercel.app/guides/connect-your-software.md): Provider and SDK base URLs, company or organization keys, scopes, request formats, and errors.
- [Build A Demo Tenant](https://fictix-docs.vercel.app/guides/build-demo-tenant.md): End-to-end: turn a user request into a live demo tenant in your product.
- [Load Fictix Data Into Your App](https://fictix-docs.vercel.app/guides/load-into-your-app.md): JSON vs CSV ingestion patterns, mapping notes, reconciliation.
- [QuickBooks accounting](https://fictix-docs.vercel.app/guides/quickbooks-accounting.md): Staging-verified native account references, service invoices, expense bills, exact linked payments, and posted journal reads; production qualification pending.
- [Evaluate Your App With Planted Truth](https://fictix-docs.vercel.app/guides/evaluate-your-app.md): Plant known issues, run your product, score detected findings.

## API Reference

- [Provider first requests](https://fictix-docs.vercel.app/api-reference/provider-first-requests.md): Exact first requests for 60 staging integrations, with production availability, POST bodies, and a JSON download.
- [Provider workflows](https://fictix-docs.vercel.app/api-reference/provider-workflows.md): Supported provider operations, versions, pagination, writes, and compatibility limits.
- [First-request JSON](https://fictix-docs.vercel.app/provider-first-requests.json): Public machine-readable request templates for all reviewed integrations; no credentials.
- [Company API](https://fictix-docs.vercel.app/api/company.md): Curated executable OpenAPI for project-key runtime routes and credential-free catalog discovery.
- [Partner API](https://fictix-docs.vercel.app/api/partner.md): Curated executable OpenAPI for approved server-to-server demo-job integrations.
- Interactive operation and schema pages are generated from those two contracts under `/api/company` and `/api/partner`. Test requests and browser credential entry are disabled by design.

- [Catalog](https://fictix-docs.vercel.app/api-reference/catalog.md): Public, credential-free discovery endpoints (archetypes, presets, entities, services, schemas).
- [Demo Jobs](https://fictix-docs.vercel.app/api-reference/demo-jobs.md): Create, list, get, publish, clone, and reset demo jobs.
- [Entities And Exports](https://fictix-docs.vercel.app/api-reference/entities-and-exports.md): Bundle, entity page, and export (JSON/CSV) endpoints.
- [Simulation, Scenarios, And Events](https://fictix-docs.vercel.app/api-reference/simulation-scenarios-events.md): Simulation control routes, scenario injection, event stream.
- [Test Matrices And Test Runs](https://fictix-docs.vercel.app/api-reference/test-matrices-runs.md): Define expected detections and submit/score test runs.
- [Runtime And Native Routes](https://fictix-docs.vercel.app/api-reference/runtime-native-routes.md): Project-scoped runtime API, export packs, provider-shaped native routes.
- [Response Envelopes](https://fictix-docs.vercel.app/api-reference/response-envelopes.md): Stable object shapes, contract_version, error envelope.
- [Capability Matrix](https://fictix-docs.vercel.app/api-reference/capability-matrix.md): Which surface needs which credential; native/generic/unsupported fidelity labels.
- [Webhooks](https://fictix-docs.vercel.app/api-reference/webhooks.md): Subscriptions, signing, delivery semantics, event types, troubleshooting.
- [Errors, Limits, And Idempotency](https://fictix-docs.vercel.app/api-reference/errors-limits-idempotency.md): Status codes, idempotency rules, retry guidance.

## For Agents

- [Consuming these docs](https://fictix-docs.vercel.app/for-agents/consuming-these-docs.md): agents.md, per-page .md mirrors, llms.txt entry points.
- [MCP server](https://fictix-docs.vercel.app/for-agents/mcp.md): Official FastMCP sidecar — run, transports, env vars, Claude Code/Codex/Cursor config.
- [Skill pack](https://fictix-docs.vercel.app/for-agents/skill-pack.md): Downloadable skill folder for Claude Code and generic agents.

## Resources

- [Rate Limits And Quotas](https://fictix-docs.vercel.app/resources/rate-limits-and-quotas.md): Request rate limits, pagination/bundle caps, dataset and plan quotas.
- [Versions And Compatibility](https://fictix-docs.vercel.app/resources/versions-and-compatibility.md): API release vs partner contract version, compatibility rules.
- [Partner Integration Checklist](https://fictix-docs.vercel.app/resources/production-checklist.md): What "ready for production" means for an integration.
- [AI Agent Integration](https://fictix-docs.vercel.app/resources/agent-integration.md): AGENTS.md, Claude Code skill, Cursor rules, an instructions-file map for other agents (Copilot, Windsurf, Cline, Gemini CLI), and a browser-builder (Lovable/v0/Bolt) proxy brief.
- [Changelog](https://fictix-docs.vercel.app/resources/changelog.md): Dated contract changes with client action and compatibility notes.
- [Overview](https://fictix-docs.vercel.app/index.md): Generate a believable synthetic company, read reconciled business data, and test your product against known ground truth.
- [Overview](https://fictix-docs.vercel.app/get-started/overview/index.md)
- [Start in the Console](https://fictix-docs.vercel.app/get-started/console-onboarding/index.md)
- [Quickstart](https://fictix-docs.vercel.app/get-started/quickstart/index.md)
- [Company blueprints](https://fictix-docs.vercel.app/concepts/company-blueprints/index.md)
- [Organization API keys](https://fictix-docs.vercel.app/get-started/organization-api-keys/index.md)
- [Connect your software](https://fictix-docs.vercel.app/guides/connect-your-software/index.md)
- [Entities, counts & lineage](https://fictix-docs.vercel.app/concepts/entities-and-lineage/index.md)
- [Build a demo tenant](https://fictix-docs.vercel.app/guides/build-demo-tenant/index.md)
- [Evaluate your app](https://fictix-docs.vercel.app/guides/evaluate-your-app/index.md)
- [Catalog](https://fictix-docs.vercel.app/api-reference/catalog/index.md)
- [Entities and exports](https://fictix-docs.vercel.app/api-reference/entities-and-exports/index.md)
- [Test matrices and runs](https://fictix-docs.vercel.app/api-reference/test-matrices-runs/index.md)
- [Response envelopes](https://fictix-docs.vercel.app/api-reference/response-envelopes/index.md)
- [Webhooks](https://fictix-docs.vercel.app/api-reference/webhooks/index.md)
- [Provider first requests](https://fictix-docs.vercel.app/api-reference/provider-first-requests/index.md)
- [Consuming these docs](https://fictix-docs.vercel.app/for-agents/consuming-these-docs/index.md)
- [Skill pack](https://fictix-docs.vercel.app/for-agents/skill-pack/index.md)
- [Versions and compatibility](https://fictix-docs.vercel.app/resources/versions-and-compatibility/index.md)
- [AI agent integration](https://fictix-docs.vercel.app/resources/agent-integration/index.md)
- [Demo jobs](https://fictix-docs.vercel.app/concepts/demo-jobs/index.md)
- [Simulation and time](https://fictix-docs.vercel.app/concepts/simulation/index.md)
- [Load data into your app](https://fictix-docs.vercel.app/guides/load-into-your-app/index.md)
- [Capability matrix](https://fictix-docs.vercel.app/api-reference/capability-matrix/index.md)
- [Simulation, scenarios & events](https://fictix-docs.vercel.app/api-reference/simulation-scenarios-events/index.md)
- [Provider workflows](https://fictix-docs.vercel.app/api-reference/provider-workflows/index.md)
- [Rate limits and quotas](https://fictix-docs.vercel.app/resources/rate-limits-and-quotas/index.md)
- [Changelog](https://fictix-docs.vercel.app/resources/changelog/index.md)
- [Healthcare / ASC data](https://fictix-docs.vercel.app/concepts/clinical-asc/index.md)
- [Partner integration checklist](https://fictix-docs.vercel.app/resources/production-checklist/index.md)
- [Errors, limits & idempotency](https://fictix-docs.vercel.app/api-reference/errors-limits-idempotency/index.md)
- [Demo jobs](https://fictix-docs.vercel.app/api-reference/demo-jobs/index.md)
- [QuickBooks accounting](https://fictix-docs.vercel.app/guides/quickbooks-accounting/index.md)
- [Runtime and native routes](https://fictix-docs.vercel.app/api-reference/runtime-native-routes/index.md)
- [Authentication](https://fictix-docs.vercel.app/get-started/authentication/index.md)
- [MCP server](https://fictix-docs.vercel.app/for-agents/mcp/index.md)