> ## 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. # People Intelligence (Async) > Find and enrich a single person; returns a job ID to poll. ## OpenAPI ````yaml https://api.sixtyfour.ai/openapi.json post /people-intelligence-async openapi: 3.1.0 info: title: Sixtyfour API description: >- Intelligence API for People and Entities. Deploy AI 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: [] tags: - name: Enrichment description: Find and enrich emails, phones, and LinkedIn for people and companies. - name: org-chart description: Discover people inside a company and build org charts. - 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: Intelligence description: Verify identity attributes such as age using high-tier OSINT research. - name: Atlas description: >- Read your Atlas investigations: attribution graph, workspace files, reports, and exports. paths: /people-intelligence-async: post: tags: - Enrichment summary: People Intelligence (Async) description: Find and enrich a single person; returns a job ID to poll. operationId: people_intelligence_async_endpoint_people_intelligence_async_post parameters: - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/EnrichLeadInfo' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LeadAsyncJobStartResponse' '400': description: Request was rejected by the route's validation rules. content: application/json: schema: type: object properties: detail: type: string example: detail: Invalid request body '401': description: Missing or invalid API key. content: application/json: schema: type: object properties: detail: type: string example: detail: Invalid API key '402': description: >- Insufficient credits or no active subscription for this organization. content: application/json: schema: type: object properties: detail: type: string example: detail: Insufficient API credits '403': description: Tier or feature not enabled for this organization. content: application/json: schema: type: object properties: detail: type: string example: detail: >- High tier company enrichment is not enabled for this org. Contact sales to request access. '404': description: Async enrichment job not found. content: application/json: schema: type: object properties: detail: type: string example: detail: Job not found '422': description: Request body failed validation. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Rate limit exceeded. content: application/json: schema: type: object properties: detail: type: string example: detail: Rate limit exceeded '500': description: Unexpected server error. Retry with backoff. content: application/json: schema: type: object properties: detail: type: string example: detail: Internal server error '503': description: >- The API key could not be checked, or the request could not be started, because a backing service is briefly unavailable. Nothing was charged. Retry after the `Retry-After` header. content: application/json: schema: type: object properties: detail: type: string example: detail: Could not verify the API key right now. Retry shortly. components: schemas: EnrichLeadInfo: properties: struct: anyOf: - additionalProperties: true type: object - type: 'null' title: Struct description: >- Mapping of output field name to natural-language description of what to extract. A field that asks for an image (a headshot, a logo, a screenshot of a page) is returned as a permanent image URL on api.sixtyfour.ai/v1/media, hosted by Sixtyfour; embed it directly. research_plan: anyOf: - type: string - type: 'null' title: Research Plan description: Optional natural-language plan that guides the research agent. tier: anyOf: - type: string enum: - low - micro - medium - high - xhigh - scout - type: 'null' title: Tier description: Quality and cost tier for the research agent. webhook_url: anyOf: - type: string maxLength: 2083 minLength: 1 format: uri - type: 'null' title: Webhook Url description: >- HTTPS URL that receives the result payload when the async job completes. field_confidence: anyOf: - type: boolean - type: 'null' title: Field Confidence description: >- If true, return each requested field's confidence (0-100), justification and source URLs, nested like the request. lead_info: additionalProperties: true type: object title: Lead Info description: >- Single lead to process. Provide any combination of name, email, company, linkedin, etc. include_workspace: anyOf: - type: boolean - type: 'null' title: Include Workspace description: >- For Atlas runs (xhigh, or scout with graph), include workspace files alongside structured output (default: true). Set false to omit them. Job status reads them from the investigation, so it shows the investigation's current workspace, including what a later run on it changed. Saved images appear as attachment records; requested image fields carry their permanent /v1/media URL, and the investigation's /v1/atlas file API serves any attachment. Ignored by other tiers. investigation_id: anyOf: - type: string - type: 'null' title: Investigation Id description: >- For Atlas runs (xhigh, or scout with graph), continue an existing investigation instead of creating one. The run reuses that investigation's graph and workspace, so a follow-up builds on the earlier research rather than starting over. Ignored by other tiers. investigation_name: anyOf: - type: string - type: 'null' title: Investigation Name description: >- For Atlas runs, the title of a newly created investigation. Ignored when resuming via investigation_id; when unset the title is derived from lead_info. relentless: type: boolean title: Relentless description: >- For Atlas runs with target fields: research until the budget runs out. By default a run may stop once every requested field is answered, charging the turns it used (at least one unit). default: false max_credits: anyOf: - type: integer - type: 'null' title: Max Credits description: >- For Atlas runs, how much research to buy, in credits (default: one unit of the tier price, 250 credits on xhigh), up to 10 units. On multi-agent runs every 250 credits buy 800 team turns (every model response by any agent in the run), used in full unless the research stops yielding: 300 buys 960. max_minutes: anyOf: - type: integer maximum: 1440 minimum: 10 - type: 'null' title: Max Minutes description: >- For Atlas runs, the longest the run may research, in minutes of working time: waits to retry a model call or an attempt do not count. When it is reached the run writes up what it found and completes, charging the credits its turns used, rounded up to the next 50, instead of the whole budget. Writing up can take a few minutes past the limit. Default: no limit. dispatch_id: anyOf: - type: string maxLength: 128 minLength: 8 - type: 'null' title: Dispatch Id description: >- Async endpoints only: a client-generated idempotency key for the dispatch. Reusing the same key for the same organization returns the existing job instead of starting and billing a duplicate. exclusive_run: type: boolean title: Exclusive Run description: >- Atlas runs on an existing investigation only: refuse with 409 while that investigation already has a run starting or running, instead of starting and billing a second one. default: false additionalProperties: true type: object required: - lead_info title: EnrichLeadInfo LeadAsyncJobStartResponse: properties: task_id: type: string title: Task Id description: Async job ID. Poll GET /job-status/{task_id} for status and results. status: type: string const: RUNNING title: Status description: Initial job status. investigation: anyOf: - $ref: '#/components/schemas/InvestigationReference' - type: 'null' description: 'Atlas runs only: the workspace created for this job.' unrecognized_fields: anyOf: - items: type: string type: array - type: 'null' title: Unrecognized Fields description: >- Request fields we do not recognize and therefore ignored, so an instruction that silently did nothing is visible rather than assumed to have applied. Absent when every field was understood. type: object required: - task_id - status title: LeadAsyncJobStartResponse description: >- Async people-intelligence kickoff. Atlas jobs (xHigh or Scout Graph) expose their workspace immediately. The fields stay optional because the same endpoint supports tiers that do not create an investigation. example: investigation: id: 29beab70-42e4-5d19-b3b1-9a28279ca19f workspace_url: >- https://app.sixtyfour.ai/atlas/29beab70-42e4-5d19-b3b1-9a28279ca19f/graph status: RUNNING task_id: job_123 HTTPValidationError: title: HTTPValidationError type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' example: detail: - loc: - body - target_company - domain msg: Field required type: missing input: null ctx: {} InvestigationReference: properties: id: type: string title: Id description: Atlas investigation ID. workspace_url: type: string maxLength: 2083 minLength: 1 format: uri title: Workspace Url description: Canonical Sixtyfour app URL for the investigation's Atlas workspace. type: object required: - id - workspace_url title: InvestigationReference description: >- Stable identity and app link carried across xhigh lifecycle responses. Live workspace statistics stay on the Atlas resource endpoints so polling a job never fans out into file, graph, or event count queries. ValidationError: title: ValidationError type: object required: - loc - msg - type properties: loc: type: array items: oneOf: - type: string - type: integer description: Path to the field that failed validation. example: - body - target_company - domain msg: type: string description: Human-readable error message. example: Field required type: type: string description: Error code (e.g. 'missing', 'value_error'). example: missing input: description: The offending input value (any type, may be null). nullable: true example: null ctx: type: object description: Optional error context. additionalProperties: true example: {} ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.