> ## 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. # Expand or continue a search > A live LinkedIn pass for more people on the same role, skipping everyone already found; with search_id, that search continued from where it stopped. A project's passes share its credit limit. Reserves max_credits like a launch. Without search_id: a new pass on the project's first search's criteria, once it has finished. With search_id: the same search's criteria from where it stopped, when it was stopped, interrupted or used its credits and LinkedIn still has people (pages it already read are reused at no cost); a search LinkedIn ran out of is refused with 409 cannot_continue, so expand without search_id instead. A project's searches share a credit limit of three searches' worth at the workspace's per-search limit (3,000 on a trial, 15,000 on a plan at the default 5,000 per search): a cap above what the project has left is held to it, and 409 project_credit_limit is returned when less than 250 is left. One pass at a time per project (409 search_running). Send an Idempotency-Key: a retry with the same key returns the same pass. Reserves up to max_credits credits (by default the workspace's most per search: 1,000 on a trial, 5,000 on a plan unless its admins set another); unused credits are refunded. Needs scope `searches:write`. ## OpenAPI ````yaml /openapi.json post /projects/{projectId}/expand 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: /projects/{projectId}/expand: post: tags: - Searches summary: Expand or continue a search description: >- A live LinkedIn pass for more people on the same role, skipping everyone already found; with search_id, that search continued from where it stopped. A project's passes share its credit limit. Reserves max_credits like a launch. Without search_id: a new pass on the project's first search's criteria, once it has finished. With search_id: the same search's criteria from where it stopped, when it was stopped, interrupted or used its credits and LinkedIn still has people (pages it already read are reused at no cost); a search LinkedIn ran out of is refused with 409 cannot_continue, so expand without search_id instead. A project's searches share a credit limit of three searches' worth at the workspace's per-search limit (3,000 on a trial, 15,000 on a plan at the default 5,000 per search): a cap above what the project has left is held to it, and 409 project_credit_limit is returned when less than 250 is left. One pass at a time per project (409 search_running). Send an Idempotency-Key: a retry with the same key returns the same pass. Reserves up to max_credits credits (by default the workspace's most per search: 1,000 on a trial, 5,000 on a plan unless its admins set another); unused credits are refunded. Needs scope `searches:write`. operationId: expand_search parameters: - name: projectId in: path required: true description: A project id schema: type: string requestBody: required: false content: application/json: schema: type: object properties: max_credits: type: integer minimum: 250 maximum: 20000 description: >- The most this search may use, in credits: reserved now, charged for the results pages and profile reads it buys, and the rest refunded when it finishes. Leave it out to use the workspace's most per search. Held to that most (1,000 on a trial; on a plan 5,000 unless the workspace's admins set another) and to the credits left; credits_reserved and credits_note say when it was held. At least 250: a smaller cap can't buy one page of results and read it. Send the amount the person names; any whole number in range works. search_id: type: string description: >- Continue this search (one of the project's) from where it stopped, on its own criteria. Leave it out for a new pass on the first search's criteria. example: max_credits: 1000 responses: '202': description: Accepted 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: {} meta: $ref: '#/components/schemas/Meta' example: data: search_id: 7d2e4f1a-0c3b-4a5d-9e8f-6b1c2d3e4f52 credits_reserved: 1000 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' '413': $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 → Integrations → API (rvc_live_…). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.