Skip to main content
POST
/
v1
/
scorecards
/
search
Search scorecards
curl --request POST \
  --url https://api.stardex.ai/v1/scorecards/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 0,
  "limit": 100,
  "person_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "candidate_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created_by_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "is_starred": true,
  "sort_by": "created_at",
  "sort_order": "desc"
}
'
{
  "success": true,
  "data": [
    {
      "id": "ddddeeee-1111-2222-3333-444444444444",
      "person_id": "123e4567-e89b-12d3-a456-426614174000",
      "job_id": "456e7890-e12b-34d5-a678-901234567890",
      "candidate_id": "eeeeffff-1111-2222-3333-444444444444",
      "assessment_template_id": "aaaa1111-2222-3333-4444-555555555555",
      "template": {
        "id": "aaaa1111-2222-3333-4444-555555555555",
        "name": "Senior Backend Engineer Scorecard",
        "rating_scale": 5
      },
      "job": {
        "id": "456e7890-e12b-34d5-a678-901234567890",
        "title": "Senior Backend Engineer",
        "company_name": "Acme Inc."
      },
      "created_by": {
        "id": "567e8901-e23c-45d6-e789-012345678901",
        "first_name": "Jane",
        "last_name": "Smith"
      },
      "overall_rating": 4.5,
      "overall_comment": "Strong systems-design depth and excellent async collaboration. Recommend moving forward.",
      "is_starred": true,
      "visible_in_client_share_link": false,
      "criterion_ratings": [
        {
          "id": "cc11aa22-3333-4444-5555-666666666666",
          "criterion_id": "bbbb1111-2222-3333-4444-555555555555",
          "criterion_name": "System design depth",
          "importance": "must_have",
          "position": 1,
          "rating": 5,
          "comment": "Designed a multi-region payments service with clear failure-mode reasoning."
        },
        {
          "id": "cc11aa22-3333-4444-5555-777777777777",
          "criterion_id": "cccc1111-2222-3333-4444-555555555555",
          "criterion_name": "Async collaboration",
          "importance": "nice_to_have",
          "position": 2,
          "rating": 4,
          "comment": "Strong written communication; decision log was thorough."
        }
      ],
      "created_at": "2026-06-01T10:00:00Z",
      "updated_at": "2026-06-01T10:00:00Z"
    }
  ],
  "meta": {
    "total": 1,
    "offset": 0,
    "limit": 100
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json
​
offset
integer | null
default:0

Records to skip for pagination. Defaults to 0.

Required range: x >= 0
​
limit
integer
default:100

Max records per page (1–100). Defaults to 100.

Required range: 1 <= x <= 100
​
person_id
string<uuid>

Return only scorecards for this person UUID.

​
job_id
string<uuid>

Return only scorecards scoped to this job UUID.

​
candidate_id
string<uuid>

Return only scorecards for this candidate UUID.

​
template_id
string<uuid>

Return only scorecards created from this template UUID.

​
created_by_ids
string<uuid>[]

Filter by creator team member UUIDs. Get IDs from GET /v1/team-members.

​
is_starred
boolean

Filter by starred status.

​
sort_by
enum<string>
default:created_at

Column to sort by. One of: created_at (default), updated_at, overall_rating.

Available options:
created_at,
updated_at,
overall_rating
​
sort_order
enum<string>
default:desc

Sort direction. Defaults to desc.

Available options:
asc,
desc

Response

Scorecards found

​
success
enum<boolean>
required
Available options:
true
​
data
object[]
required
​
meta
object
required