Supergood | FloQast API
Programmatically access FloQast’s month-end close workflows—checklists, account reconciliations, flux analysis, sign-offs, and stakeholder requests—via a stable REST API. Supergood builds and operates production-grade, unofficial FloQast integrations so your team can automate close status tracking, reconciliation evidence collection, variance reviews, and audit exports without heavy custom engineering.
FloQast is accounting close management software used by corporate accounting teams to run month-, quarter-, and year-end close. With an unofficial API, you can list close periods, read and update reconciliation statuses, attach supporting documents, create and assign tasks, and pull flux variance details directly into your finance operations tooling.
If you’re a tech company integrating FloQast, you can push tasks and requests to stakeholders, pull normalized trial balance summaries and reconciliation exceptions, enable sign-off automation, and export audit-ready artifacts to your ERP, FP&A platform, or ticketing system. You can also surface close progress inside your product, trigger reminders, and sync evidence files from storage systems—reducing manual copy-paste and speeding up the close.
What is FloQast?
FloQast is a finance operations platform focused on the accounting close. It streamlines checklist management, reconciliations, variance analysis, and audit readiness, integrating tightly with ERP systems and familiar spreadsheet workflows.
Core product families include:
- Close Management (checklists, due dates, ownership, sign-offs)
- Account Reconciliations (GL accounts, supporting documents, workflows)
- Variance/Flux Analysis (period-over-period comparisons, thresholds, commentary)
- Request Management (stakeholder requests and reminders)
- Reporting and Audit (status dashboards, evidence, exportable trails)
Common data entities:
- Close Periods (month/quarter/year, status, lock state)
- Accounts and Trial Balances (GL number, name, balances)
- Reconciliations (preparer/reviewer, supporting docs, exceptions)
- Checklists and Tasks (owners, due dates, dependencies)
- Flux Variances (thresholds, drivers, commentary, approvals)
- Requests (recipient, due date, completion state)
- Users and Teams (roles, permissions)
- Attachments and Evidence (workbooks, PDFs, statements)
The FloQast Integration Challenge
Startups selling into finance teams that use FloQast often hit integration hurdles:
- Product entitlements and licensing: Access differs across Close, Reconciliations, Flux, and Request modules
- Enterprise security controls: SSO, MFA, and strict network policies complicate headless automation
- Portal-first workflows: Many actions (sign-offs, attachments, commentary) live in the web UI without public APIs
- Data normalization: Mapping GL accounts and trial balances across ERPs (NetSuite, Sage Intacct, Microsoft Dynamics 365) requires consistent schemas
- Evidence handling: Large Excel/PDF attachments, versioning, and audit retention policies need careful orchestration
- Close governance: Period lock/reopen rules, approval flows, and role-based permissions must be respected programmatically
How Supergood Creates FloQast APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your FloQast workflows.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes close periods, accounts, reconciliations, tasks, and variances into consistent objects
- Aligns with customer entitlements and licensing constraints to ensure compliant access
Use Cases
Close Status and Task Automation
- List close periods with percent complete and blockers
- Create checklist tasks, set due dates, and assign owners
- Auto-route tasks to Slack/Jira and update status on completion
Reconciliation Evidence and Sign-Offs
- Retrieve reconciliation status and exceptions by account
- Upload supporting documents (workbooks, bank statements, PDFs)
- Track preparer/reviewer sign-offs and approvals
Flux Analysis and Variance Commentary
- Pull variance items crossing thresholds for target accounts
- Sync commentary from FP&A and trigger review tasks
- Escalate unresolved variances before period lock
Compliance Archival and Audit Trails
- Export evidence and sign-off trails with timestamps
- Centralize attachments and notes for retention policies
- Prove coverage with consistent, machine-readable artifacts
Available Endpoints
Authentication
POST /auth/sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/auth/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" },
"ssoProvider": null
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_fq_61a2c3",
"name": "Controller One",
"entitlements": ["close_management", "reconciliations", "flux_analysis"]
}
}
POST /auth/sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Close Periods
GET /close-periods: List close periods with status, dates, and completion metrics.
curl --request GET \
--url https://api.supergood.ai/integrations/<integration_id>/close-periods \
--header 'Authorization: Bearer <authToken>'
Example response
[
{
"periodId": "per_2024_12",
"name": "December 2024",
"startDate": "2024-12-01",
"endDate": "2024-12-31",
"status": "in_progress",
"locked": false,
"percentComplete": 68,
"counts": {
"tasks": { "total": 124, "completed": 84 },
"reconciliations": { "total": 57, "approved": 31 }
},
"erp": "netsuite"
},
{
"periodId": "per_2025_01",
"name": "January 2025",
"startDate": "2025-01-01",
"endDate": "2025-01-31",
"status": "open",
"locked": false,
"percentComplete": 12,
"counts": {
"tasks": { "total": 96, "completed": 11 },
"reconciliations": { "total": 54, "approved": 3 }
},
"erp": "sage_intacct"
}
]
Reconciliations
GET /reconciliations?periodId={periodId}: Retrieve reconciliation records for a period, including account details, balances, ownership, and exceptions.
curl --request GET \
--url "https://api.supergood.ai/integrations/<integration_id>/reconciliations?periodId=per_2024_12" \
--header 'Authorization: Bearer <authToken>'
Example response
[
{
"reconciliationId": "rec_fq_1001",
"account": {
"glNumber": "1000",
"name": "Cash - Operating",
"currency": "USD"
},
"beginBalance": 528342.19,
"endBalance": 512904.64,
"difference": -15437.55,
"status": "in_review",
"preparer": { "userId": "u_fq_92aa", "name": "Alex Kim" },
"reviewer": { "userId": "u_fq_73bb", "name": "Morgan Shah" },
"dueDate": "2025-01-05",
"exceptions": [
{ "code": "BANK_TIMING", "message": "Deposit in transit not posted" },
{ "code": "UNCLEARED_CHECKS", "message": "Five outstanding checks" }
],
"evidence": [
{ "attachmentId": "att_7741", "fileName": "Dec24_BankStmt.pdf", "uploadedAt": "2025-01-02T14:12:33Z" }
]
},
{
"reconciliationId": "rec_fq_2005",
"account": {
"glNumber": "1200",
"name": "Accounts Receivable",
"currency": "USD"
},
"beginBalance": 242189.01,
"endBalance": 251903.44,
"difference": 9714.43,
"status": "prepared",
"preparer": { "userId": "u_fq_11cc", "name": "Sam Lee" },
"reviewer": null,
"dueDate": "2025-01-07",
"exceptions": [],
"evidence": []
}
]
Evidence Uploads
POST /reconciliations/{reconciliationId}/evidence: Upload supporting documents to a reconciliation. Supports direct file content or remote URLs.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/reconciliations/rec_fq_1001/evidence \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"attachment": {
"name": "Dec24_BankReconciliation.xlsx",
"mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"contentBase64": "UEsDB...",
"checksum": "sha256:22b0c8...",
"category": "bank_reconciliation",
"notes": "Includes reconciling items and preparer sign-off"
},
"referenceId": "evid-req-8892"
}'
Example response
{
"attachmentId": "att_7812",
"reconciliationId": "rec_fq_1001",
"uploadedAt": "2025-01-03T09:42:17Z",
"name": "Dec24_BankReconciliation.xlsx"
}
Tasks
POST /tasks: Create or upsert a checklist task within a close period and assign it to a user.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/tasks \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"periodId": "per_2024_12",
"title": "Review Cash Variance over $10k",
"category": "cash",
"assigneeUserId": "u_fq_73bb",
"dueDate": "2025-01-04",
"dependencies": ["rec_fq_1001"],
"initialStatus": "not_started",
"referenceId": "task-ops-3129"
}'
Example response
{
"taskId": "task_fq_5521",
"periodId": "per_2024_12",
"status": "not_started",
"createdAt": "2025-01-02T19:11:05Z",
"referenceId": "task-ops-3129"
}
Technical Specifications
- Authentication: Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
- Response format: JSON with consistent resource schemas and pagination across periods, accounts, tasks, and evidence
- Rate limits: Tuned for enterprise throughput while honoring licensing and usage controls
- Session management: Automatic reauth and cookie/session rotation with health checks
- Data freshness: Near real-time retrieval of close statuses, reconciliations, and attachments
- Security: Encrypted transport, scoped tokens, and audit logging; respects FloQast entitlements and role-based permissions
- Webhooks: Optional asynchronous delivery for status changes, sign-offs, and request completions
Performance Characteristics
- Latency: Sub-second responses for list/detail queries under normal load
- Throughput: Designed for high-volume month-end operations and batch evidence uploads
- Reliability: Retry logic, backoff, and idempotency keys minimize duplicate actions
- Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened FloQast adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as FloQast evolves.
Frequently Asked Questions
Q: Which FloQast products can this integration cover?
Supergood supports workflows across Close Management, Reconciliations, Flux/Variance Analysis, and Request Management (subject to your licensing and entitlements). We scope coverage during integration assessment.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Q: Can I lock or reopen close periods via the API?
We align with portal governance and your permissions. Actions that modify lock states are available only when your account enables them, and we enforce safe-guard rails to prevent unintended changes.
Q: How do you normalize accounts and balances across ERPs?
We standardize GL metadata, balances, and reconciliation states across NetSuite, Sage Intacct, and Microsoft Dynamics 365 so downstream systems don’t need to handle ERP-specific schemas.
Q: Can you upload Excel workbooks and PDFs as evidence?
Yes. We support large file uploads, checksum validation, and metadata tagging (category, notes) with audit logging for retention policies.
Related Integrations
Dow Jones Risk & Compliance API - Programmatically access Dow Jones Risk & Compliance with Supergood
Ready to automate your FloQast workflows?
Supergood can have your FloQast integration live in days with no ongoing engineering maintenance.
