Skip to main content
POST
/
v1
/
scorecard-templates
/
search
Search scorecard templates
curl --request POST \
  --url https://api.stardex.ai/v1/scorecard-templates/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offset": 0,
  "limit": 100,
  "keywords": [
    "<string>"
  ],
  "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "include_org_wide": false,
  "created_by_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "is_archived": false,
  "sort_by": "created_at",
  "sort_order": "desc"
}
'
{
  "success": true,
  "data": [
    {
      "id": "aaaa1111-2222-3333-4444-555555555555",
      "name": "Senior Backend Engineer Scorecard",
      "description": "Interview rubric for senior backend engineering candidates.",
      "job_id": "456e7890-e12b-34d5-a678-901234567890",
      "rating_scale": 5,
      "enable_ai_auto_grade": false,
      "is_archived": false,
      "overall_default_text": "Summarize the candidate against the must-have criteria first, then list any concerns.",
      "created_by": {
        "id": "567e8901-e23c-45d6-e789-012345678901",
        "first_name": "Jane",
        "last_name": "Smith"
      },
      "created_at": "2026-05-20T10:00:00Z",
      "updated_at": "2026-05-20T10:00:00Z",
      "criteria": [
        {
          "id": "bbbb1111-2222-3333-4444-555555555555",
          "name": "System design depth",
          "description": "Can the candidate reason about consistency, partitioning, and failure modes for a multi-region service?",
          "importance": "must_have",
          "position": 1,
          "is_archived": false,
          "default_text": "Note specific systems they have built, scale handled, and trade-offs discussed."
        },
        {
          "id": "cccc1111-2222-3333-4444-555555555555",
          "name": "Async collaboration",
          "description": "Quality of written communication and decision logs.",
          "importance": "nice_to_have",
          "position": 2,
          "is_archived": false,
          "default_text": null
        }
      ]
    }
  ],
  "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
​
keywords
string[]

Case-insensitive substring match on template name or description.

​
job_id
string<uuid>

Return only templates scoped to this job UUID. Pair with include_org_wide to also include org-wide templates.

​
include_org_wide
boolean
default:false

When true and job_id is provided, also return org-wide (job_id IS NULL) templates. Defaults to false.

​
created_by_ids
string<uuid>[]

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

​
is_archived
boolean
default:false

Filter by archived status. Defaults to false (active templates only).

​
sort_by
enum<string>
default:created_at

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

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

Sort direction. Defaults to desc.

Available options:
asc,
desc

Response

Scorecard templates found

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