Request format

The base URL for API requests is:

https://api.konbert.com/v1

Specific endpoints are appended to this base URL. For example, the conversion endpoint is:

https://api.konbert.com/v1/convert

There are two common ways to send data to our API:

• multipart/form-data
• JSON with base64-encoded content

Using multipart/form-data

This method is ideal for uploading files directly. It's efficient and doesn't require encoding the file content.

Note the @file.csv placeholder, this indicates where the file is located on your disk.

curl -X POST https://konbert.com/api/v1/convert \
  -H "Authorization: Bearer ${API_KEY}" \
  -F "input[file][email protected]" \
  -F "input[format]=csv" \
  -F "input[options][delimiter]=," \
  -F "output[format]=parquet" \
  -F "sync=true"

Using JSON with base64-encoded content

This method is useful when you want to include the file content directly in the request body.

curl -X POST https://konbert.com/api/v1/convert \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "data": "encode_csv_in_base64",
      "format": "csv",
      "options": {
        "delimiter": ","
      }
    },
    "output": {
      "format": "parquet"
    },
    "sync": true
  }'

Both methods achieve the same result. Choose the one that best fits your use case and data handling requirements. Review your language's documentation for more information on how to use multipart/form-data and JSON.