Close a quarter

Mark a quarter complete and generate the quarter-close artifact. Locks the period: subsequent score changes don’t retroactively change the close artifact. Used at the end of a planning cycle.

curl -X POST https://app.dacard.ai/api/quarter-close \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "prod_abc",
    "period": "2026-Q1"
  }'

Property	Value
Auth	Required
Required scope	Caller must own the product
Cost	10 credits
Idempotent	Yes (second call returns the existing artifact)

Body

Field	Type	Required	Notes
`productId`	string	yes	Product the quarter belongs to.
`period`	string	yes	Format: `YYYY-Q[1-4]`.

Reading the artifact

curl -X GET "https://app.dacard.ai/api/quarter-close?productId=prod_abc&period=2026-Q1" \
  -H "Authorization: Bearer $DACARD_API_KEY"

GET returns the existing artifact for an already-closed period, or 404 if the quarter isn’t closed yet.

Errors

Status	Code	When
401	`AUTH_REQUIRED`	No session.
402	`CREDIT_EXHAUSTED`	No credits.
403	`ONBOARDING_REQUIRED`	Activation contract not complete.
404	`Quarter not closed`	GET on a quarter that hasn’t been closed.
500	`INTERNAL_ERROR`	Generation or write failed.

Overview

Scoring

Score drilldown

Lifecycle

Products

Teams

Dashboard & Suite

Account & Team

User

Onboarding

Billing

Internal

Agents

Integrations

BYOM

Intelligence

Decisions & Briefings

Saved views

Recommendations

Tribal notes

Credentials

Signals

Anomalies

Outcomes

Feedback

Settings

Webhooks

API Keys

Misc

System

Body

Reading the artifact

Errors

​Body

​Reading the artifact

​Errors

Body

Reading the artifact

Errors