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

# List investigation history.

> List investigation history. The API key determines the workspace and environment.



## OpenAPI

````yaml /openapi.json get /v1/investigations
openapi: 3.1.0
info:
  title: NoResponse API
  version: '1'
  description: >-
    NoResponse is an identity and people risk engine. Create workspace people,
    start investigations, read complete source evidence and retain job history.
    Groups organize people for screening and contextual review. Account
    assessment uses the same engine for account creation, login and purchase
    decisions.


    Authenticate every request with your API key as `Authorization: Bearer
    nrk_...`. Call the API only from your backend.


    Guides, SDKs and webhook verification are at
    [docs.noresponse.org](https://docs.noresponse.org/). Every error is an RFC
    9457 problem document; see
    [Errors](https://docs.noresponse.org/reference/errors).
servers:
  - url: https://api.noresponse.org
    description: Production
security:
  - tenantBearer: []
tags:
  - name: people
    x-displayName: People
    x-group: People
    description: >-
      Retain people in one workspace environment, with submitted identity,
      expiry and source evidence.
  - name: investigations
    x-displayName: Investigations
    x-group: Investigations
    description: >-
      Start person investigations, read job history and record context-specific
      review decisions.
  - name: assess
    x-displayName: Assessments
    x-group: Assessments
    description: Create, read and list assessments, and report outcomes.
  - name: accounts
    x-displayName: Accounts
    x-group: Accounts
    description: >-
      Each of your accounts holds one current risk, and its assessments are its
      history.
  - name: usage
    x-displayName: Key usage
    x-group: Key usage
    description: >-
      Report usage of the API keys that your account creation gate issued, so a
      shared or stolen key raises its account's risk.
  - name: keys
    x-displayName: API keys
    x-group: API keys
    description: >-
      Rotate your own API key and, with the `management` scope, create, list and
      revoke the keys of its environment.
  - name: settings
    x-displayName: Settings
    x-group: Settings
    description: >-
      Read and preview environment settings, run evaluations, and publish
      reviewed policy with separate permissions.
  - name: lists
    x-displayName: Lists
    x-group: Lists
    description: >-
      Preview, allow or block accounts that use an email or email domain.
      Publishing changes requires policy authority.
  - name: integrations
    x-displayName: Integrations
    x-group: Integrations
    description: >-
      Hosted endpoints that answer your WorkOS, Auth0 or Supabase sign-up and
      sign-in hooks.
  - name: webhooks
    x-displayName: Webhooks
    x-group: Webhooks
    description: Your webhook endpoints, and the signed events NoResponse sends to them.
  - name: workspaces
    x-displayName: Workspaces
    x-group: Workspaces
    description: >-
      Manage non-owner team access, read usage and audit events, configure audit
      streams, and export retained account or audit data.
  - name: requests
    x-displayName: Request diagnostics
    x-group: Request diagnostics
    description: Search retained request attempts and summarize their status and latency.
  - name: groups
    x-displayName: Groups
    x-group: Groups
    description: >-
      Screen a group's people: create the group, upload its list of people,
      start screenings and record a decision on each person.
  - name: reviews
    x-displayName: Reviews
    x-group: Reviews
    description: >-
      Investigate accounts with assignments, comments, linked evidence, saved
      filters and recorded resolutions.
paths:
  /v1/investigations:
    get:
      tags:
        - investigations
      summary: List investigation history.
      description: >-
        List investigation history. The API key determines the workspace and
        environment.
      operationId: listInvestigations
      parameters:
        - name: person_id
          in: query
          schema:
            type: string
            pattern: ^per_[0-7][0-9A-HJKMNP-TV-Z]{25}$
        - name: before
          in: query
          schema:
            type: string
            pattern: ^inv_[0-7][0-9A-HJKMNP-TV-Z]{25}$
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 100
      responses:
        '200':
          $ref: '#/components/responses/ListInvestigations200'
        '400':
          $ref: '#/components/responses/InvalidControlRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/WorkspaceForbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '503':
          $ref: '#/components/responses/ServiceUnavailable'
      security:
        - tenantBearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |
            curl --request GET \
              --url 'https://api.noresponse.org/v1/investigations?limit=100' \
              --header "Authorization: Bearer $NORESPONSE_API_KEY"
        - lang: typescript
          label: TypeScript
          source: |
            import { NoResponse } from "@noresponse/node";

            const noResponse = new NoResponse({
              apiKey: process.env["NORESPONSE_API_KEY"] ?? "",
            });

            async function run() {
              const result = await noResponse.investigations.list({});

              console.log(result);
            }

            run();
        - lang: python
          label: Python
          source: |
            from noresponse import NoResponse
            import os


            with NoResponse(
                api_key=os.getenv("NORESPONSE_API_KEY", ""),
            ) as no_response:

                res = no_response.investigations.list(limit=100)

                # Handle response
                print(res)
        - lang: go
          label: Go
          source: "package main\n\nimport(\n\t\"context\"\n\t\"os\"\n\tnoresponse \"github.com/noresponsehq/go/v14\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := noresponse.New(\n        noresponse.WithSecurity(os.Getenv(\"NORESPONSE_API_KEY\")),\n    )\n\n    res, err := s.Investigations.List(ctx, nil, nil, noresponse.Pointer[int64](100))\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res != nil {\n        // handle response\n    }\n}\n"
        - lang: java
          label: Java
          source: |
            package hello.world;

            import java.lang.Exception;
            import org.noresponse.NoResponse;
            import org.noresponse.models.errors.AuthenticationException;
            import org.noresponse.models.errors.BadRequestException;
            import org.noresponse.models.errors.ConflictException;
            import org.noresponse.models.errors.NotFoundException;
            import org.noresponse.models.errors.PermissionDeniedException;
            import org.noresponse.models.errors.RateLimitException;
            import org.noresponse.models.operations.ListInvestigationsResponse;

            public class Application {

                public static void main(String[] args) throws Exception {

                    NoResponse sdk = NoResponse.builder()
                            .apiKey(System.getenv().getOrDefault("NORESPONSE_API_KEY", ""))
                        .build();

                    ListInvestigationsResponse res = sdk.investigations().list()
                            .limit(100L)
                            .call();

                    if (res.investigationsList().isPresent()) {
                        System.out.println(res.investigationsList().get());
                    }
                }
            }
        - lang: csharp
          label: C#
          source: >
            using NoResponse;

            using NoResponse.Models.Shared;

            using System;


            var sdk = new NoResponseClient(apiKey:
            Environment.GetEnvironmentVariable("NORESPONSE_API_KEY"));


            var res = await sdk.Investigations.ListAsync(limit: 100);


            // handle response
        - lang: php
          label: PHP
          source: |
            <?php

            declare(strict_types=1);

            require 'vendor/autoload.php';

            use NoResponse;

            $sdk = NoResponse\NoResponseClient::builder()
                ->setSecurity(
                    getenv('NORESPONSE_API_KEY') ?: ''
                )
                ->build();



            $response = $sdk->investigations->list(
                limit: 100
            );

            $result = $response->result;
            // handle response
        - lang: ruby
          label: Ruby
          source: |
            require 'noresponse'

            Models = ::NoResponse::Models
            s = ::NoResponse::NoResponseClient.new(
              api_key: ENV.fetch('NORESPONSE_API_KEY', '')
            )
            res = s.investigations.list(limit: 100)

            unless res.nil?
              # handle response
            end
components:
  responses:
    ListInvestigations200:
      description: List investigation history.
      headers:
        X-Request-ID:
          $ref: '#/components/headers/X-Request-ID'
        Cache-Control:
          $ref: '#/components/headers/Cache-Control'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InvestigationsList'
    InvalidControlRequest:
      description: >-
        The body breaks its schema, or a console credential named no valid
        NR-Acting-User.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 400
                  code:
                    enum:
                      - invalid_request
    Unauthorized:
      description: No API key, or one that is malformed, unknown, revoked or expired.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        WWW-Authenticate:
          schema:
            type: string
            const: Bearer realm="noresponse-assessments"
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 401
                  code:
                    enum:
                      - unauthorized
    WorkspaceForbidden:
      description: >-
        The API key is valid but may not use this operation: it lacks the
        operation's scope, or its workspace is not entitled or is suspended.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 403
                  code:
                    enum:
                      - workspace_forbidden
          examples:
            missingScope:
              value:
                type: https://docs.noresponse.org/problems/workspace-forbidden
                title: Forbidden
                status: 403
                detail: The API key does not carry a scope this operation accepts.
                code: workspace_forbidden
                request_id: 0123456789abcdef0123456789abcdef
    NotFound:
      description: >-
        No unexpired assessment with this id for the calling workspace, or a
        malformed assessment_id.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 404
                  code:
                    enum:
                      - not_found
    RateLimited:
      description: >-
        The workspace's rate or concurrency limit is exhausted. Retry-After says
        when to retry; the provider applies its own fallback meanwhile.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        Retry-After:
          description: >-
            Whole seconds to wait before polling or retrying. Required on 202,
            429 and 503.
          schema:
            type: string
            pattern: >-
              ^(?:[1-9]|[1-9][0-9]|[1-9][0-9]{2}|[12][0-9]{3}|3[0-5][0-9]{2}|3600)$
            description: Whole decimal seconds; wait at least this long.
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 429
                  code:
                    enum:
                      - rate_limited
          examples:
            limited:
              value:
                type: https://docs.noresponse.org/problems/rate-limited
                title: Rate limited
                status: 429
                detail: >-
                  The tenant's assessment rate is exhausted; retry after the
                  Retry-After interval.
                code: rate_limited
                request_id: 0123456789abcdef0123456789abcdef
    ServiceUnavailable:
      description: >-
        The assessment could not be admitted at all (overload, shutdown or a
        dependency down). An assessment that was admitted answers partial or
        pending instead of 503.
      headers:
        Cache-Control:
          schema:
            type: string
            const: no-store
          required: true
        Retry-After:
          description: >-
            Whole seconds to wait before polling or retrying. Required on 202,
            429 and 503.
          schema:
            type: string
            pattern: >-
              ^(?:[1-9]|[1-9][0-9]|[1-9][0-9]{2}|[12][0-9]{3}|3[0-5][0-9]{2}|3600)$
            description: Whole decimal seconds; wait at least this long.
          required: true
        X-Request-ID:
          description: The request correlation id, 32 lowercase hexadecimal characters.
          schema:
            type: string
            pattern: ^[0-9a-f]{32}$
            not:
              pattern: \n
          required: true
      content:
        application/problem+json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Problem'
              - properties:
                  status:
                    const: 503
                  code:
                    enum:
                      - service_unavailable
  headers:
    X-Request-ID:
      description: The request correlation id, 32 lowercase hexadecimal characters.
      schema:
        type: string
        pattern: ^[0-9a-f]{32}$
        not:
          pattern: \n
    Cache-Control:
      schema:
        type: string
        const: no-store
  schemas:
    InvestigationsList:
      type: object
      additionalProperties: false
      required:
        - items
        - has_more
        - next_cursor
      properties:
        items:
          type: array
          maxItems: 100
          items:
            type: object
            additionalProperties: false
            required:
              - highest_band
              - coverage
              - spend
              - decision
              - id
              - person_id
              - group_id
              - status
              - depth
              - platforms
              - match_state
              - created_at
              - expires_at
              - deadline_at
            properties:
              highest_band:
                anyOf:
                  - enum:
                      - critical
                      - high
                      - moderate
                      - low
                      - info
                  - type: 'null'
                description: >-
                  The most severe finding's band, or null when nothing was
                  flagged.
              coverage:
                type: object
                additionalProperties: false
                required:
                  - accounts_found
                  - accounts_accessible
                  - items_read
                  - platforms
                properties:
                  accounts_found:
                    type: integer
                    minimum: 0
                    maximum: 100
                  accounts_accessible:
                    type: integer
                    minimum: 0
                    maximum: 100
                  items_read:
                    type: integer
                    minimum: 0
                    maximum: 1000000
                  items_not_analysed:
                    type: integer
                    minimum: 0
                    maximum: 1000000
                    description: >-
                      Items read that the analyser could not analyse. Above
                      zero, the person is partial: a finding may be missing from
                      them.
                  not_analysed_by_reason:
                    type: array
                    maxItems: 8
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - reason
                        - items
                      properties:
                        reason:
                          enum:
                            - video
                            - image_unavailable
                            - image_unsupported
                            - image_limit
                            - refused
                            - unfinished
                            - unverified
                            - unspecified
                          description: >-
                            Why an item read was not analysed. video: a video
                            with no cover frame the analyser could read, whose
                            caption alone is read. image_unavailable: the image
                            could not be fetched from the platform.
                            image_unsupported: not a JPEG, PNG, GIF or WebP
                            image, or too large to send. image_limit: past the
                            most images one person's analysis reads. refused:
                            the model declined to read it. unfinished: the model
                            cut its batch short or answered outside the schema,
                            or the request was rejected. unverified: a finding
                            cited it with words it does not contain or an image
                            it did not describe. unspecified: the analyser gave
                            no reason.
                        items:
                          type: integer
                          minimum: 1
                          maximum: 1000000
                      description: How many items read were not analysed for one reason.
                    description: >-
                      items_not_analysed split by reason, each reason once with
                      at least one item.
                  items_frame_only:
                    type: integer
                    minimum: 0
                    maximum: 1000000
                    description: >-
                      Videos the analyser read from their cover frame and
                      caption alone, without their sound or later frames. They
                      count as analysed and do not make the person partial. Left
                      out when none.
                  period_from:
                    type: string
                    format: date-time
                    description: The oldest item read on any platform.
                  period_to:
                    type: string
                    format: date-time
                    description: The newest item read on any platform.
                  platforms:
                    type: array
                    maxItems: 11
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - platform
                        - status
                        - accounts_found
                        - items_read
                      properties:
                        platform:
                          type: string
                          pattern: ^[a-z][a-z0-9_]{0,63}$
                          description: >-
                            A platform a screening can cover, such as instagram,
                            x, bluesky, youtube, tiktok or github. A new
                            platform adds an id without changing this contract,
                            so read a platform you do not know in a response as
                            one you have not seen before, not as an error.
                            synthetic is the deterministic connector's own
                            platform, for exercising the product end to end with
                            no network.
                        status:
                          enum:
                            - covered
                            - none_found
                            - inaccessible
                            - failed
                            - unavailable
                          description: >-
                            covered read at least one profile; none_found looked
                            and found no account; inaccessible found accounts
                            that are private or locked; failed could not finish
                            looking; unavailable has no resolver or collector
                            enabled.
                        accounts_found:
                          type: integer
                          minimum: 0
                          maximum: 100
                        items_read:
                          type: integer
                          minimum: 0
                          maximum: 100000
                      description: What a screening read on one platform.
                  not_searched:
                    type: array
                    maxItems: 11
                    uniqueItems: true
                    items:
                      type: string
                      pattern: ^[a-z][a-z0-9_]{0,63}$
                      description: >-
                        A platform a screening can cover, such as instagram, x,
                        bluesky, youtube, tiktok or github. A new platform adds
                        an id without changing this contract, so read a platform
                        you do not know in a response as one you have not seen
                        before, not as an error. synthetic is the deterministic
                        connector's own platform, for exercising the product end
                        to end with no network.
                    description: >-
                      Requested platforms where the person gave the screening
                      nothing to look up, such as no handle for a platform that
                      reads supplied handles only. Nothing looked and nothing
                      failed: such a platform is not in platforms, is not
                      none_found and does not make the person partial.
                description: >-
                  What the latest screening read: accounts found, accessible,
                  items read, the period covered and each platform's status.
                  Zero, with no platforms, until a screening reaches the person.
              spend:
                type: object
                additionalProperties: false
                required:
                  - total_minor
                  - by_implementation
                properties:
                  total_minor:
                    type: integer
                    minimum: 0
                    maximum: 100000000000
                    description: The total, in US cents.
                  by_implementation:
                    type: array
                    maxItems: 100
                    items:
                      type: object
                      additionalProperties: false
                      required:
                        - implementation
                        - role
                        - spend_minor
                      properties:
                        implementation:
                          type: string
                          pattern: ^[a-z][a-z0-9_]{0,31}$
                          description: >-
                            The resolver, collector or analyser that produced a
                            record, by its catalogue name.
                        role:
                          enum:
                            - resolver
                            - collector
                            - analyser
                        spend_minor:
                          type: integer
                          minimum: 0
                          maximum: 100000000000
                      description: What one implementation cost.
                description: What the latest screening of the person cost.
              decision:
                anyOf:
                  - enum:
                      - cleared
                      - watch
                      - escalated
                  - type: 'null'
                description: The latest reviewer decision, or null before any.
              decision_note:
                type: string
                minLength: 1
                maxLength: 2000
              decided_by:
                type: string
                minLength: 1
                maxLength: 256
              decided_at:
                type: string
                format: date-time
              id:
                type: string
                pattern: ^inv_[0-7][0-9A-HJKMNP-TV-Z]{25}$
              person_id:
                type: string
                pattern: ^per_[0-7][0-9A-HJKMNP-TV-Z]{25}$
              group_id:
                anyOf:
                  - type: string
                    pattern: ^grp_[0-7][0-9A-HJKMNP-TV-Z]{25}$
                  - type: 'null'
              status:
                enum:
                  - queued
                  - running
                  - completed
                  - partial
                  - failed
                  - cancelled
                  - unknown
              depth:
                enum:
                  - standard
                description: standard reads the bio and the last 100 posts of each profile.
              platforms:
                type: array
                minItems: 1
                maxItems: 11
                uniqueItems: true
                items:
                  type: string
                  pattern: ^[a-z][a-z0-9_]{0,63}$
                  description: >-
                    A platform a screening can cover, such as instagram, x,
                    bluesky, youtube, tiktok or github. A new platform adds an
                    id without changing this contract, so read a platform you do
                    not know in a response as one you have not seen before, not
                    as an error. synthetic is the deterministic connector's own
                    platform, for exercising the product end to end with no
                    network.
              match_state:
                anyOf:
                  - enum:
                      - unscreened
                      - confirmed
                      - probable
                      - possible
                      - none_found
                      - inaccessible
                    description: >-
                      How sure the latest screening is that it found the
                      person's accounts. unscreened until a screening reaches
                      the person, and after one that had no profile to check
                      (no_profile_to_check).
                  - type: 'null'
              error_code:
                type: string
              created_at:
                type: string
                format: date-time
              started_at:
                type: string
                format: date-time
              finished_at:
                type: string
                format: date-time
              expires_at:
                type: string
                format: date-time
              deadline_at:
                type: string
                format: date-time
        has_more:
          type: boolean
        next_cursor:
          anyOf:
            - type: string
              pattern: ^inv_[0-7][0-9A-HJKMNP-TV-Z]{25}$
            - type: 'null'
    Problem:
      title: Problem details error
      description: >-
        RFC 9457 problem-details error body returned by every non-2xx API
        response, extended with a stable machine code and request id.
      type: object
      additionalProperties: false
      required:
        - type
        - title
        - status
        - detail
        - code
        - request_id
      properties:
        type:
          type: string
          format: uri-reference
        title:
          type: string
        status:
          type: integer
          minimum: 400
          maximum: 599
        detail:
          type: string
        instance:
          type: string
          format: uri-reference
        code:
          type: string
        request_id:
          type: string
          minLength: 1
        invalid_params:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
              - field
              - reason
            properties:
              field:
                type: string
                minLength: 1
              reason:
                type: string
                minLength: 1
              example:
                type: string
                minLength: 1
  securitySchemes:
    tenantBearer:
      type: http
      scheme: bearer
      description: >-
        Your API key, sent as `Authorization: Bearer <key>`. A key is
        `nrk_live_` or `nrk_test_`, a 26-character key id, `_` and a
        43-character secret. Account, audit and usage data stay within the key's
        environment. Dedicated team scopes apply across the workspace.


        `assess` creates and reads assessments, records outcomes and reports key
        usage. `investigate` reads accounts, assessment history and request
        diagnostics without export or enforcement access. The legacy `history`
        scope also permits account exports, submitted identifiers and
        enforcement reports. `delete` permits account and assessment deletion.


        `evidence` or `detailed` adds detailed merged evidence and submitted
        identifiers where the operation permits them. Neither grants access to
        the underlying resource alone. `exports` permits exports with the
        underlying account or audit scope. `audit` reads audit events and
        `usage` reads usage. `audit_manage` manages audit streams and retention,
        and includes audit-read and export authority.


        `webhooks` manages webhook endpoints. `integrations` manages hosted
        auth-provider integrations. `management` manages keys, settings, lists,
        reviews and policy evaluations in the key's environment. New keys cannot
        exceed the issuer's effective permissions.


        `settings` reads configuration, previews policy and list changes, runs
        evaluations and changes retention. Publishing decision policy or
        changing lists requires `settings` and `policy_publish` together, or the
        legacy `management` scope.


        `people` reads people, groups and investigations with full evidence by
        default. `people_write` changes submitted people, groups and
        memberships. `investigations` starts or cancels jobs and screenings.
        `decisions` records reviews. `exports` with people-read access exports
        rosters. `delete` deletes people, groups and memberships. Existing
        `groups` keys retain non-destructive people access. Explicit
        `evidence.read` restrictions withhold collected records, posts, media,
        discovered identifiers and notes.


        `members` reads the workspace directory. `members_manage` also
        administers non-owner members and invitations. These scopes require a
        live key issued by a current owner with access to both environments.
        They grant access across the workspace. `management` does not grant team
        access. API keys cannot change owners or accept invitations.


        A missing, unknown, revoked or expired key answers 401. A valid key
        without a required scope answers 403.

````

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