---
title: "Returns all SourceDocument IDs that match the query parameters."
method: POST
path: "/analysis/code_occurrences"
tags: ["analysis"]
---

# Returns all SourceDocument IDs that match the query parameters.

`POST /analysis/code_occurrences`

## Query parameters

- `project_id` integer, required
- `code_id` integer, required
- `return_children` boolean, required

## Request body

- BodyAnalysisCodeOccurrences
  - `user_ids` integer[], required
  - `doctypes` DocType[], required

## Response `200`

Successful Response

- CodeOccurrence[]
  - `sdoc` SourceDocumentRead, required
    - `filename` string, required — Filename of the SourceDocument
    - `name` string, required — User-defined name of the document (default is the filename)
    - `doctype` 'text' | 'image' | 'video' | 'audio', required
    - `project_id` integer, required — Project the SourceDocument belongs to
    - `id` integer, required — ID of the SourceDocument
    - `created` string, date-time, required — The created timestamp of the SourceDocument
    - `updated` string, date-time, required — Updated timestamp of the SourceDocument
    - `folder_id` integer, required — ID of the Folder this SourceDocument belongs to
    - `memo_ids` integer[] — IDs of the Memos attached to the SourceDocument
  - `code` CodeRead, required
    - `name` string, required — Name of the Code
    - `color` string, required — Color of the Code
    - `description` string — Description of the Code
    - `parent_id` integer, nullable — Parent of the Code
    - `enabled` boolean — While false, the code is neither created in pre-processing nor shown in the UI (except in settings to enable it again)
    - `id` integer, required — ID of the Code
    - `project_id` integer, required — Project the Code belongs to
    - `created` string, date-time, required — Created timestamp of the Code
    - `updated` string, date-time, required — Updated timestamp of the Code
    - `is_system` boolean, required — Is the Code a system code
    - `memo_ids` integer[], required — Memo IDs attached to the Code
  - `text` string, required — A text span of the SourceDocument annotated with the Code.
  - `count` integer, required — The number of occurrences of the text span annotated with the Code in the SourceDocument.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/uhh-lt/apis/discourse-analysis-tool-suite-api.md) · [All operations](https://skmtc.net/uhh-lt/apis/discourse-analysis-tool-suite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uhh-lt/discourse-analysis-tool-suite-api/revisions/6b22366ce2d1/schema)