0CodeKit
  • Getting Started
  • FAQ
    • Credits, Account & Prices
    • API Keys
    • Build an Integration
    • Help Desk
  • API Documentation
  • Examples and Use Cases
    • Use Cases & Tutorials
    • Code Examples
  • About Us
    • Service Level Agreement
    • GDPR & DPA / OnPrem Hosting
    • Affiliate Program
Powered by GitBook
On this page

Was this helpful?

API Documentation

Up-to-date API Documentation of 0CodeKit.

PreviousHelp DeskNextExamples and Use Cases

Last updated 3 months ago

Was this helpful?

Remarks

This document is no longer maintained. Please, use to visit our up-to-date OpenAPI documentation.

Base URL

https://prod.0codekit.com

Authentication

Include a key:value pair in the header of the request, where the key is auth and the value your API key that can be obtained in .

For example: auth:a4c3dcc5-8e41-4cad-bd5f-c24086baba00

Functions

Note on the Asynchronous Python Code Executor Pricing

The cost of the asynchronous Python code executor is proportional to that of the regular synchronous Python executor. The key difference is that the asynchronous endpoint allows your code to run up to 5 times longer, with a maximum total runtime of 15 minutes.

  • Charges are applied every 3 minutes, which is the standard execution time increment for the synchronous Python executor.

  • You are charged for each 3-minute interval (or part thereof) that your code runs asynchronously.

this URL
your 0CodeKit account portal

Merge audio into a video file with optional customizations.

post

Merges a video file and an audio file into a single video file, optionally applying various customizations like trimming, fading, and more.

Header parameters
authstringRequired
Body
videostringRequired

The URL of the video file.

Example: https://example.com/video.mp4
audiostringRequired

The URL of the audio file.

Example: https://example.com/audio.mp3
fileNamestringOptional

The name of the merged video.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/merge-video-audio HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "video": "https://example.com/video.mp4",
  "audio": "https://example.com/audio.mp3",
  "fileName": "text"
}
{
  "outputUrl": "https://example.com/output.mp4"
}

Validate a Factur-X/Zugferd PDF.

post

Factur-X/Zugferd is a standard for digital invoices. The data is encoded into an XML, which is attached to a human-readable PDF file. This endpoint checks that the given PDF has an attached XML invoice, and validates it according to the Factur-X/Zugferd specification (level EN16931). It also returns the XML invoice for further processing.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/facturx/validate HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}
{
  "valid": true,
  "errors": [
    "text"
  ],
  "invoice": "text"
}

Embed a Factur-X/Zugferd XML into an existing PDF.

post

Factur-X/Zugferd is a standard for digital invoices. The data is encoded into an XML, which is attached to a human-readable PDF file. This endpoint embeds an existing XML invoice into a PDF file which is not yet a Factur-X/Zugferd invoice. It also validates that the XML is valid. To create a valid Factur-X/Zugferd invoice, the user has to guarantee that the provided PDF is in PDF/A format.

Header parameters
authstringRequired

The API key that can be found on 0codekit.com.

Body
urlstringOptional

The PDF URL.

bufferstringOptional

The Base64-encoded PDF file. Can be specified instead of url.

xmlstringRequired

The Factur-X/Zugferd XML invoice that shall be embedded.

getAsUrlbooleanOptional

Whether the PDF should be returned as a URL. Default is false.

fileNamestringOptional

The PDF file name. Default is a random ID.

Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /business/facturx/embed HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "url": "text",
  "buffer": "text",
  "xml": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{}

Extract text from given PDF (Advanced OCR)

post

Extracts text and specific data from documents, supporting OCR and specialized workflows.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
urlstringOptional

The URL to the document.

Example: https://icseindia.org/document/sample.pdf
bufferstringOptional

The Base64-encoded buffer. Can be provided instead of url.

resultTypestring · enumRequired

Result type specifies the output type.

Possible values:
workflowstringRequired

A workflow outlines steps for processing documents, including analysis, extraction, and transformation. It uses unique identifiers to track and retrieve results for each document.

languagestringOptional

The language of the uploaded document.

documentTypestringOptional

The type of the uploaded document.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/advancedocr HTTP/1.1
Host: v2.1saas.co
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 144

{
  "url": "https://icseindia.org/document/sample.pdf",
  "buffer": "text",
  "resultType": "ocr",
  "workflow": "text",
  "language": "text",
  "documentType": "text"
}
{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Check rate limit.

post

A simple way to implement rate limiting by checking whether a new request is allowed now.

Header parameters
authstringRequired
Body
namestringRequired

An arbitrary name for this traffic light.

intervalnumberRequired

The minimum time that must pass after one request was allowed.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/trafficlight HTTP/1.1
Host: v2.1saas.co
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "name": "text",
  "interval": 1
}
{
  "ok": true
}

Extract a custom object from a given text.

post

This function takes a text input, a context for added relevance, and a list of fields with their descriptions. It leverages an LLM to extract the specified information from the text and organizes it into a structured object.

Header parameters
authstringRequired
Body
textstringRequired

The text in which the information will be searched.

Example: Greetings! I am Zog, an alien from planet Blip, 142 years old, and a passionate collector of cosmic dust.
contextstringRequired

Prompt that contextualizes the text.

Example: A brief self-introduction from an alien applying for an intergalactic research role.
Responses
200
Success
application/json
Responseany
400
Bad Request
application/json
post
POST /ai/extract-from-text HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 355

{
  "text": "Greetings! I am Zog, an alien from planet Blip, 142 years old, and a passionate collector of cosmic dust.",
  "context": "A brief self-introduction from an alien applying for an intergalactic research role.",
  "fields": [
    {
      "name": "age",
      "description": "Age of the alien. Just a number, no other text.",
      "validationRegex": "^(?:[1-9][0-9]?|1[0-9]{2}|200)$"
    }
  ]
}

No content

Find the best match for a query string from a list of targets.

post

This function takes a query string and a list of target strings. It uses an LLM to find the best match(es), accounting for variations in the query string, and returns the closest match(es) based on the options provided.

Header parameters
authstringRequired
Body
queryStringstringRequired

The main string you want to match against the target list. Typically, this is the name or entity you are searching for.

Example: Alf from Melmac
contextstringOptional

A short description of the type of data being matched. This helps provide additional clarity for the AI in determining the best match.

Example: Names of people
targetListstring[]Required

The list of potential matches. Each entry in this list represents a possible candidate for matching with the query string.

Example: ["Willie Tanner","Gordon Shumway","Kate Tanner","Trevor Ochmonek"]
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/fuzzy-match HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 168

{
  "queryString": "Alf from Melmac",
  "context": "Names of people",
  "targetList": [
    "Willie Tanner",
    "Gordon Shumway",
    "Kate Tanner",
    "Trevor Ochmonek"
  ],
  "options": {
    "maxResults": 2
  }
}
{
  "matches": [
    "Gordon Shumway"
  ]
}

Redact sensitive information from pdf.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

sensitiveContentstringRequired

A text prompt describing which data from the document should be covered.

Example: All people names and addresses should be considered sensitive data.
fileNamestringOptional

The file name the result PDF will have. Default is a random ID.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
languagestringOptional

The language of the document in ISO 639-1 nomenclature. Default is 'en' (English).

Example: de
Responses
200
Success
400
Bad Request
application/json
post
POST /ai/redact-pdf HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 169

{
  "url": "text",
  "buffer": "text",
  "sensitiveContent": "All people names and addresses should be considered sensitive data.",
  "fileName": "text",
  "getAsUrl": true,
  "language": "de"
}
{
  "url": "text",
  "fileName": "text"
}
  • Remarks
  • Base URL
  • Authentication
  • Functions
  • POSTExtract text from given PDF (Advanced OCR)
  • POSTExtract a custom object from a given text.
  • POSTFind the best match for a query string from a list of targets.
  • POSTRedact sensitive information from pdf.
  • POSTDetect adult content.
  • POSTDetect text in an image.
  • POSTText Entity Detection.
  • POSTRemove image background.
  • POSTDetect brand
  • POSTGenerate python code.
  • POSTDetect color.
  • POSTToo Long To Read
  • POSTDetect language.
  • POSTTranscribe audio.
  • POSTDetect labels in an image.
  • POSTGenerate an image.
  • POSTExtract contact information.
  • POSTGenerate javascript code.
  • POSTDetect mood.
  • POSTDetect face.
  • POSTDetect email type.
  • POSTPDF Optical Character Recognition.
  • POSTCheck content policy.
  • POSTTranslate text to a specified language.
  • POSTHash a message.
  • POSTDecrypt ciphertext.
  • POSTEncrypt plaintext.
  • POSTCalculate geographical distance.
  • POSTCalculate the BMI.
  • POSTFind gender of name.
  • POSTRetrieve credits.
  • POSTRemove duplicates from the list.
  • POSTParse URL query parameters.
  • POSTGet website logo URL.
  • POSTGet thumbnail for video.
  • POSTGet JSON values from keys.
  • POSTCheck rate limit.
  • POSTSplit name.
  • POSTExpand URL.
  • POSTBuild UTM link.
  • POSTParse UTM link.
  • POSTParse HTML.
  • POSTMerge audio into a video file with optional customizations.
  • POSTConvert between ISO and nation name.
  • POSTConvert Outlook item files.
  • POSTConvert between currencies.
  • POSTConvert IP to location.
  • POSTConvert CSV to JSON.
  • POSTConvert CSV to array.
  • POSTLook up VAT rate.
  • POSTCheck for freemail.
  • POSTValidate Geolocation.
  • POSTValidate the phone number.
  • POSTValidate IBAN
  • POSTValidate a VAT ID.
  • POSTValidate a BIC.
  • POSTVerify domain.
  • POSTValidate a Factur-X/Zugferd PDF.
  • POSTEmbed a Factur-X/Zugferd XML into an existing PDF.
  • POSTUpload a temporary file.
  • POSTDelete from permanent storage.
  • POSTGet permanent file.
  • POSTList permanent files.
  • POSTUpload to permanent storage.
  • POSTDelete a global variable.
  • POSTUpdate a global variable.
  • POSTGet a global variable.
  • POSTList all variables.
  • POSTAdd a global variable.
  • POSTDelete a JSON bin.
  • POSTPut data into JSON bin.
  • POSTGet a JSON bin.
  • POSTList JSON bins.
  • POSTAdd a JSON bin.
  • POSTRetrieve calendar weeks
  • POSTCheck weekend date.
  • POSTConvert between timezones.
  • POSTRetrieve holidays.
  • POSTRetrieve date range details.
  • POSTMonthly date details
  • POSTCheck auth status.
  • POSTGenerate a city.
  • POSTGenerate a number.
  • POSTGenerate random string.
  • POSTGenerate a name.
  • POSTGenerate a color.
  • POSTGenerate user mockdata.
  • POSTScrape website.
  • POSTEncode JWT.
  • POSTDecode JWT.
  • POSTGenerate a QR code.
  • POSTDecode a QR code.
  • POSTDecode barcode.
  • POSTGenerate barcode.
  • POSTEvaluate text against a regex.
  • POSTKeyword search in text.
  • POSTCompare two strings.
  • POSTExtract text from body.
  • POSTExecute Python code.
  • POSTExecute async Python.
  • POSTExecute JavaScript code.
  • POSTGet async task status.
  • POSTGenerate Bar Chart
  • POSTGenerate Doughnut Chart
  • POSTGenerate Line Chart
  • POSTBlur an image.
  • POSTConvert an image.
  • POSTGet EXIF data.
  • POSTCrop an image.
  • POSTFlip an image.
  • POSTConvert HTML to image.
  • POSTOverlay two images.
  • POSTResize an image.
  • POSTRotate an image.
  • POSTSharpen an image.
  • POSTDraw image on PDF.
  • POSTDraw text on PDF.
  • POSTEdit PDF metadata.
  • POSTGet PDF metadata.
  • POSTAdd PDF pages.
  • POSTRemove PDF pages.
  • POSTResize PDF pages.
  • POSTRotate PDF pages.
  • POSTConvert PDF to Base64.
  • POSTCompress PDF.
  • POSTCount PDF pages.
  • POSTDecrypt PDF.
  • POSTCreate empty PDF.
  • POSTConvert DOCX to PDF.
  • POSTEncrypt PDF.
  • POSTGet PDF metadata.
  • POSTConvert HTML to PDF.
  • POSTConvert Markdown to PDF.
  • POSTMerge PDF files.
  • POSTConvert PDF to image.
  • POSTSplit PDF file.
  • POSTCreate shortened URL.
  • POSTDelete shortened URL.
  • POSTList shortened URLs.
  • POSTGet shortened URL.
  • POSTUpdate shortened URL.

Detect adult content.

post

Check if the content is appropriate for all audiences.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
imageUrlstringRequired

The URL of the image to be checked.

Example: https://example.com/image.jpg
Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /ai/detectadultcontent HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "imageUrl": "https://example.com/image.jpg"
}
{}

Detect text in an image.

post

Detects text in an image using the Azure Computer Vision API.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
imageUrlstringRequired

The URL of the image to analyze.

Example: https://example.com/image.jpg
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/picturetextrecognition HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "imageUrl": "https://example.com/image.jpg"
}
{
  "recognizedTexts": [
    "text"
  ]
}

Text Entity Detection.

post

Identities Entities From Input Text.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired

Text for entity detection.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/entitydetection HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "text": "text"
}
{
  "detections": [
    {
      "text": "text",
      "category": "text",
      "offset": 1,
      "length": 1,
      "confidenceScore": 1
    }
  ]
}

Remove image background.

post

Remove background from image url or buffer.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringOptional
bufferstringOptional
getAsUrlbooleanRequired
fileNamestringOptional
Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /ai/removebg HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{}

Detect brand

post

Detect brand from given image.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
imageUrlstringRequired

Image for brand detection.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/detectbrand HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "imageUrl": "text"
}
{
  "brands": [
    "text"
  ]
}

Generate python code.

post

Generate python code based on provided prompt.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
promptstringRequired

Prompt to generate python code.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/generatepythoncode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "prompt": "text"
}
{
  "id": "text",
  "code": "text"
}

Detect color.

post

Detect color from given image.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
imageUrlstringRequired

Image for color detection.

Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /ai/detectcolor HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "imageUrl": "text"
}
{}

Too Long To Read

post

Creates a summary of the given text.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
promptstringRequired

The text to be summarized.

Example: Once upon a time, in a far away land, there lived a young girl who was full of dreams and aspirations. She was passionate about exploring the world and discovering all its secrets. She wanted to see the wonders of the world, to meet new people, to learn new things, and to experience life in all its glory. As a young girl, she often thought of what it would be like to journey to exotic places, to explore the unknown and to find her place in the world. She wanted to be free to make her own decisions, to choose her own destiny, and to be independent. ne day, she decided she was ready to embark on her quest. She packed her bags, said goodbye to her family, and set off on her travels. She went to places she had only dreamed of, and experienced things she had never imagined. She met people from all walks of life, made new friends, and experienced new cultures. She explored the great outdoors and embraced nature in all its beauty. She tried new foods, and found her favorite cuisines. Through it all, she found her own path and discovered her true purpose in life.
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/toolongtoread HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 1084

{
  "prompt": "Once upon a time, in a far away land, there lived a young girl who was full of dreams and aspirations. She was passionate about exploring the world and discovering all its secrets. She wanted to see the wonders of the world, to meet new people, to learn new things, and to experience life in all its glory. As a young girl, she often thought of what it would be like to journey to exotic places, to explore the unknown and to find her place in the world. She wanted to be free to make her own decisions, to choose her own destiny, and to be independent. ne day, she decided she was ready to embark on her quest. She packed her bags, said goodbye to her family, and set off on her travels. She went to places she had only dreamed of, and experienced things she had never imagined. She met people from all walks of life, made new friends, and experienced new cultures. She explored the great outdoors and embraced nature in all its beauty. She tried new foods, and found her favorite cuisines. Through it all, she found her own path and discovered her true purpose in life."
}
{
  "result": {
    "id": "cmpl-2iZ3t9nGQ4aJ7Qb4Q7Xq8Zn5",
    "data": "A young girl with dreams of exploring the world and experiencing life's wonders embarks on a journey to exotic places. She meets people from different cultures, tries new foods, and enjoys nature's beauty. Throughout her travels, she finds her own path and discovers her true purpose in life."
  }
}

Detect language.

post

Detect language of given text.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired

Text for language detection.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/languagedetection HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "text": "text"
}
{
  "name": "text",
  "iso6391Name": "text",
  "confidenceScore": 1
}

Transcribe audio.

post

Transcribe an audio file to text. This supports the following file types: flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm. The maximum file size is 25MB.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringOptional

The URL to the audio file.

Example: https://www.pacdv.com/sounds/voices/am-i-totally-screwed-or.wav
bufferstringOptional

The Base64-encoded audio file. Can be provided instead of url.

langstringOptional

The audio language. Default is en.

Example: en
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/transcribe HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "url": "https://www.pacdv.com/sounds/voices/am-i-totally-screwed-or.wav",
  "buffer": "text",
  "lang": "en"
}
{
  "text": "Ladies and gentlemen, am I totally screwed, or what?"
}

Detect labels in an image.

post

Detects labels in an image using the Google Vision API.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
imageUrlstringRequired

The URL of the image to analyze.

Example: https://example.com/image.jpg
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/pictureobjectrecognition HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "imageUrl": "https://example.com/image.jpg"
}
{
  "recognizedLabels": [
    "text"
  ]
}

Generate an image.

post

Generate an image based on prompt.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body

Size of the output image.

promptstringRequired

Prompt to generate image.

nnumber · max: 10Required

Number of output image's to be generated.

sizestring · enumRequiredPossible values:
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/generateimage HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "prompt": "text",
  "n": 1,
  "size": "256x256"
}
{
  "id": 1,
  "image": [
    {
      "url": "text"
    }
  ]
}

Extract contact information.

post

Extract contact information from given prompt.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
promptstringRequired

Prompt for contact info extraction.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/extractcontactinformation HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "prompt": "text"
}
{
  "id": "text",
  "data": {
    "name": "text",
    "phone": "text",
    "email": "text",
    "address": "text",
    "website": "text"
  }
}

Generate javascript code.

post

Generate javascript code based on provided prompt.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
promptstringRequired

Prompt to generate javascript code.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/generatejavascriptcode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "prompt": "text"
}
{
  "id": "text",
  "code": "text"
}

Detect mood.

post

Detect mood from given text.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/mooddetection HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "text": "text"
}
{
  "moodOverall": "text",
  "moodScore": {
    "positive": 1,
    "neutral": 1,
    "negative": 1
  },
  "moodPerSentence": [
    {
      "mood": "text",
      "text": "text"
    }
  ]
}

Detect face.

post

Detect face from given image.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
imageUrlstringRequired

Image for face detection.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/detectface HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 19

{
  "imageUrl": "text"
}
{
  "totalFaces": 1,
  "facesPosition": [
    {
      "left": 1,
      "top": 1,
      "width": 1,
      "height": 1
    }
  ]
}

Detect email type.

post

Detect email type from provided subject and body.ß

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
subjectstringRequired

Subject of email.

bodystringRequired

Body of email.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/detectemailtype HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "subject": "text",
  "body": "text"
}
{
  "id": "text",
  "type": "text"
}

PDF Optical Character Recognition.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
pdfUrlstringRequired

PDF URL.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/pdfocr HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "pdfUrl": "text"
}
{
  "recognizedText": "text"
}

Check content policy.

post

Check if the content is appropriate to be posted on the internet.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
promptstringRequired

The text containing the content to be checked.

Example: Hello world!
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/checkcontentpolicy HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "prompt": "Hello world!"
}
{
  "id": "cmpl-2iZ3t9nGQ4aJ7Qb4Q7Xq8Zn5",
  "safe": true,
  "data": "Content is safe."
}

Translate text to a specified language.

post

Translates the provided text into the specified target language using Google Translate API.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired

The text to be translated.

Example: Hello, world!
resultLangstringRequired

The target language code to translate the text into.

Example: es
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /ai/translate HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "text": "Hello, world!",
  "resultLang": "es"
}
{
  "translation": "text"
}

Hash a message.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
hashTypestring · enumRequiredPossible values:
messagestringRequired
secretKeystringOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /crypto/hash HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "hashType": "MD5",
  "message": "text",
  "secretKey": "text"
}
{
  "hashedText": "text"
}

Decrypt ciphertext.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
cryptoTypestring · enumRequiredPossible values:
ciphertextstringRequired

The ciphertext.

secretKeystringRequired

The encryption key.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /crypto/decrypt HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "cryptoType": "AES",
  "ciphertext": "text",
  "secretKey": "text"
}
{
  "decryptedText": "text"
}

Encrypt plaintext.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
cryptoTypestring · enumRequiredPossible values:
messagestringRequired

The plaintext.

secretKeystringRequired

The encryption key.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /crypto/encrypt HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "cryptoType": "AES",
  "message": "text",
  "secretKey": "text"
}
{
  "encryptedText": "text"
}

Calculate geographical distance.

post

Returns the distance between a start and end point. The distance is calculated using a specific mode of travel, which can influence the route taken and is also used to estimate the amount of time it takes to travel.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
startPointstringRequired

The start point.

Example: Flensburg
endPointstringRequired

The end point.

Example: Istanbul
modestring · enumRequired

The mode of travel.

Example: walkingPossible values:
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /calculate/geodistance-v2 HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "startPoint": "Flensburg",
  "endPoint": "Istanbul",
  "mode": "walking"
}
{
  "distanceInKM": 1,
  "duration": {
    "hours": 1,
    "minutes": 1
  }
}

Calculate the BMI.

post

Uses the height and weight of a person to calculate their BMI as well as several other related values, including their recommended nutrients.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
weightnumberRequired

The weight in kilograms.

Example: 80
heightnumberRequired

The height in centimeters.

Example: 180
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /calculate/bmi HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "weight": 80,
  "height": 180
}
{
  "bmi": 24.69,
  "bmiClassification": "normal",
  "dbw": 72,
  "kcal": 2160,
  "nutrients": {
    "carbohydrates": 324,
    "protein": 81,
    "fat": 60
  }
}

Find gender of name.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
firstnamestringOptional

The first name.

fullnamestringOptional

The full name. The first name is only used if firstname is not provided.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/gender HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "firstname": "text",
  "fullname": "text"
}
{
  "firstname": "text",
  "lastname": "text",
  "detectedGender": "male"
}

Retrieve credits.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /user/retrievecredits HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "credits": 1
}

Remove duplicates from the list.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/duplicate HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 11

{
  "list": []
}
{
  "list": []
}

Parse URL query parameters.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired

The URL.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/parseurlquery HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "url": "text"
}
{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Get website logo URL.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/logo HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "url": "text"
}
{
  "type": "text",
  "url": "text",
  "size": "text"
}

Get thumbnail for video.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequiredPattern: ^(https?:\/\/)?([\w-]+\.)+[\w-]+(\/[\w-./?%&=]*)?$
getAsUrlbooleanOptional
fileNamestringOptional
Responses
200
Success
400
Bad Request
application/json
post
POST /operator/thumbnail HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "url": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text",
  "fileName": "text"
}

Get JSON values from keys.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
externalbooleanRequired
jsonany ofRequired
stringOptional
or
keyany ofRequired
stringOptional
or
string[]Optional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/advancedswitch HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "external": true,
  "json": "text",
  "key": "text"
}
{
  "found": []
}

Split name.

post

Split a full name into its first and last name.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
namestringRequired

The full name that will be split.

reversedbooleanOptional

Whether first and last name should be reversed. Might be useful in languages where the last name comes first, e.g. Chinese.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/splitname HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "name": "text",
  "reversed": true
}
{
  "firstName": "text",
  "lastName": "text"
}

Expand URL.

post

Converts a shortened URL from any URL shortener to its expanded form.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired

The URL.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/urlexpander HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "url": "text"
}
{
  "unshortenedUrl": "text"
}

Build UTM link.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired

The base URL.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/utm/build HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 123

{
  "url": "text",
  "utm": {
    "utm_source": "text",
    "utm_medium": "text",
    "utm_campaign": "text",
    "utm_content": "text",
    "utm_term": "text"
  }
}
{
  "url": "text"
}

Parse UTM link.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/utm/parse HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "url": "text"
}
{
  "utm_source": "text",
  "utm_medium": "text",
  "utm_campaign": "text",
  "utm_content": "text",
  "utm_term": "text"
}

Parse HTML.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
htmlstringOptional
urlstringOptional
allbooleanOptional
selectorstringOptional
tagSelectorstringOptional
idSelectorstringOptional
classSelectorstringOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /operator/htmlparser/get HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 121

{
  "html": "text",
  "url": "text",
  "all": true,
  "selector": "text",
  "tagSelector": "text",
  "idSelector": "text",
  "classSelector": "text"
}
{
  "data": "text"
}

Convert between ISO and nation name.

post

Takes a nation name or a nation ISO code and outputs the corresponding nation name and ISO code.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
isostringOptional

The ISO code of the nation.

nationstringOptional

The English name of the nation.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /convert/nationiso HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "iso": "text",
  "nation": "text"
}
{
  "iso": "text",
  "nation": "text"
}

Convert Outlook item files.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringOptional
bufferstringOptional
Responses
200
Success
application/json
Responseany
400
Bad Request
application/json
post
POST /convert/msgtojson HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}

No content

Convert between currencies.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
sourceCurrencystringRequired
targetCurrencystringRequired
amountnumberRequired
dateFormatstringOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /convert/currency HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "sourceCurrency": "text",
  "targetCurrency": "text",
  "amount": 1,
  "dateFormat": "text"
}
{
  "oldAmount": 1,
  "oldCurrency": "text",
  "convertedAmount": 1,
  "currency": "text",
  "dataDate": "text"
}

Convert IP to location.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
ipstringRequired

The IP address.

Example: 87.155.190.147
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /convert/iptogeo HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "ip": "87.155.190.147"
}
{
  "status": "success",
  "country": "Germany",
  "countryCode": "De",
  "region": "RP",
  "regionName": "Rheinland-Pfalz",
  "city": "Waldfischbach-Burgalben",
  "zip": "67714",
  "lat": 49.2794,
  "lon": 7.6671,
  "timezone": "Europe/Berlin",
  "isp": "Deutsche Telekom AG",
  "org": "Deutsche Telekom AG",
  "as": "AS3320 Deutsche Telekom AG",
  "query": "87.155.190.147"
}

Convert CSV to JSON.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
csvstringRequired

The CSV string that will be converted.

noheaderbooleanOptional

If this is false, the first line will be interpreted as column names instead of data. Default is false.

delimiterany ofOptional

The delimiter between the different columns. Can be auto for automatic detection of delimiters, or an array of delimiters. Default is auto.

string · enumOptionalPossible values:
or
string[]Optional
trimbooleanOptional

Whether spaces around column values should be trimmed. Default is true.

ignoreEmptybooleanOptional

Whether empty column values should be ignored, instead of being output as empty. Default is false.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /convert/csv/json HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 80

{
  "csv": "text",
  "noheader": true,
  "delimiter": "auto",
  "trim": true,
  "ignoreEmpty": true
}
{
  "json": []
}

Convert CSV to array.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
csvstringRequired

The CSV string that will be parsed.

omitFirstRowbooleanOptional

Whether to omit the first row. Default is false.

delimiterstringRequired

The delimiter by which the rows will be split.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /convert/csv/array HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "csv": "text",
  "omitFirstRow": true,
  "delimiter": "text"
}
{
  "array": [
    [
      "text"
    ]
  ]
}

Look up VAT rate.

post

Looks up the VAT rate for the specified country in the European Union.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
countryCodestringRequired

The ISO 3166-1 alpha-2 code of the country.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/lookupvatrates HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "countryCode": "text"
}
{
  "country": "text",
  "vat_name": "text",
  "vat_abbr": "text",
  "standard_rate": 1,
  "reduced_rate": 1,
  "reduced_rate_alt": 1,
  "super_reduced_rate": 1,
  "parking_rate": 1
}

Check for freemail.

post

Checks whether the email address is from a free email provider.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
emailstringRequired

The email address that should be checked.

Example: pa1928sch@hotmail.com
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/isfreemail HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "email": "pa1928sch@hotmail.com"
}
{
  "freeEmailProvider": true,
  "provider": "hotmail.com"
}

Validate Geolocation.

post

This endpoint takes an address or coordinates, and checks whether it is valid.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
addressstringRequired

The location. Can be an address or coordinates.

Example: Bavaria Donau 11, Passau
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/validate/geolocation HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 38

{
  "address": "Bavaria Donau 11, Passau"
}
{
  "valid": true,
  "address": "Bavaria Donau 11, Passau"
}

Validate the phone number.

post

Checks whether the phone number is valid.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
phoneNumberstringRequired

The phone number to validate.

Example: (+81) 090-1234-5678
countryCodestringOptional

Short abbreviation of a country.

Example: JP
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/validate/phonenumber HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "phoneNumber": "(+81) 090-1234-5678",
  "countryCode": "JP"
}
{
  "phoneNumber": "(+81) 090-1234-5678",
  "internationNumber": "\"+81 90 1234 5678",
  "number": "+819012345678",
  "nationalNumber": "9012345678",
  "countryCode": "JP",
  "possibleNumber": true,
  "isValid": true
}

Validate IBAN

post

Checks whether the provided IBAN (International Bank Account Number) is valid.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
ibanstringRequired

The IBAN

Example: DE02120300000000202051
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/validate/iban HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "iban": "DE02120300000000202051"
}
{
  "valid": true
}

Validate a VAT ID.

post

Checks whether the provided VAT (Valued Added Tax) ID is valid using a service provided by VIES, If available, this also returns the associated name and address

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
vatIdstringOptional

The VAT ID. Must start with a two-digit country code.

Example: DE123456789
countryCodestring · enumOptional

The country code of the VAT ID.

Example: ITPossible values:
idstringOptional

The number part of the VAT ID.

Example: 07643520567
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/validate/vat HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "vatId": "DE123456789",
  "countryCode": "IT",
  "id": "07643520567"
}
{
  "countryCode": "text",
  "vatNumber": "text",
  "requestDate": "text",
  "valid": true,
  "name": "text",
  "address": "text"
}

Validate a BIC.

post

Checks whether a BIC (Bank Identifier Code) is valid.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
bicstringRequired

The BIC.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/validate/bic HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 14

{
  "bic": "text"
}
{
  "valid": true
}

Verify domain.

post

Verifies a domain by performing an HTTP GET request against it.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
domainstringRequired

The domain name.

Example: https://www.google.com
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /business/verify/domain HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "domain": "https://www.google.com"
}
{
  "mainDomain": "text",
  "isValid": true
}

Upload a temporary file.

post

Uploads a file buffer to temporary storage and provides a URL. The file is deleted after 24 hours.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
fileNamestringOptional

The file name. Default is a random string.

Example: my-file.txt
bufferstringRequired

The Base64-encoded file buffer.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/temp HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "fileName": "my-file.txt",
  "buffer": "text"
}
{
  "url": "text",
  "fileName": "text"
}

Delete from permanent storage.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
fileIdstringRequired
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/perm/del HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "fileId": "text"
}
{
  "message": "text"
}

Get permanent file.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
fileNamestringOptional
fileIdstringOptional
getAsUrlbooleanOptional
Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /storage/perm/get HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "fileName": "text",
  "fileId": "text",
  "getAsUrl": true
}
{}

List permanent files.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/perm/list HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "files": [
    {
      "fileId": "text",
      "fileName": "text"
    }
  ]
}

Upload to permanent storage.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
fileUrlstringOptional
fileBufferstringOptional
uploadNamestringOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/perm/add HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 58

{
  "fileUrl": "text",
  "fileBuffer": "text",
  "uploadName": "text"
}
{
  "fileId": "text"
}

Delete a global variable.

post

A global variable can only be deleted by the user that created it.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
variableIdstringRequired

The variable name.

Example: myVariable
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/globalvariables/del HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "variableId": "myVariable"
}
{
  "message": "Successfully deleted global variable with id myVariable."
}

Update a global variable.

post

Changes the value of the given global variable to the new value.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
variableNamestringRequired

The name of the variable to update.

Example: myVariable
variableValuestringRequired

The new value of the variable.

Example: myValue
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/globalvariables/update HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "variableName": "myVariable",
  "variableValue": "myValue"
}
{
  "variableName": "myVariable",
  "variableValue": "myValue"
}

Get a global variable.

post

The user can only access a global variable that they created themselves.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
variableNamestringRequired

The name of the variable to get.

Example: myVariable
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/globalvariables/get HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "variableName": "myVariable"
}
{
  "variableName": "myVariable",
  "variableValue": "myValue"
}

List all variables.

post

Lists all variables that the user has created before and not yet deleted.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/globalvariables/list HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "variables": [
    {
      "variableName": "myVariable",
      "variableValue": "myValue"
    }
  ]
}

Add a global variable.

post

The global variable is only visible for the user that created it. If variableName is not provided, it is generated automatically.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
variableNamestringOptional

The name of the variable to create. Default is auto-generated.

Example: myVariable
variableValuestringRequired

The value to assign to the variable.

Example: myValue
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/globalvariables/add HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "variableName": "myVariable",
  "variableValue": "myValue"
}
{
  "variableName": "myVariable",
  "variableValue": "myValue"
}

Delete a JSON bin.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
binIdstringRequired

The ID of the JSON bin.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/json/del HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "binId": "text"
}
{
  "message": "text"
}

Put data into JSON bin.

post

Replaces the data in the JSON bin with the new data.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
jsonanyRequired

The JSON data to put into the bin.

binIdstringRequired

The ID of the JSON bin that will be modified.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/json/put HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "json": null,
  "binId": "text"
}
{
  "binId": "text"
}

Get a JSON bin.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
binIdstringRequired

The ID of the JSON bin.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/json/get HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "binId": "text"
}
{
  "binId": "text",
  "data": null
}

List JSON bins.

post

Returns a list of the bin IDs of all JSON bins this user has created.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/json/list HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "message": "text",
  "bins": [
    {
      "binId": "text"
    }
  ]
}

Add a JSON bin.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
jsonanyRequired

The JSON data to store in the bin.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /storage/json/add HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "json": null
}
{
  "message": "text",
  "binId": "text"
}

Retrieve calendar weeks

post

This endpoint can be used to return varied calendar-week information according to the data passed in the request.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
datestringOptional

The date parameter provides the week number of the year relative to the date, along with the starting and ending week.

Example: 20.01.2022
weekNumbernumberOptional

The weekNumber parameter provides the workingDate of that week, along with the starting and ending day of the week.

Example: 5
yearnumberOptional

The year parameter provides year of the given weekNumber.

Example: 2023
unixTimestampnumberOptional

The date in unixTimestamp format.

Example: 1642918727
dateFormatstringOptional

Format of provided date.

Example: DD.MM.YYYY
outputFormatstringOptional

Format of the output date

Example: DD.MM.YYYY
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/calendarweek HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 129

{
  "date": "20.01.2022",
  "weekNumber": 5,
  "year": 2023,
  "unixTimestamp": 1642918727,
  "dateFormat": "DD.MM.YYYY",
  "outputFormat": "DD.MM.YYYY"
}
{
  "workingDate": "text",
  "weekNumber": 1,
  "firstDayOfWeek": "text",
  "lastDayOfWeek": "text"
}

Check weekend date.

post

Determine if a given date is a weekend, retrieve the day number, and get the weekday.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
datestringRequired

The date for which information is requested.

dateFormatstringOptional

The format of the input date.

timeZonestringOptional

The timezone

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/isweekend HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "date": "text",
  "dateFormat": "text",
  "timeZone": "text"
}
{
  "dayNumber": 1,
  "weekDay": "text",
  "isWeekend": true
}

Convert between timezones.

post

Converts a date and time from one timezone to another.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
inputTimeany ofRequired

The time that will be converted.

Example: 08-12-2024 12:00
stringOptional
or
numberOptional
inputTimeZonestringRequired

The timezone of the input time.

Example: Europe/Berlin
formatPatternstringOptional

The format of the output time.

destinationTimeZonestringRequired

The timezone of the output time.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/switchtimezone HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "inputTime": "08-12-2024 12:00",
  "inputTimeZone": "Europe/Berlin",
  "formatPattern": "text",
  "destinationTimeZone": "text"
}
{
  "convertedTime": "text",
  "timeZone": "text"
}

Retrieve holidays.

post

This API retrieve a list of holidays for a specific year, country code, and optionally state.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
yearnumberRequired

The year for which holidays are requested.

Example: 2022
countryCodestringRequired

The ISO 3166-1 alpha-2 country code.

Example: AT
statestringOptional

The state within the country (if applicable).

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/holidays HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "year": 2022,
  "countryCode": "AT",
  "state": "text"
}
{
  "holidays": [
    {
      "date": "text",
      "start": "2025-05-14T09:23:46.637Z",
      "end": "2025-05-14T09:23:46.637Z",
      "name": "text",
      "type": "text",
      "rule": "text"
    }
  ]
}

Retrieve date range details.

post

This API calculates month, year, start date, end date, and weekdays within a specified duration from a given start date.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
startDatestringRequired

Starting date.

Example: 2023-06-07
durationnumberRequired

Duration of days for which the detail period is retrieved.

Example: 41
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/detailperiod HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "startDate": "2023-06-07",
  "duration": 41
}
{
  "monthArray": [
    {
      "month": 1,
      "year": 1,
      "startDate": "text",
      "endDate": "text",
      "weekDaysWithinPeriod": 1
    }
  ]
}

Monthly date details

post

This retrieves all workdays, saturdays, sundays, and days in the month based on the month, year, and date provided.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
datestringOptional

Date parameter

dateFormatstringOptional

Format of the input date

monthnumber · min: 1 · max: 12Optional

Number of the month.

yearnumberOptional

Year

outputFormatstringOptional

Format of the output date

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /dateandtime/month HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "date": "text",
  "dateFormat": "text",
  "month": 1,
  "year": 1,
  "outputFormat": "text",
  "options": {
    "timeStamp": true
  }
}
{
  "daysInMonth": 1,
  "lastDayOfMonth": "text",
  "firstDayOfMonth": "text",
  "workdays": [
    "text"
  ],
  "saturdays": [
    "text"
  ],
  "sundays": [
    "text"
  ],
  "lastWorkdayOfMonth": "text",
  "workdaysReversed": [
    "text"
  ]
}

Check auth status.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /1saas/auth HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "message": "You are authorized."
}

Generate a city.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/city HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "city": "Fort Marjorie",
  "country": "Timor-Leste"
}

Generate a number.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
rangenumber[] · min: 2 · max: 2Required

The range of the generated number.

typestring · enumOptional

The type of generated number. Default is integer.

Possible values:
roundnumberOptional

The number of decimal places the generated number has. This is only used if type is decimal or float.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/number HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "range": [
    1
  ],
  "type": "decimal",
  "round": 1
}
{
  "randomNumber": 1
}

Generate random string.

post

Generate random string based on type and length.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
typestring · enumOptional

Type of randomness. Specifies the character set to use when generating the random string.

Possible values:
lengthnumberRequired

Type of randomness. Specifies the character set to use when generating the random string. The available types are:

  • 1: Numbers only (0-9).
  • 2: Alphabetical characters (both upper and lower case, A-Z, a-z).
  • 3: Lowercase alphabetical characters only (a-z).
  • 4: Uppercase alphabetical characters only (A-Z).
  • 5: Alphanumeric characters with lowercase letters (a-z, 0-9).
  • 6: Alphanumeric characters with uppercase letters (A-Z, 0-9).
  • 7: Complex characters including special symbols (e.g., !, @, #, etc.).
  • 8: Custom character set, which requires a custom array of characters to be provided.
customstring[]Optional

An array of custom characters to use for generating the random string. Required if type is set to 8.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/string HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "type": 1,
  "length": 1,
  "custom": [
    "text"
  ]
}
{
  "randomString": "text"
}

Generate a name.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
genderstring · enumOptionalPossible values:
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/name HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "gender": "male"
}
{
  "firstName": "text",
  "middleName": "text",
  "lastName": "text",
  "completeName": "text",
  "completeNameWithMiddleName": "text"
}

Generate a color.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
hueany ofOptional

The hue of the generated color. Default is random.

string · enumOptionalPossible values:
or
stringOptionalPattern: #[0-9a-fA-F]{6}
luminositystring · enumOptional

The luminosity of the generated color. Default is random.

Possible values:
seedany ofOptional

A number or string that is used as a seed for the random number generator. By default, no seed is used.

numberOptional
or
stringOptional
formatstring · enumOptional

The format of the returned color. These are the possible formats:

  • rgb: rgb(0, 0, 0)
  • rgba: rgba(0, 0, 0, 0)
  • hsl: hsl(0, 0%, 0%)
  • hsla: hsla(0, 0%, 0%, 0)
  • hex: #000000

Default is hex.

Possible values:
alphanumber · max: 1Optional

A decimal between 0 and 1 that specifies the value of the alpha channel. This is only relevant when using a format with an alpha channel. Default is a random value.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/color HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "hue": "red",
  "luminosity": "bright",
  "seed": 1,
  "format": "rgb",
  "alpha": 1
}
{
  "color": "text"
}

Generate user mockdata.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
amountnumber · max: 100Optional

The amount of users to generate. Default is 1.

emailRequiredbooleanOptional
avatarRequiredbooleanOptional
passwordRequiredbooleanOptional
birthDateRequiredbooleanOptional
usernameRequiredbooleanOptional
addressRequiredbooleanOptional
cityRequiredbooleanOptional
countryRequiredbooleanOptional
phoneRequiredbooleanOptional
createdAtRequiredbooleanOptional
balanceRequiredbooleanOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/mockdata/user HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 263

{
  "amount": 1,
  "emailRequired": true,
  "avatarRequired": true,
  "passwordRequired": true,
  "birthDateRequired": true,
  "usernameRequired": true,
  "addressRequired": true,
  "cityRequired": true,
  "countryRequired": true,
  "phoneRequired": true,
  "createdAtRequired": true,
  "balanceRequired": true
}
{
  "users": [
    {
      "id": "text",
      "name": "text",
      "lastName": "text",
      "email": "text",
      "avatar": "text",
      "password": "text",
      "birthDate": "text",
      "username": "text",
      "address": "text",
      "city": "text",
      "country": "text",
      "phone": "text",
      "createdAt": "text",
      "balance": 1
    }
  ]
}

Scrape website.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringRequired
textOnlybooleanOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/html-scrape HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "textOnly": true
}
{
  "data": "text"
}

Encode JWT.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
dataanyRequired
secretstringRequired
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/jsonwebtoken/encode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "data": null,
  "secret": "text",
  "options": {
    "algorithm": "HS256"
  }
}
{
  "token": "text"
}

Decode JWT.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
tokenstringRequired
verifybooleanOptional

Whether to verify the JWT. This requires secret. Default is false.

secretstringOptional

The HMAC secret or PEM-encoded public key.

Responses
200
Success
application/json
Responseany

The JWT payload.

400
Bad Request
application/json
post
POST /generate/jsonwebtoken/decode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "token": "text",
  "verify": true,
  "secret": "text",
  "options": {
    "algorithms": [
      "HS256"
    ]
  }
}

No content

Generate a QR code.

post

Returns a QR code as a PNG image, styled using the provided settings.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
datastringRequired

The data that should be encoded

Example: https://wemakefuture.com
widthnumberOptional

The width of the QR code in pixels. Default is 500.

Example: 500
heightnumberOptional

The height of the QR code in pixels. Default is 500.

Example: 500
imagestringOptional

The URL of the image that should be put in the middle. By default, no image is used. The image covers up part of the QR code, which can only be recovered using error correction.

Example: https://pbs.twimg.com/profile_images/1325818753842618384/I9aD7jAt_400x400.jpg
marginnumberOptional

The size of the space between the QR code and the border of the image in pixels. Default is 15.

Example: 15
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/qrcode/encode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 713

{
  "data": "https://wemakefuture.com",
  "width": 500,
  "height": 500,
  "image": "https://pbs.twimg.com/profile_images/1325818753842618384/I9aD7jAt_400x400.jpg",
  "margin": 15,
  "qrOptions": {
    "typeNumber": 5,
    "mode": "Byte",
    "errorCorrectionLevel": "Q"
  },
  "imageOptions": {
    "hideBackgroundDots": true,
    "margin": 0
  },
  "dotsOptions": {
    "type": "square",
    "color": "#000000",
    "gradient": {
      "type": "linear",
      "rotation": 1,
      "colorStops": [
        {
          "offset": 0,
          "color": "#FF0000"
        }
      ]
    }
  },
  "cornersSquareOptions": {
    "type": "square",
    "color": "#000000",
    "gradient": {
      "type": "linear",
      "rotation": 1,
      "colorStops": [
        {
          "offset": 0,
          "color": "#FF0000"
        }
      ]
    }
  },
  "cornersDotOptions": {
    "type": "square",
    "color": "#000000",
    "gradient": {
      "type": "linear",
      "rotation": 1,
      "colorStops": [
        {
          "offset": 0,
          "color": "#FF0000"
        }
      ]
    }
  }
}
{
  "imageUrl": "text",
  "fileName": "text"
}

Decode a QR code.

post

Decodes a QR code from a URL or buffer and returns the encoded data. The supported file formats are jpg, png, bmp, tiff, gif.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringOptional

The URL to the QR code.

bufferstringOptional

The QR code as a Base64-encoded buffer. Can be used instead of url.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/qrcode/decode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}
{
  "data": "text"
}

Decode barcode.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
urlstringOptional
bufferstringOptional
barcodestring · enumRequired

The barcode format.

Possible values:
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /generate/barcode/decode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "url": "text",
  "buffer": "text",
  "barcode": "code-128"
}
{
  "code": "text"
}

Generate barcode.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
datastringRequired
formatstring · enumOptional

The generated file type. Default is svg.

Possible values:
getAsUrlbooleanOptional

Whether to get as URL or buffer. Default is buffer.

fileNamestringOptional
Responses
200
Success
400
Bad Request
application/json
post
POST /generate/barcode/encode HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 363

{
  "data": "text",
  "options": {
    "format": "text",
    "width": 1,
    "height": 1,
    "displayValue": true,
    "fontOptions": "text",
    "font": "text",
    "text": "text",
    "textAlign": "text",
    "textPosition": "text",
    "textMargin": 1,
    "fontSize": 1,
    "background": "text",
    "lineColor": "text",
    "margin": 1,
    "marginTop": 1,
    "marginBottom": 1,
    "marginLeft": 1,
    "marginRight": 1
  },
  "format": "svg",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text",
  "fileName": "text"
}

Evaluate text against a regex.

post

Evaluates a given text against a provided regular expression and returns the matches.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired

The text to be evaluated.

Example: The quick brown fox jumps over the lazy dog.
expressionstringRequired

The regular expression to evaluate against the text.

Example: \b\w{4}\b
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /text/regex HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 83

{
  "text": "The quick brown fox jumps over the lazy dog.",
  "expression": "\\b\\w{4}\\b"
}
{
  "matches": [
    "text"
  ],
  "isValidRegex": true
}

Keyword search in text.

post

Searches text for keywords and returns their positions.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
textstringRequired

Text from which you want to find keywords.

keywordstringOptional

Single keyword.

keywordListstring[]Optional

Multiple keywords.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /text/contains HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 113

{
  "text": "text",
  "keyword": "text",
  "keywordList": [
    "text"
  ],
  "options": {
    "caseSensitive": true,
    "onlyCompleteWords": true
  }
}
{
  "findings": [
    {
      "keyword": "text",
      "contains": true,
      "foundPositions": [
        1
      ]
    }
  ]
}

Compare two strings.

post

Calculate similarity score between two strings

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
string1stringRequired

First String.

string2stringRequired

Second String.

algorithmstringOptional

Similarity algorithm.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /text/comparestring HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "string1": "text",
  "string2": "text",
  "algorithm": "text"
}
{
  "similarity": 1,
  "distance": 1
}

Extract text from body.

post

Extracts text from body between given start and end markers

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com

Body
startstringRequired

Start marker.

endstringRequired

End marker.

bodystringRequired

Body from which to extract the text

greedybooleanOptional

When true, It include start and end marker in result.

caseSensitivebooleanOptional

When true, It make the body case sensitive.

returnEmptyIfNotFoundbooleanOptional

When true, Return error if markers not found.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /text/extractor HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "start": "text",
  "end": "text",
  "body": "text",
  "greedy": true,
  "caseSensitive": true,
  "returnEmptyIfNotFound": true
}
{
  "text": "text"
}

Execute Python code.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
codestringRequired

The Python code that will be executed.

requirementsstring[]Optional

The PyPI libraries your Python code requires. For backwards compatibility, this can be left empty, and your dependencies will be discovered automatically. Please do not use this and specify your requirements explicitly, as the automatic discovery is inaccurate and unreliable, and its only purpose is to prevent old code from breaking.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /python HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "code": "text",
  "requirements": [
    "text"
  ]
}
{
  "result": null
}

Execute async Python.

post

Execute a Python script and return immediately. The response is sent to a webhook.

Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
codestringRequired

The Python script that will be executed.

requirementsstring[]Optional

The PyPI libraries your Python code requires.

sendTostringOptional

The URL of the webhook the response will be sent to.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /async-python HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "code": "text",
  "requirements": [
    "text"
  ],
  "sendTo": "text"
}
{
  "status": "text",
  "taskId": "text"
}

Execute JavaScript code.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
codestringRequired

The JavaScript code that will be executed.

Responses
200
Success
application/json
Responseany

The data returned by the JavaScript code.

400
Bad Request
application/json
post
POST /javascript HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "code": "text"
}

No content

Get async task status.

post
Header parameters
authstringRequired

The API key that can be retrieved from 0codekit.com.

Body
taskIdstringRequired

The ID of the task that will be checked.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /taskstatus HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "taskId": "text"
}
{
  "status": "text",
  "result": "text"
}

Generate Bar Chart

post

This endpoint generates a bar chart image based on the provided data, labels, and customization options.

Header parameters
authstringRequired
Body
datanumber[]Required

Data points for the bar chart.

labelsstring[]Required

Labels corresponding to the data points.

getAsUrlbooleanOptional

If true, returns a URL instead of the chart image.

widthnumberOptional

Width of the chart image.

heightnumberOptional

Height of the chart image.

backgroundColorstringOptional

Background color of the chart image.

bordersColorsstring[]Optional

Colors for the borders of the bars.

barsColorsstring[]Optional

Colors for the bars in the chart.

borderWidthnumberOptional

Width of the borders around the bars.

titlestringOptional

Title of the chart.

optionsobjectOptional

Additional configuration options for Chart.js.

fileNamestringOptional

Optional filename for the generated chart image.

Responses
200
Success
400
Bad Request
application/json
post
POST /chart/bars HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "data": [
    1
  ],
  "labels": [
    "text"
  ],
  "getAsUrl": true,
  "width": 1,
  "height": 1,
  "backgroundColor": "text",
  "bordersColors": [
    "text"
  ],
  "barsColors": [
    "text"
  ],
  "borderWidth": 1,
  "title": "text",
  "options": {},
  "fileName": "text"
}
{
  "url": "text"
}

Generate Doughnut Chart

post

This endpoint generates a doughnut chart image based on the provided data, labels, and customization options.

Header parameters
authstringRequired
Body
datanumber[]Required

Data points for the doughnut chart.

labelsstring[]Required

Labels corresponding to the data points.

getAsUrlbooleanOptional

If true, returns a URL instead of the chart image.

widthnumberOptional

Width of the chart image.

heightnumberOptional

Height of the chart image.

backgroundColorstringOptional

Background color of the chart image.

bordersColorsstring[]Optional

Colors for the borders of the doughnut.

barsColorsstring[]Optional

Colors for the doughnut in the chart.

borderWidthnumberOptional

Width of the borders around the doughnut.

titlestringOptional

Title of the chart.

optionsobjectOptional

Additional configuration options for Chart.js.

fileNamestringOptional

Optional filename for the generated chart image.

Responses
200
Success
400
Bad Request
application/json
post
POST /chart/doughnut HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 201

{
  "data": [
    1
  ],
  "labels": [
    "text"
  ],
  "getAsUrl": true,
  "width": 1,
  "height": 1,
  "backgroundColor": "text",
  "bordersColors": [
    "text"
  ],
  "barsColors": [
    "text"
  ],
  "borderWidth": 1,
  "title": "text",
  "options": {},
  "fileName": "text"
}
{
  "url": "text"
}

Generate Line Chart

post

This endpoint generates a line chart image based on the provided data, labels, and customization options.

Header parameters
authstringRequired
Body
datanumber[]Required

Data points for the line chart.

labelsstring[]Required

Labels corresponding to the data points.

getAsUrlbooleanOptional

If true, returns a URL instead of the chart image.

widthnumberOptional

Width of the chart image.

heightnumberOptional

Height of the chart image.

backgroundColorstringOptional

Background color of the chart image.

bordersColorsstring[]Optional

Colors for the borders of the line.

barsColorsstring[]Optional

Colors for the line in the chart.

fillbooleanOptional

Fill the color under the line.

tensionnumberOptional

Tension of the line.

borderWidthnumberOptional

Width of the borders around the line.

titlestringOptional

Title of the chart.

optionsobjectOptional

Additional configuration options for Chart.js.

fileNamestringOptional

Optional filename for the generated chart image.

Responses
200
Success
400
Bad Request
application/json
post
POST /chart/line HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 225

{
  "data": [
    1
  ],
  "labels": [
    "text"
  ],
  "getAsUrl": true,
  "width": 1,
  "height": 1,
  "backgroundColor": "text",
  "bordersColors": [
    "text"
  ],
  "barsColors": [
    "text"
  ],
  "fill": true,
  "tension": 1,
  "borderWidth": 1,
  "title": "text",
  "options": {},
  "fileName": "text"
}
{
  "url": "text"
}

Blur an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

sigmanumber · min: 0.3 · max: 1000Optional

How strongly the image will be blurred.

getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/blur HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "url": "text",
  "buffer": "text",
  "sigma": 1,
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Convert an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

outputFormatstring · enumRequired

The output format of the conversion.

Possible values:
withMetaDatabooleanOptional

Whether the image metadata should be converted, too.

getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/convert HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 834

{
  "url": "text",
  "buffer": "text",
  "outputFormat": "jpeg",
  "withMetaData": true,
  "options": {
    "quality": 80,
    "alphaQuality": 100,
    "lossless": false,
    "nearLossless": false,
    "smartSubsample": false,
    "progressive": false,
    "chromaSubsampling": "4:2:0",
    "trellisQuanitsation": false,
    "overshootDeringing": false,
    "optimiseScans": false,
    "optimizeScans": true,
    "optimiseCoding": true,
    "optimizeCoding": true,
    "quanitsationTable": 0,
    "quantizationTable": 1,
    "mozjpeg": false,
    "compressionLevel": 6,
    "adaptiveFiltering": false,
    "effort": 7,
    "palette": false,
    "colours": 256,
    "colors": 1,
    "dither": 1,
    "preset": "default",
    "compression": "jpeg",
    "predictor": "horizontal",
    "pyramid": false,
    "tile": false,
    "tileWidth": 256,
    "tileHeight": 256,
    "xres": 1,
    "yres": 1,
    "bitdepth": 8,
    "miniswhite": false,
    "resolutionUnit": "inch",
    "reuse": false,
    "interFrameMaxError": 0,
    "interPaletteMaxError": 3
  },
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Get EXIF data.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /image/exif HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}
{
  "exifData": null
}

Crop an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/crop HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 122

{
  "url": "text",
  "buffer": "text",
  "options": {
    "left": 100,
    "top": 100,
    "width": 500,
    "height": 500
  },
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Flip an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

axisstring · enumRequired

The axis the image will be flipped about.

Possible values:
getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/flip HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 75

{
  "url": "text",
  "buffer": "text",
  "axis": "X",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Convert HTML to image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

htmlstringOptional

The HTML source. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/html HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 265

{
  "url": "text",
  "html": "text",
  "options": {
    "type": "png",
    "quality": 80,
    "fullPage": true,
    "defaultBackground": true,
    "emulateDevice": "text",
    "width": 1920,
    "height": 1080,
    "scaleFactor": 1,
    "darkMode": true,
    "clip": {
      "x": 1,
      "y": 1,
      "width": 1,
      "height": 1
    }
  },
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Overlay two images.

post
Header parameters
authstringRequired
Body
frontImageUrlstringRequired

The URL of the front image.

backImageUrlstringRequired

The URL of the background image.

positionstring · enumOptional

The position of the front image on the back image. This overrides options.horizontalPosition and options.verticalPosition.

Possible values:
getAsUrlbooleanOptional

Whether to return the result as a buffer or a URL. Default is buffer.

fileNamestringOptional

A custom file name. If this is not set, a randomly generated is used instead.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/overlay HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 182

{
  "frontImageUrl": "text",
  "backImageUrl": "text",
  "position": "center",
  "getAsUrl": true,
  "options": {
    "horizontalPosition": 1,
    "verticalPosition": 1,
    "opacity": 1,
    "type": "text"
  },
  "fileName": "text"
}
{
  "url": "text",
  "fileName": "text"
}

Resize an image.

post
Header parameters
authstringRequired
Body
urlstringOptional
bufferstringOptional
widthnumberOptional
heightnumberOptional
getAsUrlbooleanOptional
fileNamestringOptional
Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /image/resize HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 172

{
  "url": "text",
  "buffer": "text",
  "width": 1,
  "height": 1,
  "options": {
    "fit": "contain",
    "position": "center",
    "background": "text",
    "kernel": "nearest"
  },
  "getAsUrl": true,
  "fileName": "text"
}
{}

Rotate an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

anglenumberRequired

The clockwise rotation.

backgroundstringOptional

The color of the space that is not occupied by the image after the rotation. Only used if angle is not a multiple of 90 degrees. Default is #000000.

Example: #000000
getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/rotate HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "url": "text",
  "buffer": "text",
  "angle": 1,
  "background": "#000000",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Sharpen an image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The image URL

bufferstringOptional

The image as a Base64-encoded buffer. Can be specified instead of url.

sigmanumber · min: 0.3 · max: 1000Optional

How strongly the image will be sharpened.

getAsUrlbooleanOptional

Whether the result image should be returned as a URL. Default is false.

fileNamestringOptional

The file name of the result image. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /image/sharpen HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 74

{
  "url": "text",
  "buffer": "text",
  "sigma": 1,
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Draw image on PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
imageUrlstringOptional

The URL of the image to draw.

imageBufferstringOptional

T?he image as a Base64-encoded buffer. Can be specified instead of imageUrl.

anchorstring · enumOptional

The part of the page on which the image should be drawn. Default is center.

Example: centerPossible values:
alignstring · enumOptional

The part of the image that should be aligned with the specified position. Default is the value of anchor.

Example: centerPossible values:
xnumberOptional

The horizontal offset in points relative to the anchor. Default is 0.

Example: 0
ynumberOptional

The vertical offset in points relative to the anchor. Default is 0.

Example: 0
widthnumberOptional

The width of the image in points. This or height has to be provided. If only width is provided, height is calculated automatically.

Example: 200
heightnumberOptional

The height of the image in points. This or width has to be provided. If only height is provided, width is calculated automatically.

Example: 100
rotatenumberOptional

The counter-clockwise rotation of the image in degrees. Default is 0.

Example: 45
pagesstringOptional

The pages the image should be drawn onto. Given as a range of pages, where 1 means the first page and ^1 means the last page.

fileNamestringOptional

The file name the result PDF will have. Default is a random ID.

Responses
200
Success
application/json
Responseobject
400
Bad Request
application/json
post
POST /pdf/draw/image HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 202

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "imageUrl": "text",
  "imageBuffer": "text",
  "anchor": "center",
  "align": "center",
  "x": 0,
  "y": 0,
  "width": 200,
  "height": 100,
  "rotate": 45,
  "pages": "text",
  "fileName": "text"
}
{}

Draw text on PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
textstringRequired

The text to draw.

Example: Hello, world!
fontstring · enumOptional

The font to use. Default is Helvetica.

Example: HelveticaPossible values:
anchorstring · enumOptional

The part of the page on which the text should be drawn. Default is center.

Example: centerPossible values:
alignstring · enumOptional

The part of the text that should be aligned with the specified position. Default is the value of anchor.

Example: centerPossible values:
xnumberOptional

The horizontal offset in points relative to the anchor. Default is 0.

Example: 0
ynumberOptional

The vertical offset in points relative to the anchor. Default is 0.

Example: 0
rotatenumberOptional

The counter-clockwise rotation of the text in degrees. Default is 0.

Example: 45
sizenumberOptional

The font size in points. Default is 32.

Example: 32
colorstringOptional

The font color as a six-digit hexcode, i.e. RRGGBB. Default is 000000, i.e. black.

Example: FFFF00
pagesstringOptional

The pages the text should be drawn onto. Given as a range of pages, where 1 means the first page and ^1 means the last page.

Example: 1,3-5,^3-^1
fileNamestringOptional

The file name the result PDF will have. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/draw/text HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 214

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "text": "Hello, world!",
  "font": "Helvetica",
  "anchor": "center",
  "align": "center",
  "x": 0,
  "y": 0,
  "rotate": 45,
  "size": 32,
  "color": "FFFF00",
  "pages": "1,3-5,^3-^1",
  "fileName": "text"
}
{
  "url": "text"
}

Edit PDF metadata.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
titlestringOptional

The new title of the PDF.

authorstringOptional

The new author of the PDF.

subjectstringOptional

The new subject of the PDF.

keywordsstring[]Optional

The new keywords of the PDF.

fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/metadata/edit HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 132

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "title": "text",
  "author": "text",
  "subject": "text",
  "keywords": [
    "text"
  ],
  "fileName": "text"
}
{
  "url": "text"
}

Get PDF metadata.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/metadata/info HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}
{
  "title": "text",
  "author": "text",
  "subject": "text",
  "keywords": [
    "text"
  ],
  "creator": "text",
  "creationDate": "2025-05-14T09:23:46.637Z",
  "modificationDate": "2025-05-14T09:23:46.637Z",
  "isEncrypted": true,
  "pageCount": 1,
  "pages": [
    {
      "width": 1,
      "height": 1,
      "rotation": 1
    }
  ]
}

Add PDF pages.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
widthnumberOptional

The width of the pages to add. Default is the width of the first page.

Example: 595
heightnumberOptional

The height of the pages to add. Default is the height of the first page.

Example: 842
pagesnumber[]Required

The positions of the pages that should be added. Every number represents one page, and is the page number after which the new page should be added, e.g. 0 means inserting at the very beginning, while 10 means inserting after the 10th page.

fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/pages/add HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "width": 595,
  "height": 842,
  "pages": [
    1
  ],
  "fileName": "text"
}
{
  "url": "text"
}

Remove PDF pages.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
pagesstringRequired

The pages that should be removed from the PDF. Given as a range of pages, where 1 means the first page and ^1 means the last page.

Example: 1,3-5,^3-^1
fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/pages/remove HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 86

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "pages": "1,3-5,^3-^1",
  "fileName": "text"
}
{
  "url": "text"
}

Resize PDF pages.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
widthnumberRequired

The new width in points.

heightnumberRequired

The new height in points.

pagesstringRequired

The pages that should be resized. Given as a range of pages, where 1 means the first page and ^1 means the last page.

Example: 1,3-5,^3-^1
fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/pages/resize HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 107

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "width": 1,
  "height": 1,
  "pages": "1,3-5,^3-^1",
  "fileName": "text"
}
{
  "url": "text"
}

Rotate PDF pages.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
rotatenumberRequired

Clockwise rotation of the pages in degrees. Must be a multiple of 90.

Example: 90
pagesstringRequired

The pages that will be rotated. Given as a range of pages, where 1 means the first page and ^1 means the last page.

Example: 1,3-5,^3-^1
fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/pages/rotate HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 98

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "rotate": 90,
  "pages": "1,3-5,^3-^1",
  "fileName": "text"
}
{
  "url": "text"
}

Convert PDF to Base64.

post
Header parameters
authstringRequired
Body
pdfstringRequired

The PDF URL.

fileNamestringOptional

The file name will be returned again. If none is provided, one will be generated automatically.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/base64 HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "pdf": "text",
  "fileName": "text"
}
{
  "pdfBase64": "text",
  "fileName": "text"
}

Compress PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional
bufferstringOptional
getAsUrlbooleanOptional
fileNamestringOptional
Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/compress HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Count PDF pages.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/count HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "url": "text",
  "buffer": "text"
}
{
  "pageCount": 1
}

Decrypt PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
passwordstringRequired

The password used to decrypt the PDF. Can be either the user or the owner password.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/decrypt HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "password": "text"
}
{
  "url": "text"
}

Create empty PDF.

post
Header parameters
authstringRequired
Body
getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
pagesnumber · min: 1Optional

The number of pages the new PDF should have. Must be at least 1. Default is 1.

Example: 10
widthnumberOptional

The width of the pages in points. Default is 595.

Example: 595
heightnumberOptional

The height of the pages in points. Default is 842.

Example: 842
fileNamestringOptional

The file name the result PDF will have. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/create HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "getAsUrl": true,
  "pages": 10,
  "width": 595,
  "height": 842,
  "fileName": "text"
}
{
  "url": "text"
}

Convert DOCX to PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The DOCX URL.

bufferstringOptional

The DOCX as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
fileNamestringOptional

The file name of the result PDF. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/docx-to-pdf HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Encrypt PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
userPasswordstringRequired

The user password.

ownerPasswordstringOptional

The owner password. Default is the user password.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/encrypt HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 91

{
  "url": "text",
  "buffer": "text",
  "getAsUrl": true,
  "userPassword": "text",
  "ownerPassword": "text"
}
{
  "url": "text"
}

Get PDF metadata.

post

WARNING: This endpoint is deprecated. Please use /pdf/metadata/info instead.

Header parameters
authstringRequired
Body
pdfstringRequired

The PDF URL or Base64-encoded buffer.

filenamestringOptional

The PDF file name. Default is a random ID.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/getinfometadata HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "pdf": "text",
  "filename": "text"
}
{
  "title": "text",
  "author": "text",
  "producer": "text",
  "creator": "text",
  "creationDate": "2025-05-14T09:23:46.637Z",
  "modificationDate": "2025-05-14T09:23:46.637Z",
  "pageCount": 1,
  "filename": "text"
}

Convert HTML to PDF.

post
Header parameters
authstringRequired
Body
urlstringOptional

The URL of the website.

htmlstringOptional

The HTML source. Can be specified instead of url

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
fileNamestringOptional

The PDF file name. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/html HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 338

{
  "url": "text",
  "html": "text",
  "getAsUrl": true,
  "fileName": "text",
  "options": {
    "scale": 1,
    "displayHeaderFooter": false,
    "printBackground": false,
    "landscape": false,
    "pageRanges": "1-3,8,15-20",
    "format": "a4",
    "width": "text",
    "height": "text",
    "preferCSSPageSize": false,
    "margin": {
      "top": 1,
      "bottom": 1,
      "left": 1,
      "right": 1
    },
    "omitBackground": false,
    "tagged": true
  }
}
{
  "url": "text"
}

Convert Markdown to PDF.

post
Header parameters
authstringRequired
Body
markdownStringstringRequired

The Markdown source that will be converted to a PDF.

cssstringOptional

Custom CSS to change the Markdown look.

getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
fileNamestringOptional

The PDF file name. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/markdownstringtopdf HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "markdownString": "text",
  "css": "text",
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Merge PDF files.

post
Header parameters
authstringRequired
Body
getAsUrlbooleanOptional

Whether the result PDF should be returned as a URL. Default is false.

Example: true
fileNamestringOptional

The file name the result PDF will have. Default is a random ID.

Responses
200
Success
400
Bad Request
application/json
post
POST /pdf/merge HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 104

{
  "files": [
    {
      "url": "text",
      "buffer": "text",
      "pages": "1-3,5,^15-^13,^6-"
    }
  ],
  "getAsUrl": true,
  "fileName": "text"
}
{
  "url": "text"
}

Convert PDF to image.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

fileNamestringOptional

The file name prefix of the result images. Default is a random ID.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/pdf-to-image HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "url": "text",
  "buffer": "text",
  "fileName": "text"
}
{
  "ANY_ADDITIONAL_PROPERTY": "text"
}

Split PDF file.

post
Header parameters
authstringRequired
Body
urlstringOptional

The PDF URL.

bufferstringOptional

The PDF as a Base64-encoded buffer. Can be specified instead of url.

pagesstring[]Optional

The page ranges that should be contained in the new PDF files. Every subdocument is given as a comma-separated range of pages, where 1 means the first page and ^1 means the last page.

intervalnumberOptional

The number of pages that should be contained in every split PDF file. Can be specified instead of pages.

fileNamestringOptional

The file name prefix the result PDFs will have. Default is a random ID.

Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /pdf/split HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 78

{
  "url": "text",
  "buffer": "text",
  "pages": [
    "text"
  ],
  "interval": 1,
  "fileName": "text"
}
{
  "pdfUrls": [
    "text"
  ]
}

Create shortened URL.

post
Header parameters
authstringRequired
Body
sendToWebhookstringRequired
datastringRequired
intervalTypestring · enumRequired

The type of scheduler that will be set up. The different options are:

  • 1: One time execution. intervalOptions must be a unix timestamp or ISO 8601 date.
  • 2: Multiple specific executions. intervalOptions must be an array of unix timestamps or ISO 8601 dates.
  • 3: Cron job. intervalOptions must be a cron string.
  • 4: Regular execution every n hours / days / weeks / months. intervalOptions must be a string of the format period;n.
Possible values:
intervalOptionsany ofRequired
stringOptional
or
string[]Optional
or
numberOptional
or
number[]Optional
endDatestringOptional
destinationstringRequired

The destination URL which the shortened URL will point to.

Example: https://0codekit.com
customstringOptional

The shortened URL identifier. This is the part that comes after lyl.ai, and which is used for managing the shortened URL. It must be globally unique. Default is a random 8 letter string.

Example: to4w5vyb
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /add HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "sendToWebhook": "text",
  "data": "text",
  "intervalType": 1,
  "intervalOptions": "text",
  "endDate": "text",
  "destination": "https://0codekit.com",
  "custom": "to4w5vyb"
}
{
  "taskId": "text",
  "nextExecution": "text",
  "endDate": "text",
  "shortenedUrl": "https://lyl.ai/custom",
  "identifier": "to4w5vyb"
}

Delete shortened URL.

post
Header parameters
authstringRequired
Body
taskIdstringRequired
identifierstringRequired

The shortened URL identifier that was returned by /add.

Example: to4w5vyb
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /del HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 41

{
  "taskId": "text",
  "identifier": "to4w5vyb"
}
{
  "message": "Successfully deleted shortened URL with id to4w5vyb."
}

List shortened URLs.

post
Header parameters
authstringRequired
Body
objectOptional
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /list HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 2

{}
{
  "tasks": [
    {
      "taskId": "text",
      "webhook": "text",
      "nextExecution": "text",
      "data": "text"
    }
  ],
  "shortenedUrls": [
    {
      "identifier": "to4w5vyb",
      "createdAt": "text",
      "destination": "https://0codekit.com"
    }
  ]
}

Get shortened URL.

post
Header parameters
authstringRequired
Body
identifierstringRequired

The shortened URL identifier that was returned by /add.

Example: to4w5vyb
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /get HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "identifier": "to4w5vyb"
}
{
  "destination": "https://0codekit.com"
}

Update shortened URL.

post
Header parameters
authstringRequired
Body
identifierstringRequired

The shortened URL identifier that was returned by /add.

Example: to4w5vyb
destinationstringRequired

The new destination URL which the shortened URL will point to.

Example: https://example.com
Responses
200
Success
application/json
400
Bad Request
application/json
post
POST /put HTTP/1.1
Host: 
auth: text
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "identifier": "to4w5vyb",
  "destination": "https://example.com"
}
{
  "newDestination": "https://example.com",
  "identifier": "to4w5vyb"
}