> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search People

> Finds people using filters, a natural language query, example profiles or a saved search.



## OpenAPI

````yaml /openapi.json post /v1/people/search
openapi: 3.1.0
info:
  title: Sixtyfour API
  description: >-
    Intelligence API for people and companies: research agents that investigate,
    resolve identities, map relationships and surface risk signals.
  contact:
    name: Sixtyfour
    url: https://sixtyfour.ai/
    email: support@sixtyfour.ai
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.sixtyfour.ai
    description: Production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Enrichment
    description: Find and enrich emails, phones, and LinkedIn for people and companies.
  - name: Search
    description: Run deep and filter searches over Sixtyfour's data.
  - name: Workflow
    description: Create, run, and manage enrichment workflows.
  - name: Workflow Schedules
    description: Create and manage recurring schedules for workflows.
  - name: Account
    description: Manage and inspect your account and credit balance.
  - name: Feedback
    description: >-
      Tell us a result was wrong, missing or outdated, and report problems with
      the API, the docs or a tool.
  - name: Intelligence
    description: Verify identity attributes such as age using high-tier OSINT research.
  - name: Atlas
    description: >-
      Start, continue and read Atlas investigations: attribution graph,
      workspace files, reports and exports.
paths:
  /v1/people/search:
    post:
      tags:
        - Search
      summary: Search People
      description: >-
        Finds people using filters, a natural language query, example profiles
        or a saved search.
      operationId: search_people_v1_people_search_post
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 1
                maxLength: 255
              - type: 'null'
            title: Idempotency-Key
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
            example:
              query: Engineers at Sixtyfour in San Francisco
              query_mode: standard
              page_size: 25
              wait_seconds: 0
      responses:
        '200':
          description: Job finished within the wait window.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchJob'
              example:
                job_id: job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                status: succeeded
                created_at: '2026-11-13T10:00:00Z'
                next_poll_after: null
                operation: people.search
                charge_credits: 0
                result:
                  search_id: 11111111-1111-4111-8111-111111111111
                  count: 1
                  output_file_id: file_22222222-2222-4222-8222-222222222222
                counts:
                  total: 1
                  succeeded: 1
                  failed: 0
                  pending: 0
        '202':
          description: Job still running. Poll it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchJob'
              example:
                job_id: job_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                status: running
                created_at: '2026-11-13T10:00:00Z'
                next_poll_after: 5
                operation: people.search
                charge_credits: 0
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Not Found
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
              example:
                detail: >-
                  This Idempotency-Key is already in use. Use a new key for a
                  new request.
                error_code: idempotency_key_reused
                request_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                retryable: false
                param: null
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobValidationError'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicJobError'
          description: Service Unavailable
components:
  schemas:
    SearchRequest:
      properties:
        filters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Filters
          description: >-
            Filter query. Use instead of query, simple_filters, parsed_query,
            seeds or search_id.
        simple_filters:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Simple Filters
          description: >-
            Filters with Mongo-style operators. Use instead of query, filters,
            parsed_query, seeds or search_id.
        parsed_query:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Parsed Query
          description: >-
            Structured filter set from a previous Search result. Use instead of
            query, filters, simple_filters, seeds or search_id.
        query:
          anyOf:
            - type: string
              maxLength: 10000
              minLength: 1
            - type: 'null'
          title: Query
          description: >-
            Natural-language description of matching records. Use instead of
            filters, simple_filters, parsed_query, seeds or search_id.
        seeds:
          anyOf:
            - items:
                anyOf:
                  - additionalProperties: true
                    type: object
                  - type: string
                    maxLength: 2048
              type: array
              maxItems: 1000
              minItems: 1
            - type: 'null'
          title: Seeds
          description: >-
            Example people to find similar profiles, up to 1,000 records. Only
            for people search; use instead of filters, query or search_id.
        search_id:
          anyOf:
            - type: string
              maxLength: 200
              minLength: 1
            - type: 'null'
          title: Search Id
          description: >-
            Saved search to run. Use instead of filters, simple_filters,
            parsed_query, query or seeds.
        cursor:
          anyOf:
            - type: string
              maxLength: 2048
              minLength: 1
            - type: 'null'
          title: Cursor
          description: >-
            Exclusive cursor returned by a previous paged Search result. Send it
            alone to continue that search.
        page_size:
          anyOf:
            - type: integer
              maximum: 100
              minimum: 1
            - type: 'null'
          title: Page Size
          description: >-
            Return one page of this many records. Use instead of the bulk Job
            result. Range: 1 to 100.
        max_results:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Max Results
          description: >-
            Maximum records across all pages. Bulk default: 10. For a paged
            Search, omission uses the caller's Search limit.
          default: 10
        query_mode:
          anyOf:
            - type: string
              enum:
                - standard
                - deep
            - type: 'null'
          title: Query Mode
          description: >-
            For natural-language queries, `standard` uses the existing filter
            planner; `deep` uses deep research. Omission preserves the
            deep-search default.
        output_shape:
          anyOf:
            - type: string
              enum:
                - raw
                - workflow
            - type: 'null'
          title: Output Shape
          description: >-
            Shape of returned rows. Paged Search defaults to `raw`; bulk Search
            retains `workflow` rows.
        exclude_list_ids:
          anyOf:
            - items:
                type: string
                maxLength: 200
              type: array
              maxItems: 10
            - type: 'null'
          title: Exclude List Ids
          description: >-
            Lists whose members to exclude. Omit to exclude none. Limit: 5 by
            default, up to 10 with a higher organization limit.
        exclude_entity_ids:
          anyOf:
            - items:
                type: string
                maxLength: 2048
              type: array
              maxItems: 1000
            - type: 'null'
          title: Exclude Entity Ids
          description: >-
            Identifiers to exclude as a post-filter. People mode accepts
            LinkedIn public IDs or profile URLs; company mode accepts LinkedIn
            company IDs, company URLs or domains. Up to 1,000 values.
        location_expansion_enabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Location Expansion Enabled
          description: >-
            If true, also matches places near a location in `query`. If false,
            matches only the location given. Default: true.
        expand_structured_location:
          type: boolean
          title: Expand Structured Location
          description: Expand structured location filters before matching nearby places.
          default: false
        location_expansion_radius_miles:
          type: integer
          maximum: 200
          minimum: 5
          title: Location Expansion Radius Miles
          description: 'Search radius for location expansion, in miles. Range: 5 to 200.'
          default: 10
        wait_seconds:
          type: integer
          maximum: 20
          minimum: 0
          title: Wait Seconds
          description: 'Seconds to wait for the Job to finish. Default: 5. Range: 0 to 20.'
          default: 5
        webhook_url:
          anyOf:
            - type: string
              maxLength: 2048
              minLength: 1
              format: uri
            - type: 'null'
          title: Webhook Url
          description: HTTPS URL to notify when the Job finishes. Omit to use polling.
      additionalProperties: false
      type: object
      title: SearchRequest
      examples:
        - max_results: 10
          query: Engineers at Sixtyfour in San Francisco
        - page_size: 25
          query: Engineers at Sixtyfour in San Francisco
          query_mode: standard
    SearchJob:
      properties:
        job_id:
          type: string
          title: Job Id
          description: >-
            Job identifier, normally prefixed with `job_`. Store it exactly as
            returned. GET /v1/jobs/{job_id} also accepts IDs returned by
            unversioned endpoints.
        status:
          type: string
          enum:
            - queued
            - running
            - succeeded
            - failed
            - canceled
          title: Status
          description: >-
            Current Job status. Stop polling on `succeeded`, `failed` or
            `canceled`.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: UTC timestamp when the job was created, in ISO 8601 format.
        next_poll_after:
          anyOf:
            - type: integer
            - type: 'null'
          title: Next Poll After
          description: >-
            Seconds before the next poll. Present only while the Job is queued
            or running.
        progress:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Progress
          description: >-
            Operation-specific progress while queued or running; omitted when
            unavailable.
        result:
          anyOf:
            - $ref: '#/components/schemas/SearchResult'
            - type: 'null'
          description: >-
            Native Search metadata and, for paged Search, the raw rows in
            `items`.
        error:
          anyOf:
            - $ref: '#/components/schemas/JobError'
            - type: 'null'
          description: Failure details when available; omitted otherwise.
        operation:
          $ref: '#/components/schemas/JobOperation'
          description: Action performed by the Job.
        counts:
          anyOf:
            - $ref: '#/components/schemas/JobCounts'
            - type: 'null'
          description: Input record counts, when available.
        charge_credits:
          anyOf:
            - type: number
            - type: 'null'
          title: Charge Credits
          description: >-
            Net credits captured at retrieval, including refunds. May change
            after the Job finishes; null when unavailable, unknown, or withheld
            by spend permissions.
      type: object
      required:
        - job_id
        - status
        - created_at
        - operation
      title: SearchJob
    PublicJobError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
      title: PublicJobError
    PublicJobValidationError:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of why the request failed.
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: >-
            Stable error code for handling the failure in code. Do not branch on
            the wording of `detail`.
        request_id:
          type: string
          title: Request Id
          description: >-
            Request identifier, equal to the X-Request-Id response header. Quote
            this value when contacting support.
        retryable:
          type: boolean
          title: Retryable
          description: >-
            If true, retrying the request can succeed without changing its
            inputs; respect Retry-After when present. If false, correct the
            request or resolve the reported condition before retrying.
        param:
          anyOf:
            - type: string
            - type: 'null'
          title: Param
          description: >-
            Dot-separated path to the parameter that caused the error, such as
            `body.lead` or `header.Idempotency-Key`. Null when the error is not
            tied to a parameter.
        errors:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Errors
          description: >-
            Individual validation failures, each with a parameter location
            (`loc`), message (`msg`), and error type (`type`).
      type: object
      required:
        - detail
        - error_code
        - request_id
        - retryable
        - errors
      title: PublicJobValidationError
    SearchResult:
      properties:
        search_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Search Id
          description: Saved Search identifier, when available.
        count:
          type: integer
          title: Count
          description: Records stored for this Job's page or bulk result.
        output_file_id:
          type: string
          title: Output File Id
          description: File containing the result rows, also available through Job items.
        items:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Items
          description: Raw rows in this Search page. Omitted for bulk Search results.
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Cursor for the next page. Null when no additional page remains.
        cursor_expires_in_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Cursor Expires In Seconds
          description: Seconds until the next-page cursor expires.
        page_size:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Size
          description: Requested result page size.
        page_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Count
          description: Rows returned in this page.
        page_number:
          anyOf:
            - type: integer
            - type: 'null'
          title: Page Number
          description: One-based page number.
        total_pages:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Pages
          description: Final page count when known.
        max_pages:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Pages
          description: Upper bound on pages for this Search.
        max_results:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Results
          description: Maximum rows available for this Search.
        remaining_results:
          anyOf:
            - type: integer
            - type: 'null'
          title: Remaining Results
          description: Rows still available under the Search limit.
        total_results:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Results
          description: Rows returned across pages so far.
        total_available:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Available
          description: Exact number of matches when known.
        total_available_lower_bound:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Available Lower Bound
          description: Lower bound when the exact total is unknown.
        parsed_query:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Parsed Query
          description: Portable parsed filters used by Search.
        natural_language_query:
          anyOf:
            - type: string
            - type: 'null'
          title: Natural Language Query
          description: Original natural-language query, when provided.
        output_shape:
          anyOf:
            - type: string
              enum:
                - raw
                - workflow
            - type: 'null'
          title: Output Shape
          description: Shape used for the result rows.
        unmet_constraints:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Unmet Constraints
          description: Constraints that could not be represented by the result query.
        company_filter_truncated:
          anyOf:
            - additionalProperties:
                type: integer
              type: object
            - type: 'null'
          title: Company Filter Truncated
          description: Company-filter values omitted because of supported limits.
        query_mode:
          anyOf:
            - type: string
              enum:
                - standard
                - deep
            - type: 'null'
          title: Query Mode
          description: Natural-language execution mode, when a query was provided.
      type: object
      required:
        - count
        - output_file_id
      title: SearchResult
      examples:
        - count: 25
          cursor_expires_in_seconds: 600
          items:
            - fullName: Ada Lovelace
              linkedinUrl: https://linkedin.com/in/ada
          max_pages: 40
          max_results: 1000
          natural_language_query: Engineers at Sixtyfour in San Francisco
          next_cursor: opaque-cursor
          output_file_id: file_a2acd368-c2f6-4f69-80e1-9276237d9665
          output_shape: raw
          page_count: 25
          page_number: 1
          page_size: 25
          parsed_query:
            title: engineer
          query_mode: standard
          remaining_results: 975
          search_id: f753c8f6-9a44-5758-97dc-dd8029d69015
          total_available_lower_bound: 1024
          total_results: 25
          unmet_constraints: []
    JobError:
      properties:
        error_code:
          $ref: '#/components/schemas/V1ErrorCode'
          description: Stable error code for identifying the job failure in code.
        detail:
          type: string
          title: Detail
          description: Human-readable explanation of the job failure.
      type: object
      required:
        - error_code
        - detail
      title: JobError
    JobOperation:
      type: string
      enum:
        - people.search
        - companies.search
        - people.contacts
        - people.contacts.reverse
        - people.intelligence
        - companies.intelligence
        - lists.create
        - exports.create
        - workflows.run
        - qa-agent.run
        - verify-age.run
      title: JobOperation
    JobCounts:
      properties:
        total:
          type: integer
          minimum: 0
          title: Total
          description: Total items tracked for this Job, not its credit usage.
        succeeded:
          type: integer
          minimum: 0
          title: Succeeded
          description: Tracked items that finished successfully.
        failed:
          type: integer
          minimum: 0
          title: Failed
          description: Tracked items that failed or were canceled.
        pending:
          type: integer
          minimum: 0
          title: Pending
          description: Tracked items still waiting or running.
      type: object
      required:
        - total
        - succeeded
        - failed
        - pending
      title: JobCounts
    V1ErrorCode:
      type: string
      enum:
        - invalid_cursor
        - request_in_progress
        - limit_exceeded
        - entity_type_mismatch
        - unsupported_file
        - invalid_upload
        - file_too_large
        - items_not_available
        - list_not_ready
        - job_not_finished
        - not_found
        - validation_error
        - rate_limited
        - internal_error
        - unavailable
        - unauthenticated
        - forbidden
        - insufficient_credits
        - idempotency_key_reused
        - export_source_changed
        - job_execution_changed
        - job_failed
        - item_failed
        - aborted
        - workflow_changed
        - workflow_locked
        - workflow_not_runnable
        - timed_out
      title: V1ErrorCode
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Sixtyfour API key.
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        An OAuth access token from `POST /oauth/token`, sent as `Authorization:
        Bearer <token>`. An API key sent as a bearer token is refused with 401.
        When both headers are sent, the bearer token is used.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.