> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # Search scorecard templates > Search and filter scorecard templates (the assessment rubrics used to score candidates) with pagination and sorting. **Filters**: `keywords` (substring match on name or description), `job_id` (return templates scoped to a specific job — pair with `include_org_wide` to also include org-wide templates), `created_by_ids` (team members who created the template), `is_archived` (defaults to false). **Sorting**: `sort_by` — `created_at` (default), `updated_at`, or `name`. `sort_order` — `asc` or `desc` (default). **Pagination**: `offset` and `limit` (max 100). ## OpenAPI ````yaml /api-reference/openapi-v1.json post /v1/scorecard-templates/search openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. paths: /v1/scorecard-templates/search: post: tags: - Scorecards summary: Search scorecard templates description: >- Search and filter scorecard templates (the assessment rubrics used to score candidates) with pagination and sorting. **Filters**: `keywords` (substring match on name or description), `job_id` (return templates scoped to a specific job — pair with `include_org_wide` to also include org-wide templates), `created_by_ids` (team members who created the template), `is_archived` (defaults to false). **Sorting**: `sort_by` — `created_at` (default), `updated_at`, or `name`. `sort_order` — `asc` or `desc` (default). **Pagination**: `offset` and `limit` (max 100). operationId: searchScorecardTemplates requestBody: content: application/json: schema: $ref: '#/components/schemas/ScorecardTemplatesSearchBody' responses: '200': description: Scorecard templates found content: application/json: schema: $ref: '#/components/schemas/ScorecardTemplatesSearchResponse' example: 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 '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. required: - code - message required: - success - error components: schemas: ScorecardTemplatesSearchBody: type: object properties: offset: type: - integer - 'null' minimum: 0 default: 0 description: Records to skip for pagination. Defaults to 0. limit: type: integer minimum: 1 maximum: 100 default: 100 description: Max records per page (1–100). Defaults to 100. keywords: type: array items: type: string description: Case-insensitive substring match on template name or description. job_id: type: string format: uuid description: >- Return only templates scoped to this job UUID. Pair with include_org_wide to also include org-wide templates. include_org_wide: type: boolean default: false description: >- When true and job_id is provided, also return org-wide (job_id IS NULL) templates. Defaults to false. created_by_ids: type: array items: type: string format: uuid description: >- Filter by creator team member UUIDs. Get IDs from GET /v1/team-members. is_archived: type: boolean default: false description: >- Filter by archived status. Defaults to false (active templates only). sort_by: type: string enum: - created_at - updated_at - name default: created_at description: 'Column to sort by. One of: created_at (default), updated_at, name.' sort_order: type: string enum: - asc - desc default: desc description: Sort direction. Defaults to desc. ScorecardTemplatesSearchResponse: type: object properties: success: type: boolean enum: - true data: type: array items: $ref: '#/components/schemas/ScorecardTemplate' meta: type: object properties: total: type: number description: Total matching records across all pages. offset: type: number description: Current pagination offset. limit: type: number description: Page size used for this request. required: - total - offset - limit required: - success - data - meta ScorecardTemplate: type: object properties: id: type: string format: uuid description: Scorecard template UUID. name: type: string description: Template name shown to raters. description: type: - string - 'null' description: Optional template description. job_id: type: - string - 'null' format: uuid description: >- Job UUID this template is scoped to. Null for org-wide templates. Only one active (non-archived) template can exist per job. rating_scale: type: integer description: 'Star rating scale. Must be one of: 3, 4, 5 (default), or 10.' enable_ai_auto_grade: type: boolean description: >- When true, the AI copilot can auto-grade candidates against this template. is_archived: type: boolean description: Archived templates are hidden from selection. overall_default_text: type: - string - 'null' description: >- Default note text pre-filled in the overall summary section when raters score with this template. created_by: allOf: - $ref: '#/components/schemas/ScorecardCreator' - type: - object - 'null' description: Team member who created the template. created_at: type: string description: ISO 8601 creation timestamp. updated_at: type: string description: ISO 8601 last-updated timestamp. criteria: type: array items: $ref: '#/components/schemas/ScorecardTemplateCriterion' description: >- Criteria attached to the template, sorted by position ascending. Includes archived criteria (use is_archived to filter). required: - id - name - description - job_id - rating_scale - enable_ai_auto_grade - is_archived - overall_default_text - created_by - created_at - updated_at - criteria ScorecardCreator: type: object properties: id: type: string format: uuid description: Team member UUID. first_name: type: - string - 'null' description: First name. last_name: type: - string - 'null' description: Last name. required: - id - first_name - last_name ScorecardTemplateCriterion: type: object properties: id: type: string format: uuid description: Criterion UUID. name: type: string description: Criterion display name. description: type: - string - 'null' description: Optional longer description shown to raters. importance: type: string enum: - must_have - nice_to_have description: 'Weighting: must_have or nice_to_have.' position: type: number description: Sort order. Lower values are displayed first. is_archived: type: boolean description: Archived criteria are hidden from the UI. default_text: type: - string - 'null' description: Default note text pre-filled when raters open this criterion. required: - id - name - description - importance - position - is_archived - default_text securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ````