Subjects

Results keyed by your own external user id.

Get latest results for one of your users

GET

https://api.becomingyou.com

/v1/{product}/subjects/{externalId}/results

Get latest results for one of your users › path Parameters

product

string · enum · required

Assessment product identifier.

Enum values:

values-bridge

externalId

string · required

Your own external user identifier for this end user.

Get latest results for one of your users › Responses

Latest completed results for the subject.

SubjectResults

object

sessionId

string · uuid

completedAt

string | null · date-time

NullableValuesBridgeResults

Scored results, or null when the session has not been scored yet.

GET/v1/{product}/subjects/{externalId}/results

curl https://api.becomingyou.com/v1/:product/subjects/:externalId/results \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "subject": {
    "externalId": "externalId"
  },
  "sessionId": "00000000-0000-0000-0000-000000000000",
  "completedAt": "2024-08-25T15:00:00Z",
  "results": {
    "overall": {
      "archetypeId": 0,
      "totalAuthenticityGapScaled": 0,
      "totalConflictScoreScaled": 0,
      "totalHarmonyScoreScaled": 0
    },
    "values": [
      {
        "valueId": 0,
        "idealDisplayRank": 0,
        "idealRankTier": "core",
        "currentDisplayRank": 0,
        "currentRankTier": "core",
        "authenticityGapScaled": 0
      }
    ],
    "pairings": [
      {
        "valuePairingId": 0,
        "scaledScore": 0
      }
    ]
  }
}

json

application/json

Sessions

Becoming You Labs Partner API