> ## 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.

# Get an investigation

> One investigation, in the shape `GET /v1/atlas/investigations` lists: its name, status, subject
(`lead_info`), cost and, when another team shared it with yours, who shared it.



## OpenAPI

````yaml /openapi.json get /v1/atlas/investigations/{investigation_id}
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/atlas/investigations/{investigation_id}:
    get:
      tags:
        - Atlas
      summary: Get an investigation
      description: >-
        One investigation, in the shape `GET /v1/atlas/investigations` lists:
        its name, status, subject

        (`lead_info`), cost and, when another team shared it with yours, who
        shared it.
      operationId: get_investigation_v1_atlas_investigations__investigation_id__get
      parameters:
        - name: investigation_id
          in: path
          required: true
          schema:
            type: string
            description: Investigation id, as returned by list or by an xhigh enrichment.
            title: Investigation Id
          description: Investigation id, as returned by list or by an xhigh enrichment.
      responses:
        '200':
          description: Investigation details and current status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InvestigationDetail'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Invalid request body
                code: bad_request
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Invalid API key
                code: unauthenticated
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '403':
          description: Organization access is locked.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  This organization no longer has access to Sixtyfour. Contact
                  your representative at Sixtyfour.
                code: forbidden
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '404':
          description: No such investigation, or not one you may see.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Not found
                code: not_found
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '422':
          description: Request body failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '429':
          description: >-
            More than 120 requests per minute per organization. Retry after the
            delay in Retry-After.
          headers:
            Retry-After:
              description: Seconds before retrying
              schema:
                type: string
                example: '1'
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: >-
                  Rate limit exceeded: 120 requests per minute. Retry after 1
                  second.
                code: rate_limited
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
          x-rate-limit:
            requests: 120
            period_seconds: 60
            scope: organization
        '500':
          description: Unexpected server error. Retry with backoff.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Internal server error
                code: internal_error
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
        '503':
          description: >-
            Temporarily unavailable. Nothing was charged; retry after the
            `Retry-After` header.
          content:
            application/json:
              schema:
                properties:
                  detail:
                    type: string
                  feedback:
                    type: string
                    description: How to report a problem with this response.
                  code:
                    type: string
                    description: Stable error code, for programs.
                  correlation_id:
                    type: string
                    description: >-
                      This request's ID, also in `X-Correlation-ID`. Quote it to
                      support.
                type: object
              example:
                detail: Could not verify the API key right now. Retry shortly.
                code: unavailable
                correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
                feedback: >-
                  Problem with this response? POST /feedback with comment and
                  operation; include correlation_id in your comment.
components:
  schemas:
    InvestigationDetail:
      properties:
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        status:
          type: string
          enum:
            - created
            - running
            - stalled
            - completed
            - failed
          title: Status
          description: >-
            `created`, `running`, `stalled`, `completed` or `failed`, from the
            state of its runs.
        visibility:
          type: string
          title: Visibility
        lead_info:
          additionalProperties: true
          type: object
          title: Lead Info
          description: The original input the investigation was started from.
        created_at:
          type: string
          title: Created At
        updated_at:
          type: string
          title: Updated At
        completed_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Completed At
        cost_cents:
          anyOf:
            - type: integer
            - type: 'null'
          title: Cost Cents
          description: >-
            Deprecated. Use `cost_credits`. The same amount in tenths of a
            credit.
          deprecated: true
        cost_credits:
          anyOf:
            - type: number
            - type: 'null'
          title: Cost Credits
          description: >-
            Spend across every run of this investigation, in credits; `null`
            until the charges are recorded, shortly after a run ends.
        spend_access:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Spend Access
          description: >-
            Set when the cost is withheld from the caller, who may not see what
            the investigation's creator spent: why, as `state`, `reason` and
            `message`. `cost_cents` and `cost_credits` are then null.
        shared:
          anyOf:
            - $ref: '#/components/schemas/SharedFrom'
            - type: 'null'
          description: >-
            Null when your team owns this investigation; otherwise the team that
            shared it with yours, and how.
        workspace_url:
          type: string
          maxLength: 2083
          minLength: 1
          format: uri
          title: Workspace Url
          description: >-
            Canonical Sixtyfour app URL for this investigation's Atlas
            workspace.
        private:
          type: boolean
          title: Private
          description: Visible only to you, not your team.
          default: false
        active_job_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Active Job Id
      type: object
      required:
        - id
        - name
        - status
        - visibility
        - lead_info
        - created_at
        - updated_at
        - cost_cents
        - cost_credits
        - workspace_url
      title: InvestigationDetail
    HTTPValidationError:
      title: HTTPValidationError
      type: object
      properties:
        detail:
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
        feedback:
          type: string
          description: How to report a problem with this response.
        code:
          type: string
          description: Stable error code, for programs.
        correlation_id:
          type: string
          description: This request's ID, also in `X-Correlation-ID`. Quote it to support.
      example:
        detail:
          - loc:
              - body
              - target_company
              - domain
            msg: Field required
            type: missing
            input: null
            ctx: {}
        code: invalid_request
        correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21
        feedback: >-
          Problem with this response? POST /feedback with comment and operation;
          include correlation_id in your comment.
    SharedFrom:
      properties:
        team_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Team Id
          description: The team that owns the investigation and shared it with yours.
        team_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Team Name
          description: That team's name; null if it could not be read.
        tier:
          type: string
          enum:
            - viewer
            - editor
          title: Tier
          description: >-
            What your team may do: a viewer reads and exports, an editor may
            also run and edit it.
      type: object
      required:
        - team_id
        - tier
      title: SharedFrom
    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: {}
  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.