# JSON to CSV Converter API

> For the complete documentation index, see [llms.txt](/llms.txt).

Flatten a JSON array into CSV with auto-detected record path, dot or bracket key flattening, configurable delimiter, quoting, and line endings.

Use this endpoint to add the tool to your app, site, workflow, or agent without rebuilding formulas, validation, examples, and docs.

- Slug: `json-to-csv-converter`
- Category: `dev`
- Version: `2026-04-22`
- Credits per successful call: 1
- Starts on: free
- Max payload: 1048576 bytes
- Privacy mode: `no_body_logs`
- Available on: free, starter, pro, business, scale
- Browser tool: https://miniwebtool.com/json-to-csv-converter/

## Endpoint

`POST https://api.miniwebtool.com/v1/tools/json-to-csv-converter/run`

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `json_text` | `str` | no | JSON array or object to convert |
| `array_path` | `str` | no | dot path to the array, e.g. data.items; blank auto-detects |
| `flatten_mode` | `str` | no | dot | bracket | none Choices: dot, bracket, none |
| `delimiter` | `str` | no | comma | semicolon | tab | pipe | custom Choices: comma, semicolon, tab, pipe, custom |
| `custom_delimiter` | `str` | no | single character used when delimiter=custom |
| `quoting` | `str` | no | minimal | all | nonnumeric | none Choices: minimal, all, nonnumeric, none |
| `include_header` | `str` | no | yes | no Choices: yes, no |
| `line_ending` | `str` | no | lf | crlf Choices: lf, crlf |

## Example request

```json
{
  "json_text": "[{\"id\":1,\"name\":\"Alice\"},{\"id\":2,\"name\":\"Bob\"}]",
  "delimiter": "comma"
}
```

## cURL

```bash
curl -X POST https://api.miniwebtool.com/v1/tools/json-to-csv-converter/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"json_text":"[{\"id\":1,\"name\":\"Alice\"},{\"id\":2,\"name\":\"Bob\"}]","delimiter":"comma"}'
```

## Response envelope

```json
{
  "request_id": "01K...",
  "tool": "json-to-csv-converter",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": {}
}
```

## Errors

Errors are RFC 7807 `application/problem+json`. Branch on `code`, not `title`.

## MCP

Agents can discover and call this tool through `https://api.miniwebtool.com/mcp` or `https://api.miniwebtool.com/v1/mcp` using MCP `tools/list` and `tools/call`.

## Frequently asked

### What does the JSON to CSV Converter API do?

Flatten a JSON array into CSV with auto-detected record path, dot or bracket key flattening, configurable delimiter, quoting, and line endings. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

### How much does one call cost?

1 credit per successful call. Failed calls do not bill.

### What parameters are required?

Required fields: (none). Full schema at `https://api.miniwebtool.com/v1/openapi.json`.

### Is this deterministic?

Yes. Same input, same output. Tool version: 2026-04-22.