CSV Tools Online

API Reference

Everything you need to integrate the CSV Tools Online API — authentication, conventions, and 35 fully-documented endpoints.

All systems operational
v1 · stable
Overview

Introduction

The CSV Tools Online API is a single, predictable REST surface for everything you can do inside the app — parsing CSVs, converting between formats, processing PDFs, running OCR, and extracting structured signals from messy text. It is designed to be readable on the first try and stable on the hundredth.

Fast

p50 < 200 ms for sync endpoints. Async jobs for anything heavy.

Secure

SHA-256 hashed keys, TLS 1.3, scoped permissions, full audit log.

Predictable

Versioned URLs, idempotency keys, consistent error envelope.

Base URL
https://api.csvtoolsonline.com/v1
Content type
application/json
Getting started

Quickstart

From zero to your first successful response in under a minute.

  1. 1
    Create an API key
    Sign in and create a key on the API dashboard. The full key is shown once.
  2. 2
    Add the Authorization header
    Send Authorization: Bearer ctok_live_… on every request.
  3. 3
    Call an endpoint
    All endpoints live under the versioned base URL.
Your first requestbash
curl -X POST https://api.csvtoolsonline.com/v1/csv/to-json \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"name,age\nAda,36"}'
Security

Authentication

Every request must include a Bearer token issued from your developer dashboard. Keys are hashed at rest with SHA-256, never logged, and can be scoped with permissions and an expiry date.

Sample headerhttp
Authorization: Bearer ctok_live_xxxxxxxxxxxxxxxxxxxx
HeaderValueDescription
AuthorizationBearer ctok_live_…Required. Your API key.
Content-Typeapplication/json | multipart/form-dataRequired for POST/PUT.
Idempotency-KeyuuidOptional. Safely retry POSTs without duplicates.
X-Request-IDuuidOptional. Echoed back in responses + logs for tracing.
Keep your keys secret. Treat keys like passwords — never commit them, never ship them in client-side bundles, rotate immediately if exposed.
Design

Conventions

Versioning

All endpoints are prefixed with /v1. Breaking changes ship under /v2 with a 6-month deprecation window.

Rate limits

Returned in X-RateLimit-Limit, X-RateLimit-Remaining, and Retry-After headers.

Idempotency

Send Idempotency-Key on POSTs; identical replays return the original response for 24 hours.

Pagination

Cursor-based via ?cursor=…&limit=…; next cursor returned as meta.next.

Webhooks

Async jobs notify your endpoint with an HMAC-signed X-Signature header.

Time & limits

Timestamps ISO-8601 UTC. File limits: 2 MB Free, 10 MB Starter, 50 MB Pro, 200 MB Business.

Failure modes

Errors & limits

Every error returns the same JSON envelope: a human error, a machine code, an optional offending field, and an actionable hint.

Error envelopejson
{
  "error": "Invalid permission(s): foo.",
  "code": "validation",
  "field": "permissions",
  "hint": "Allowed values: read, write, delete, webhooks, billing, admin."
}
StatusLabelDescription
400
Bad RequestValidation failed — inspect `error.field` and `error.hint`.
401
UnauthorizedMissing or invalid `Authorization` header.
402
Payment RequiredMonthly quota exceeded. Upgrade or wait for reset.
403
ForbiddenKey lacks the required scope for this endpoint.
404
Not FoundResource not found or key revoked.
413
Payload Too LargeFile or body exceeds your plan limit.
429
Too Many RequestsRate limit hit. Retry after `Retry-After` seconds.
500
Server ErrorSomething broke on our side. Retried automatically.
503
Service UnavailableMaintenance or upstream degraded.
Reference

API reference

35 of 35 endpoints. Click any entry in the sidebar to jump directly to its reference.

CSV & spreadsheets

7 endpoints
POST
/v1/csv/to-json
write

CSV → JSON

Convert CSV text into a JSON array. Auto-detects delimiter when not provided.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
delimiter
optional
Delimiter. Default `,`.
body
string
header
optional
First row is header. Default `true`.
body
boolean
Errors
400
invalid_csv
Could not parse CSV.
413
payload_too_large
Body exceeds plan limit.
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/to-json" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"...","delimiter":"...","header":true}'
Response
200 OKjson
{
  "rows": 1,
  "data": [{"name":"Ada","age":"36"}],
  "duration_ms": 12
}
POST
/v1/json/to-csv
write

JSON → CSV

Convert a JSON array of flat objects into CSV text.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
data
required
Array of flat objects.
body
object[]
columns
optional
Explicit column order.
body
string[]
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/json/to-csv" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"data":[],"columns":[]}'
Response
200 OKjson
{ "csv": "a,b\n1,2\n", "rows": 1 }
POST
/v1/csv/to-excel
write

CSV → Excel (.xlsx)

Convert CSV to a styled .xlsx workbook with auto-typed columns.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
sheet
optional
Sheet name. Default `Sheet1`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/to-excel" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"...","sheet":"..."}'
Response
200 OKjson
{ "url": "https://cdn.../export.xlsx", "size_kb": 8 }
POST
/v1/csv/to-xml
write

CSV → XML

Convert CSV rows to an XML document with configurable element names.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
root
optional
Root element. Default `rows`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/to-xml" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"...","root":"..."}'
Response
200 OKjson
{ "xml": "<rows><row><id>1</id></row></rows>" }
POST
/v1/csv/to-markdown
write

CSV → Markdown

Render CSV as a GitHub-flavoured Markdown table.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/to-markdown" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"..."}'
Response
200 OKjson
{ "markdown": "| a | b |\n|---|---|\n| 1 | 2 |" }
POST
/v1/csv/clean
write

Clean CSV

Trim whitespace, drop duplicates and empty rows, normalise newlines.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
ops
optional
`trim` `dedupe` `drop_empty` `lower_headers`.
body
string[]
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/clean" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"...","ops":[]}'
Response
200 OKjson
{ "csv": "...", "removed_rows": 4 }
POST
/v1/csv/merge
write

Merge CSVs

Merge multiple CSVs by stacking rows or joining on a key column.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
files
required
Two or more CSV payloads.
body
string[]
mode
optional
`stack` (default) or `join`.
body
string
on
optional
Join column name when `mode=join`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/merge" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"files":[],"mode":"...","on":"..."}'
Response
200 OKjson
{ "csv": "...", "rows": 240 }

JSON & data formats

6 endpoints
POST
/v1/json/to-yaml
write

JSON → YAML

Convert any JSON value into idiomatic YAML.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
data
required
JSON value.
body
any
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/json/to-yaml" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"data":"..."}'
Response
200 OKjson
{ "yaml": "a: 1\nb: 2\n" }
POST
/v1/yaml/to-json
write

YAML → JSON

Parse YAML text into JSON.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
yaml
required
Raw YAML text.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/yaml/to-json" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"yaml":"..."}'
Response
200 OKjson
{ "data": { "a": 1 } }
POST
/v1/json/to-sql
write

JSON → SQL

Generate INSERT statements for the chosen SQL dialect.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
data
required
Array of flat objects.
body
object[]
table
required
Target table name.
body
string
dialect
optional
`postgres` | `mysql` | `sqlite`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/json/to-sql" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"data":[],"table":"...","dialect":"..."}'
Response
200 OKjson
{ "sql": "INSERT INTO users (a,b) VALUES (1,2);" }
POST
/v1/json/minify
write

JSON minify / beautify

Compact or pretty-print JSON with configurable indent.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
data
required
JSON value.
body
any
mode
optional
`minify` (default) or `beautify`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/json/minify" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"data":"...","mode":"..."}'
Response
200 OKjson
{ "out": "{\"a\":1}" }
POST
/v1/xml/to-json
write

XML → JSON

Convert XML to a JSON tree with attribute preservation.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
xml
required
Raw XML text.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/xml/to-json" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"xml":"..."}'
Response
200 OKjson
{ "data": { "root": {} } }
POST
/v1/csv/to-parquet
write

CSV → Parquet

Convert CSV to columnar Apache Parquet with auto schema inference.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
csv
required
Raw CSV text.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/csv/to-parquet" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"csv":"..."}'
Response
200 OKjson
{ "url": "https://cdn.../data.parquet", "rows": 1000 }

PDF processing

10 endpoints
POST
/v1/pdf/compress
write

Compress PDF

Reduce PDF file size while preserving readability.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
PDF file (multipart).
body
binary
quality
optional
`low` | `medium` | `high`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/compress" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","quality":"..."}'
Response
200 OKjson
{ "url": "https://cdn.../compressed.pdf", "original_kb": 1820, "compressed_kb": 612 }
POST
/v1/pdf/merge
write

Merge PDFs

Combine multiple PDFs into a single document in order.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
files
required
Two or more PDFs.
body
binary[]
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/merge" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"files":[]}'
Response
200 OKjson
{ "url": "https://cdn.../merged.pdf", "pages": 24 }
POST
/v1/pdf/split
write

Split PDF

Split a PDF into multiple files by page ranges.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
ranges
required
e.g. `1-3,4-6,7`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/split" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","ranges":"..."}'
Response
200 OKjson
{ "files": ["https://cdn.../part-1.pdf"] }
POST
/v1/pdf/to-text
write

PDF → Text

Extract embedded text from a PDF (no OCR).

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/to-text" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>"}'
Response
200 OKjson
{ "text": "Lorem ipsum...", "pages": 4 }
POST
/v1/pdf/ocr
write

PDF OCR

Run OCR on scanned PDFs and images (Tesseract + LSTM).

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF or image.
body
binary
language
optional
BCP-47 code. Default `en`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/ocr" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","language":"..."}'
Response
200 OKjson
{ "text": "...", "pages": 3, "confidence": 0.94 }
POST
/v1/pdf/to-image
write

PDF → Image

Render PDF pages to PNG or JPG at chosen DPI.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
dpi
optional
Render DPI. Default `150`.
body
number
format
optional
`png` | `jpg`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/to-image" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","dpi":0,"format":"..."}'
Response
200 OKjson
{ "images": ["https://cdn.../page-1.png"] }
POST
/v1/pdf/to-word
write

PDF → Word

Convert PDF to an editable .docx preserving layout.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/to-word" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>"}'
Response
200 OKjson
{ "url": "https://cdn.../output.docx" }
POST
/v1/pdf/protect
write

Protect PDF

Add owner / user password and permission flags.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
password
required
Password to apply.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/protect" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","password":"..."}'
Response
200 OKjson
{ "url": "https://cdn.../protected.pdf" }
POST
/v1/pdf/unlock
write

Unlock PDF

Remove password from a PDF you own.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
password
required
Existing password.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/unlock" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","password":"..."}'
Response
200 OKjson
{ "url": "https://cdn.../unlocked.pdf" }
POST
/v1/pdf/watermark
write

Watermark PDF

Apply text or image watermark with rotation and opacity.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
file
required
Source PDF.
body
binary
text
optional
Watermark text.
body
string
opacity
optional
0–1. Default `0.3`.
body
number
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/pdf/watermark" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"file":"<base64-or-file>","text":"...","opacity":0}'
Response
200 OKjson
{ "url": "https://cdn.../watermarked.pdf" }

Extraction

4 endpoints
POST
/v1/extract/emails
write

Extract emails

Pull validated emails from text or any uploaded document.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
text
optional
Plain text.
body
string
file
optional
Or document upload.
body
binary
deduplicate
optional
Default `true`.
body
boolean
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/extract/emails" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"...","file":"<base64-or-file>","deduplicate":true}'
Response
200 OKjson
{ "emails": ["hi@x.com","hello@y.io"], "count": 2 }
POST
/v1/extract/phones
write

Extract phones

Extract & normalize phones to E.164 via libphonenumber.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
text
required
Plain text.
body
string
defaultCountry
optional
ISO code for ambiguous numbers.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/extract/phones" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"...","defaultCountry":"..."}'
Response
200 OKjson
{ "phones": [{ "e164":"+14155550123","region":"US","valid":true }] }
POST
/v1/extract/urls
write

Extract URLs

Extract URLs and resolve their hostnames.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
text
required
Plain text.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/extract/urls" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"..."}'
Response
200 OKjson
{ "urls": ["https://example.com"], "count": 1 }
POST
/v1/extract/regex
write

Regex match

Run a sandboxed regex against input text and return matches.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
text
required
Input text.
body
string
pattern
required
JS-compatible regex.
body
string
flags
optional
e.g. `gi`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/extract/regex" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"text":"...","pattern":"...","flags":"..."}'
Response
200 OKjson
{ "matches": ["42","7"], "count": 2 }

Generators & utilities

6 endpoints
POST
/v1/generate/uuid
write

Generate UUIDs

Generate v4 UUIDs in bulk.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
count
optional
1–1000. Default `1`.
body
number
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/generate/uuid" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"count":0}'
Response
200 OKjson
{ "uuids": ["b3f1...","a72c..."] }
POST
/v1/generate/ulid
write

Generate ULIDs

Generate lexicographically sortable ULIDs.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
count
optional
1–1000.
body
number
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/generate/ulid" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"count":0}'
Response
200 OKjson
{ "ulids": ["01H..."] }
POST
/v1/generate/password
write

Generate passwords

Generate strong passwords with entropy reporting.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
length
optional
Default `20`.
body
number
count
optional
Default `1`.
body
number
symbols
optional
Default `true`.
body
boolean
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/generate/password" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"length":0,"count":0,"symbols":true}'
Response
200 OKjson
{ "passwords": ["q9!Lm…"], "entropy_bits": 132 }
POST
/v1/generate/mock-csv
write

Mock CSV data

Generate realistic mock CSV rows from a schema (faker-backed).

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
rows
required
Row count.
body
number
schema
required
`[{name,type}]` definitions.
body
object[]
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/generate/mock-csv" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"rows":0,"schema":[]}'
Response
200 OKjson
{ "csv": "name,email\n..." }
POST
/v1/timestamp/convert
write

Timestamp convert

Convert between Unix epoch and ISO-8601 in any timezone.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
value
required
Epoch seconds or ISO date.
body
number | string
tz
optional
IANA timezone. Default UTC.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/timestamp/convert" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"value":0,"tz":"..."}'
Response
200 OKjson
{ "iso": "2026-06-25T12:00:00Z", "epoch": 1782820800 }
POST
/v1/jwt/sign
write

Sign JWT

Sign a JWT with HS256 or RS256 and return the compact token.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
payload
required
JWT claims.
body
object
secret
required
HMAC secret or private key.
body
string
alg
optional
`HS256` (default) | `RS256`.
body
string
Request
Requestbash
curl -X POST "https://api.csvtoolsonline.com/v1/jwt/sign" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json" \
  -d '{"payload":{},"secret":"...","alg":"..."}'
Response
200 OKjson
{ "token": "eyJhbGciOi..." }

Account

2 endpoints
GET
/v1/me/usage
read

Usage & quota

Read current billing period usage, quota and rate-limit state.

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
Request
Requestbash
curl -X GET "https://api.csvtoolsonline.com/v1/me/usage" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json"
Response
200 OKjson
{
  "tier": "pro",
  "quota_used": 12450,
  "quota_monthly": 100000,
  "rate_limit_per_min": 300,
  "period_end": "2026-07-25T00:00:00Z"
}
GET
/v1/me/keys
read

List keys

List active API keys on the account (prefixes only — full key never returned).

Parameters
NameInType
Authorization
required
Your API key.
header
Bearer <key>
Request
Requestbash
curl -X GET "https://api.csvtoolsonline.com/v1/me/keys" \
  -H "Authorization: Bearer ctok_live_..." \
  -H "Content-Type: application/json"
Response
200 OKjson
{ "keys": [{ "id":"k_…","prefix":"ctok_live_xxxx","permissions":["read","write"] }] }
Snippets

SDKs & snippets

The API is plain HTTP + JSON — call it from any language. Drop-in starters for the most common stacks:

Node.jsjavascript
const res = await fetch("https://api.csvtoolsonline.com/v1/csv/to-json", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CTO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ csv: "a,b\n1,2" }),
});
const data = await res.json();
Pythonpython
import os, requests

r = requests.post(
  "https://api.csvtoolsonline.com/v1/csv/to-json",
  headers={"Authorization": f"Bearer {os.environ['CTO_API_KEY']}"},
  json={"csv": "a,b\n1,2"},
)
print(r.json())
PHPphp
$ch = curl_init("https://api.csvtoolsonline.com/v1/csv/to-json");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer $apiKey",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode(["csv" => "a,b\n1,2"]),
  CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);

Ready to start building?

Create a free API key in 30 seconds. 100 requests per month, no card required.