Skip to main content
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"
  }'
PropertyValue
AuthRequired
Required scopeCaller must own the product
Cost10 credits
IdempotentYes (second call returns the existing artifact)

​
Body

FieldTypeRequiredNotes
productIdstringyesProduct the quarter belongs to.
periodstringyesFormat: 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

StatusCodeWhen
401AUTH_REQUIREDNo session.
402CREDIT_EXHAUSTEDNo credits.
403ONBOARDING_REQUIREDActivation contract not complete.
404Quarter not closedGET on a quarter that hasn’t been closed.
500INTERNAL_ERRORGeneration or write failed.