> ## Documentation Index > Fetch the complete documentation index at: https://docs.pipecorn.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve the details of a Search > Returns a specific search and its leads by ID. ## Search Status The search object includes a `status` field that indicates the current state of the search operation. The possible status values are: ### Active Statuses * **`NOT_STARTED`**: The search has been created but has not yet begun processing * **`ONGOING`**: The search is currently being processed and generating results * **`FINISHED`**: The search has completed successfully and all results are available ### Error Statuses * **`RATE_LIMITED`**: The search was interrupted due to rate limiting constraints * **`UNAUTHORIZED`**: The search failed due to authentication issues * **`FORBIDDEN`**: The search failed due to insufficient permissions * **`ERROR`**: The search encountered an error during processing When a search has a status of `FINISHED`, all leads are available and ready to be retrieved. For searches with error statuses, you may need to retry the search or check your API credentials and permissions. ## OpenAPI ````yaml GET /searches/{id} openapi: 3.0.1 info: title: Pipecorn List API description: Pipecorn List API license: name: MIT version: 1.0.0 servers: - url: https://app.pipecorn.com/api/v2/ security: - defaultApiKey: [] paths: /searches/{id}: get: summary: Retrieve a specific search description: Returns a specific search and its leads by ID. parameters: - name: id in: path required: true description: ID of the search to retrieve schema: type: string format: uuid - name: status in: query required: false description: Filter leads by their qualification status schema: type: string enum: - qualified - disqualified responses: '200': description: A search object with its leads content: application/json: schema: type: object properties: search: $ref: '#/components/schemas/SearchDetail' leads: type: array items: $ref: '#/components/schemas/Lead' '429': description: Rate limit exceeded (1 request per second) content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: SearchDetail: type: object properties: uuid: type: string format: uuid description: The unique identifier for the search name: type: string description: The name of the search status: type: string enum: - finished - not_started - ongoing - rate_limited - unauthorized - forbidden - error description: The current status of the search results_ready: type: boolean description: >- Whether the search has finished and its leads are available. When false, the leads array is omitted. Lead: type: object properties: lead: type: object properties: status: type: string enum: - QUALIFIED - DISQUALIFIED description: Current qualification status of the lead rejection_reasons: type: array items: type: string description: Reasons for rejection if disqualified first_name: type: string description: First name of the lead last_name: type: string description: Last name of the lead gender: type: string nullable: true description: Gender of the lead email: type: string nullable: true description: Most probable email address email_status: type: string nullable: true description: Deliverability status of the email (e.g. Valid, Catch-all) phone: type: array items: type: object description: List of phone number records linkedin_url: type: string format: uri nullable: true description: LinkedIn profile URL linkedin_id_url: type: string format: uri nullable: true description: LinkedIn profile URL built from the member's stable id profile_image_url: type: string format: uri nullable: true description: Profile image URL location: type: string nullable: true description: Location of the lead title: type: string nullable: true description: Job title of the lead lk_headline: type: string nullable: true description: LinkedIn headline hire_type: type: string enum: - new_hire - promoted nullable: true description: >- Whether the lead recently joined the company (new_hire) or was promoted within it current_position: type: object nullable: true description: The lead's current position previous_position: type: object nullable: true description: The lead's previous position positions: type: array items: type: object nullable: true description: The lead's position history years_in_position: type: integer description: Years in current position (0 when unknown) months_in_position: type: integer description: Months in current position (0 when unknown) years_in_company: type: integer description: Years in current company (0 when unknown) months_in_company: type: integer description: Months in current company (0 when unknown) company: type: object properties: name: type: string nullable: true description: Company name cleaned_name: type: string nullable: true description: Cleaned company name website: type: string format: uri nullable: true description: Company website location: type: string nullable: true description: Company location industry: type: string nullable: true description: Company industry headquarters: type: object nullable: true description: >- Company headquarters details (returned only when available as structured data) description: type: string nullable: true description: Company description linkedin_url: type: string format: uri nullable: true description: Company LinkedIn profile URL linkedin_id: type: string nullable: true description: Company LinkedIn identifier employee_range: type: string nullable: true description: Company employee count range company_profile_picture: type: string format: uri nullable: true description: Company profile picture URL Error: required: - error - message type: object properties: error: type: integer format: int32 message: type: string securitySchemes: defaultApiKey: type: apiKey in: header description: Your API key name: X-API-KEY ````