> ## 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. # Read a search's conversation > The project's assistant conversation in the app, oldest first, and any scoring change it proposed for this search that nobody has applied yet, with what applying it would do to the shortlist. messages is what people and the project's assistant wrote in Revcenter (the latest 200), each with its role, text and the search it was about. pending_change is null unless the assistant proposed a cut-off, weight or requirement change for this search that would move someone and that hasn't been applied or discarded; its preview counts the shortlist before and after. To make a change yourself, use preview_scoring and apply_scoring. thread_id is null when nobody has written in the project's conversation yet. Does not use credits. Needs scope `searches:read`. ## OpenAPI ````yaml /openapi.json get /searches/{searchId}/thread 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}/thread: get: tags: - Searches summary: Read a search's conversation description: >- The project's assistant conversation in the app, oldest first, and any scoring change it proposed for this search that nobody has applied yet, with what applying it would do to the shortlist. messages is what people and the project's assistant wrote in Revcenter (the latest 200), each with its role, text and the search it was about. pending_change is null unless the assistant proposed a cut-off, weight or requirement change for this search that would move someone and that hasn't been applied or discarded; its preview counts the shortlist before and after. To make a change yourself, use preview_scoring and apply_scoring. thread_id is null when nobody has written in the project's conversation yet. Does not use credits. Needs scope `searches:read`. operationId: get_search_thread 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 project_id: type: - string - 'null' thread_id: type: - string - 'null' messages: type: array items: type: object properties: id: type: string role: type: string enum: - user - assistant - system content: type: string search_id: type: - string - 'null' created_at: type: string format: date-time pending_change: type: - object - 'null' properties: criteria_version_id: type: string explanation: type: - string - 'null' created_at: type: string format: date-time preview: type: object properties: shortlist_before: type: integer shortlist_after: type: integer entering: type: integer leaving: type: integer cutoff_before: type: integer cutoff_after: type: integer meta: $ref: '#/components/schemas/Meta' example: data: search_id: 0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 project_id: 6f1c2a0e-3b7d-4c1e-9a52-0d4e8b7c1a11 thread_id: 2a7c9e41-6b3d-4f58-9c0e-1d2f3a4b5c6d messages: - id: 8e1f2a3b-4c5d-4e6f-8a7b-9c0d1e2f3a4b role: user content: Drop anyone without a CPA. search_id: 0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 created_at: '2026-10-17T15:02:11.000Z' - id: 9f2a3b4c-5d6e-4f7a-8b9c-0d1e2f3a4b5c role: assistant content: >- If applied: the shortlist goes from 14 to 11 (−3), at a cut-off of 80. Nothing changes until you apply it. search_id: 0b9e7d6c-5a4f-4e3d-8c2b-1a0f9e8d7c61 created_at: '2026-10-17T15:02:19.000Z' pending_change: criteria_version_id: 4b5c6d7e-8f9a-4b0c-9d1e-2f3a4b5c6d7e explanation: Make a CPA a must-have. created_at: '2026-10-17T15:02:19.000Z' preview: shortlist_before: 14 shortlist_after: 11 entering: 0 leaving: 3 cutoff_before: 80 cutoff_after: 80 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.