> ## Documentation Index > Fetch the complete documentation index at: https://docs.revcenter.ai/llms.txt > Use this file to discover all available pages before exploring further. # Why the list looks as it does > How a search's people score now: the cut-off, people per score band, how many are shortlisted, why the rest were rejected, which must-haves profiles fail to show, and the best people just under the cut-off. Read it before preview_scoring: it says whether the cut-off, a must-have or a weight is what keeps the list short. Does not use credits. Needs scope `searches:read`. ## OpenAPI ````yaml /openapi.json get /searches/{searchId}/scoring openapi: 3.1.0 info: title: Revcenter API version: v1 description: >- Projects, searches, scored candidates and shortlists. Generated from the agent API's registry. servers: - url: https://api.revcenter.ai/v1 security: - bearer: [] tags: - name: Login - name: Account - name: Actions - name: Reference - name: Projects - name: Searches - name: Scoring - name: Shortlists - name: Candidates - name: Webhooks - name: Health paths: /searches/{searchId}/scoring: get: tags: - Scoring summary: Why the list looks as it does description: >- How a search's people score now: the cut-off, people per score band, how many are shortlisted, why the rest were rejected, which must-haves profiles fail to show, and the best people just under the cut-off. Read it before preview_scoring: it says whether the cut-off, a must-have or a weight is what keeps the list short. Does not use credits. Needs scope `searches:read`. operationId: get_scoring_diagnostics parameters: - name: searchId in: path required: true description: A search id schema: type: string responses: '200': description: OK headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer content: application/json: schema: type: object properties: data: type: object properties: search_id: type: string floors: type: object analyzed: type: integer unscored: type: integer enriched: type: integer shortlisted: type: integer bands: type: array items: type: object rejected: type: integer rejectReasons: type: array items: type: object mustHaves: type: object nearMisses: type: array items: type: object weights: type: object meta: $ref: '#/components/schemas/Meta' example: data: search_id: 0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 floors: qualified: 85 shortlist: 80 custom: false analyzed: 212 unscored: 0 enriched: 212 shortlisted: 14 bands: - label: 85+ min: 85 max: null count: 9 big4: current: 0 past: 2 - label: 80–84 min: 80 max: 84 count: 5 big4: current: 0 past: 1 rejected: 61 rejectReasons: - code: GEO_OUT label: outside the target area count: 33 underFloorReasons: [] mustHaves: gate: true items: - requirement: CPA missing: 48 of: 212 nearMisses: - candidateId: 3c2b1a09-8f7e-4d6c-9b5a-4e3d2c1b0a99 name: Dana Whitfield roleTitle: Plant Controller company: Garden State Foods profileUrl: https://www.linkedin.com/in/example score: 78 weights: title: 0.3 geo: 0.2 years: 0.15 seniority: 0.1 skills: 0.15 industry: 0.1 outsideLocation: 40 preferredEmployer: current: 0 past: 3 belowCutoff: count: 22 pointsLost: - dimension: skills points: 6.2 meta: request_id: req_01JABCDEF '400': $ref: '#/components/responses/Error' '401': $ref: '#/components/responses/Error' '402': $ref: '#/components/responses/Error' '403': $ref: '#/components/responses/Error' '404': $ref: '#/components/responses/Error' '409': $ref: '#/components/responses/Error' '429': $ref: '#/components/responses/Error' '500': $ref: '#/components/responses/Error' '503': $ref: '#/components/responses/Error' components: schemas: Meta: type: object properties: request_id: type: string total: type: integer description: On lists that count everything that matched. Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: 'Stable: every code is on the Errors page.' message: type: string details: type: - object - 'null' description: >- Structured specifics, when there are any (for example retry_after_seconds). request_id: type: string meta: $ref: '#/components/schemas/Meta' example: error: code: search_not_found message: No search with that id in this workspace. details: null request_id: req_01JABCDEF meta: request_id: req_01JABCDEF responses: Error: description: 'An error: one envelope everywhere. A 429 carries Retry-After.' headers: X-RateLimit-Limit: description: >- Requests allowed this minute (the tighter of the key's and the workspace's). schema: type: integer X-RateLimit-Remaining: description: Requests left this minute. schema: type: integer X-RateLimit-Reset: description: When the minute resets, in Unix seconds. schema: type: integer Retry-After: description: Seconds to wait (on 429 and 503). schema: type: integer content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearer: type: http scheme: bearer description: An API key from Settings → Usage → API (rvc_live_…). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.