> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emtelligent.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emtelligent.com/_mcp/server.

# emtellipro-flatten-json

## emtellipro-flatten-json

Convert NLP API JSON result files in FILEPATHS to a flatter format.

```bash
emtellipro-flatten-json [OPTIONS] [FILEPATHS]...
```

| Argument                 | Type                    | Required | Description |
| ------------------------ | ----------------------- | -------- | ----------- |
| `FILEPATHS` (repeatable) | path (must exist, file) | yes      |             |

| Option                     | Type                          | Default | Required | Description                                                                                                                                                                              |
| -------------------------- | ----------------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-O`, `--output-format`    | one of `json`, `jsonl`, `tsv` | `json`  | no       | Format for the output table files.                                                                                                                                                       |
| `-o`, `--output`           | path (directory)              | —       | yes      | Path to directory to put output table files. This directory must not already exist; it will be created.                                                                                  |
| `--document-id`            | flag                          | `false` | no       | Include the document ID for each item. This will add a `document_id` heading.                                                                                                            |
| `--spans`                  | flag                          | `false` | no       | Include span info. The spans included are the character spans for the entities, as well as the character spans for the sentences. This will add `spans`, and `sentences_spans` headings. |
| `--spans-in-sentences`     | flag                          | `false` | no       | Include character spans for the entities relative to the sentence they're in, not just relative to the entire document. This will add a `spans_in_sentences` heading.                    |
| `--values-separator`, `-s` | text                          | `::`    | no       | Separator for values in multi-valued attribute or argument fields in output formats that flatten field values to text.                                                                   |
| `--dewhitespace`           | flag                          | `false` | no       | Replace whitespace in text fields with visual marker characters.                                                                                                                         |