> ## Documentation Index > Fetch the complete documentation index at: https://docs.pixiegtm.com/llms.txt > Use this file to discover all available pages before exploring further. # Query reviewed Lead Finder enrichment values > Query reviewed Lead Finder enrichment values **CLI:** ```bash theme={null} pixie lead-finder result query create --id pixie lead-finder result query create --id --q --predicates --sort --cursor --limit ``` ## Overview Query reviewed Lead Finder enrichment values This page documents `post /api/lead-finder/{id}/results/query`. Use the request and response sections on this page for accepted parameters, payload fields, response fields, and authentication behavior. ## AI agent notes * Confirm the operation matches the user's intent before calling it. * For write operations, confirm the user intends to change state. * Surface validation, permission, and not-found errors instead of retrying unchanged. ## OpenAPI ````yaml post /api/lead-finder/{id}/results/query openapi: 3.0.3 info: title: Pixie API version: 1.0.0 description: >- HTTP API for the Pixie GTM platform - Lead Finder search preparation, campaign-backed Outbound execution, Pixie Agent runs, sender management, and Unibox reply workflows. Designed for operation by both humans and autonomous AI agents. Agents should start at the [Agent Playbook](/guides/agent-playbook) which prescribes a workspace-context check (`GET /api/context`) and core user journeys with exact call ordering. contact: name: Pixie Support url: https://pixie.ai servers: - url: https://app.pixie.ai description: Production security: - bearerAuth: [] tags: - name: Campaigns description: >- Campaign-backed Outbound execution. These endpoints manage draft, launching, active, paused, and completed Outbound runs with sequence nodes, contacts, and sender accounts. - name: Accounts description: Signed-in user account, settings, and workspace context endpoints. - name: Billing description: Billing customer portal and account billing endpoints. - name: Senders description: >- Connected sender accounts, email inboxes, sending domains, DNS verification, warmup, and sender capacity. paths: /api/lead-finder/{id}/results/query: post: tags: - Lead Finder summary: Query reviewed Lead Finder enrichment values description: Query reviewed Lead Finder enrichment values operationId: leadFinder.queryResults parameters: - name: id in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object properties: q: type: string maxLength: 128 predicates: default: [] maxItems: 5 type: array items: type: object properties: path: type: string minLength: 1 maxLength: 128 operator: type: string enum: - contains - eq - gt - gte - lt - lte value: anyOf: - type: string maxLength: 512 - type: number - type: boolean required: - path - operator - value additionalProperties: false sort: default: score_desc type: string enum: - score_desc cursor: type: string minLength: 1 maxLength: 1024 limit: default: 25 type: integer minimum: 1 maximum: 100 required: - predicates - sort - limit additionalProperties: false responses: '200': description: Filtered Lead Finder results. content: application/json: schema: type: object properties: search: type: object properties: searchId: type: string format: uuid title: type: string description: type: string kind: type: string enum: - recurring - static surface: type: string enum: - lead-finder definitionHash: type: string minLength: 64 maxLength: 64 nullable: true intent: type: string sellerContext: type: string sourcePlans: type: array items: type: object properties: sourceId: type: string enum: - linkedin_people query: minItems: 1 type: array items: type: string minLength: 1 maxLength: 240 reason: type: string minLength: 1 maxLength: 240 resultTarget: oneOf: - type: object properties: mode: type: string enum: - count count: type: integer exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 required: - mode - count additionalProperties: false - type: object properties: mode: type: string enum: - all required: - mode additionalProperties: false recurrence: type: string enum: - finite - monitoring geography: type: object properties: mode: type: string enum: - explicit countryCodes: minItems: 1 type: array items: type: string description: >- String value with endpoint-specific validation. cityNames: type: array items: type: string minLength: 1 required: - mode - countryCodes additionalProperties: false companySize: type: object properties: min: type: integer minimum: 0 maximum: 9007199254740991 max: type: integer minimum: 0 maximum: 9007199254740991 additionalProperties: false personCriteria: minItems: 1 maxItems: 12 type: array items: type: object properties: id: type: string maxLength: 60 description: >- String value with endpoint-specific validation. kind: type: string enum: - current_title values: minItems: 1 maxItems: 12 type: array items: type: string minLength: 1 maxLength: 120 required: - id - kind - values additionalProperties: false unresolvedPreferences: maxItems: 3 type: array items: type: string minLength: 1 maxLength: 240 companyCriteria: description: >- Every separate entry is AND-combined and must pass. Put OR alternatives in one criterion value instead of separate entries. maxItems: 12 type: array items: type: object properties: id: type: string maxLength: 60 description: >- String value with endpoint-specific validation. kind: type: string enum: - business_model - customer_type - offering - industry - exclusion - other operator: type: string enum: - is - is_not value: type: string minLength: 1 maxLength: 120 required: - id - kind - operator - value additionalProperties: false rankedCompanyCohort: oneOf: - type: object properties: kind: type: string enum: - default limit: type: integer exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - named - attached sourceId: type: string minLength: 1 maxLength: 120 limit: type: integer exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 required: - kind - sourceId additionalProperties: false - type: object properties: kind: type: string enum: - metric metric: type: string enum: - revenue - market_cap limit: type: integer exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 required: - kind - metric additionalProperties: false required: - sourceId - query - reason additionalProperties: false details: type: object properties: channel: type: string signal: type: string expectedLead: type: string whyThisShouldWork: type: string plannerAssumedPreferences: type: array items: type: string additionalProperties: false lastRunId: type: string format: uuid nullable: true leadCount: type: integer minimum: 0 maximum: 9007199254740991 resultCount: type: integer minimum: 0 maximum: 9007199254740991 contactedCount: type: integer minimum: 0 maximum: 9007199254740991 createdAt: type: string updatedAt: type: string required: - searchId - title - description - kind - surface - definitionHash - intent - sellerContext - sourcePlans - details - lastRunId - leadCount - resultCount - contactedCount - createdAt - updatedAt additionalProperties: false query: type: object properties: q: type: string nullable: true predicates: type: array items: type: object properties: path: type: string minLength: 1 maxLength: 128 operator: type: string enum: - contains - eq - gt - gte - lt - lte value: anyOf: - type: string maxLength: 512 - type: number - type: boolean required: - path - operator - value additionalProperties: false sort: type: string enum: - score_desc required: - q - predicates - sort additionalProperties: false results: type: array items: type: object properties: resultId: type: string format: uuid searchId: type: string format: uuid sourceId: type: string enum: - linkedin_people leadId: type: string format: uuid title: type: string entityPerson: type: string nullable: true entityCompany: type: string nullable: true score: type: integer minimum: -9007199254740991 maximum: 9007199254740991 createdAt: type: string lead: type: object properties: firstName: type: string lastName: type: string fullName: type: string email: type: string phoneNumber: type: string linkedinUrl: type: string title: type: string companyName: type: string companyDomain: type: string additionalProperties: false nullable: true enrichmentSummary: type: object properties: status: type: string enum: - available - missing - failed - truncated - unsupported_schema schemaVersion: type: integer exclusiveMinimum: true maximum: 9007199254740991 nullable: true minimum: 0 observedAt: type: string nullable: true fieldCount: type: integer minimum: 0 maximum: 9007199254740991 required: - status - schemaVersion - observedAt - fieldCount additionalProperties: false required: - resultId - searchId - sourceId - leadId - title - entityPerson - entityCompany - score - createdAt - lead - enrichmentSummary additionalProperties: false pagination: type: object properties: total: type: integer minimum: 0 maximum: 9007199254740991 limit: type: integer exclusiveMinimum: true maximum: 9007199254740991 minimum: 0 hasMore: type: boolean nextCursor: type: string nullable: true required: - total - limit - hasMore - nextCursor additionalProperties: false required: - search - query - results - pagination additionalProperties: false '400': description: Invalid filter. content: application/json: schema: type: object properties: error: type: string message: type: string sourceId: type: string code: type: string alternatives: type: array items: type: string retryable: type: boolean alert: type: boolean action: type: object properties: type: type: string enum: - navigate label: type: string href: type: string required: - type - label - href additionalProperties: false required: - error additionalProperties: false '401': description: Unauthorized. content: application/json: schema: type: object properties: error: type: string message: type: string sourceId: type: string code: type: string alternatives: type: array items: type: string retryable: type: boolean alert: type: boolean action: type: object properties: type: type: string enum: - navigate label: type: string href: type: string required: - type - label - href additionalProperties: false required: - error additionalProperties: false '403': description: Insufficient API key scope. content: application/json: schema: type: object properties: error: type: string message: type: string sourceId: type: string code: type: string alternatives: type: array items: type: string retryable: type: boolean alert: type: boolean action: type: object properties: type: type: string enum: - navigate label: type: string href: type: string required: - type - label - href additionalProperties: false required: - error additionalProperties: false '404': description: Lead Finder search not found. content: application/json: schema: type: object properties: error: type: string message: type: string sourceId: type: string code: type: string alternatives: type: array items: type: string retryable: type: boolean alert: type: boolean action: type: object properties: type: type: string enum: - navigate label: type: string href: type: string required: - type - label - href additionalProperties: false required: - error additionalProperties: false '500': description: Server error. content: application/json: schema: type: object properties: error: type: string message: type: string sourceId: type: string code: type: string alternatives: type: array items: type: string retryable: type: boolean alert: type: boolean action: type: object properties: type: type: string enum: - navigate label: type: string href: type: string required: - type - label - href additionalProperties: false required: - error additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: pk_live_... ````