> ## 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. # Company Intelligence (Bulk) > Upload a CSV/JSON/NDJSON file and start a background bulk intelligence run. Poll `GET /job-status/{task_id}`; on completion the response includes signed download links and `charge_amount` (total cents charged). Row-level failures pass through un-enriched; source-block failures fail the run. ## OpenAPI ````yaml https://api.sixtyfour.ai/openapi.json post /bulk-intelligence/company 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. paths: /bulk-intelligence/company: post: tags: - Enrichment summary: Company Intelligence (Bulk) description: >- Upload a CSV/JSON/NDJSON file and start a background bulk intelligence run. Poll `GET /job-status/{task_id}`; on completion the response includes signed download links and `charge_amount` (total cents charged). Row-level failures pass through un-enriched; source-block failures fail the run. operationId: start_company_bulk_intelligence_workflow_bulk_intelligence_company_post parameters: - name: cost_units in: query required: false schema: enum: - cents - credits type: string description: Response cost unit. default: cents title: Cost Units description: Response cost unit. - name: Idempotency-Key in: header required: false schema: anyOf: - type: string - type: 'null' description: Optional idempotency key for retry-safe bulk submissions. title: Idempotency-Key description: Optional idempotency key for retry-safe bulk submissions. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key requestBody: required: true content: multipart/form-data: schema: $ref: >- #/components/schemas/Body_start_company_bulk_intelligence_workflow_bulk_intelligence_company_post responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/BulkIntelligenceStartedResponse' '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: Machine authentication required. content: application/json: schema: type: object properties: detail: type: string example: detail: Machine authentication required '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. '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 components: schemas: Body_start_company_bulk_intelligence_workflow_bulk_intelligence_company_post: properties: file: type: string contentMediaType: application/octet-stream title: File description: CSV, JSON, JSONL, or NDJSON file (max 100 MB / 100,000 rows). config: type: string title: Config description: >- JSON-encoded company enrichment config (CompanyBulkIntelligenceConfig schema; max 300000 characters). contentMediaType: application/json contentSchema: additionalProperties: false description: JSON config for POST /bulk-intelligence/company. properties: struct: additionalProperties: true description: >- Mapping of output field name to natural-language description of what to extract. title: Struct type: object find_people: default: false description: If true, also discover key people at the company. title: Find People type: boolean people_focus_prompt: anyOf: - type: string - type: 'null' default: null description: >- Natural-language description of which people to surface when find_people=true. title: People Focus Prompt lead_struct: anyOf: - additionalProperties: true type: object - type: 'null' default: null description: >- Output schema for each discovered person when find_people=true. title: Lead Struct research_plan: anyOf: - type: string - type: 'null' default: null description: Optional natural-language plan that guides the research agent. title: Research Plan tier: anyOf: - enum: - low - micro - medium - high type: string - type: 'null' default: null description: Quality and cost tier for the research agent. title: Tier full_org_chart: default: false description: If true, return the full org chart instead of a focused list. title: Full Org Chart type: boolean webhook_url: anyOf: - format: uri maxLength: 2083 minLength: 1 type: string - type: 'null' default: null description: Optional HTTPS webhook URL for completed results. title: Webhook Url field_confidence: anyOf: - type: boolean - type: 'null' default: null description: >- If true, return confidence scores for each requested output field. title: Field Confidence columns: anyOf: - items: type: string type: array - type: 'null' default: null description: >- Optional subset of uploaded columns to feed into the source block. title: Columns result_formats: anyOf: - items: type: string type: array - type: 'null' default: null description: Optional saved result formats. title: Result Formats save_json: default: false description: Whether to save JSON output artifacts. title: Save Json type: boolean required: - struct title: CompanyBulkIntelligenceConfig type: object type: object required: - file - config title: >- Body_start_company_bulk_intelligence_workflow_bulk_intelligence_company_post BulkIntelligenceStartedResponse: properties: task_id: type: string title: Task Id description: >- Job ID. Poll GET /job-status/{task_id}; on completion the response includes signed download links for result files. status: type: string title: Status description: Job status, typically 'RUNNING'. row_count: anyOf: - type: integer - type: 'null' title: Row Count description: Number of parsed input rows; omitted on idempotent replays. estimated_cost_cents: anyOf: - type: integer - type: 'null' title: Estimated Cost Cents description: >- Estimated job cost in cents (rows × per-row tier price). A floor: options like find_people can bill more. Omitted on idempotent replays. Returned when cost_units=cents. estimated_cost_credits: anyOf: - type: number - type: 'null' title: Estimated Cost Credits description: Estimated job cost in credits. Returned when cost_units=credits. already_started: anyOf: - type: boolean - type: 'null' title: Already Started description: True when the request was deduplicated via Idempotency-Key header. type: object required: - task_id - status title: BulkIntelligenceStartedResponse description: Response when a bulk intelligence job is started. 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: {} 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: {} ````