Developer quickstart


In this quickstart, use an example SenseML configuration and example PDF to get a quick "hello world" API response.

  • To get started with extracting from your custom documents, see Overview.

Extract example document data

To run an API call and return extracted, structured data from a downloaded example document:

  1. Get an account at

    NOTE In the Sensible app, don't rename the default doc type (senseml_basics) or delete the 1_extract_your_first_data config, or this example fails.

  2. Copy your API key from your account page.

  3. Copy the following code example into a plain-text application and replace <YOUR_API_TOKEN> with your API key:

curl -L \
  --output 1_extract_your_first_data.pdf && \
curl --request POST \
  --url "" \
  --header "Authorization: Bearer <YOUR_API_TOKEN>" \
  --header "Content-Type: application/pdf" \
  --data-binary "@1_extract_your_first_data.pdf"
curl -L ^
  --output 1_extract_your_first_data.pdf && ^
curl --request POST ^
  --url "" ^
  --header "Authorization: Bearer <YOUR_API_TOKEN>" ^
  --header "Content-Type: application/pdf" ^
  --data-binary "@1_extract_your_first_data.pdf"
  1. Run the code sample in a command prompt. The code downloads an example PDF (1_extract_your_first_data.pdf ) and runs it against an example document type (senseml_basics). The following excerpt of the API response shows the extracted document text in the parsed_document object:
         "value":"Welcome to your first document"

(Optional) See how it works in the Sensible app

To see this example in the Sensible app:

  1. Log into the Sensible app.

  2. Navigate to the first tutorial config.

  3. Visually examine the example PDF (middle pane), config (left pane), and extracted data (right pane) to better understand the API call you just ran: