Skip to main content
POST
/
api
/
signal-score
Generate a Signal Card
curl --request POST \
  --url https://app.dacard.ai/api/signal-score \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayName": "Sarah K.",
  "functionId": "pm",
  "level": "associate",
  "openEndedResponse": "<string>",
  "practiceSelections": [
    "<string>"
  ],
  "confidenceRatings": {
    "data_driven_decisions": 4,
    "cross_functional_alignment": 3,
    "technical_depth": 5,
    "customer_empathy": 4,
    "strategic_clarity": 3
  }
}
'
{
  "card": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "displayName": "<string>",
    "functionId": "<string>",
    "level": "<string>",
    "totalScore": 123,
    "normalizedScore": 50,
    "stageName": "<string>",
    "dimensions": [
      {
        "dimensionId": "<string>",
        "dimensionName": "<string>",
        "score": 50,
        "stageName": "<string>"
      }
    ],
    "narrative": "<string>",
    "peerPercentile": 50
  },
  "shareId": "<string>",
  "shareUrl": "/c/abc123xyz"
}

Body

application/json
​
displayName
string
required

Display name shown on the Signal Card (1-50 characters)

Maximum string length: 50
Example:

"Sarah K."

​
functionId
enum<string>
required

Job function of the respondent

Available options:
pm,
design,
engineering,
data,
operations,
gtm
​
level
enum<string>
required

Seniority level of the respondent

Available options:
associate,
mid,
senior,
staff,
lead
​
openEndedResponse
string
required

Description of a recent product decision (40+ characters)

Minimum string length: 40
​
practiceSelections
string[]
required

6-8 practice IDs selected from the assessment question bank

Required array length: 6 - 8 elements
​
confidenceRatings
object
required

Map of 5 confidence area IDs to ratings (1-5)

Example:
{
  "data_driven_decisions": 4,
  "cross_functional_alignment": 3,
  "technical_depth": 5,
  "customer_empathy": 4,
  "strategic_clarity": 3
}

Response

Signal Card generated

​
card
object
required
​
shareId
string
required

Unique share token for the card

​
shareUrl
string
required

Relative URL to the shareable card page

Example:

"/c/abc123xyz"