How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

sensible-so Document API

Classify documents by type

sensible-so Document API is one of 7 APIs that Sensible publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Document. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 6 operations across 6 paths, and defines 35 schemas. It is described by OpenAPI 3.2.0, at version v0.

Requests are made against a single base URL, https://api.sensible.so/v0.

6 operations 6 paths 35 schemas 6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v0
Server
https://api.sensible.so/v0
Authentication
HTTP Bearer
Contact
Resource Areas
1

Authentication & Security 1

sensible-so Document API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer token using a Sensible API key. Create keys at https://app.sensible.so/account/.

Paths & Operations 6

Across 6 paths, the API surfaces 6 operations — 6 POST. Each is listed below with its method, path, parameters, and response codes.

Document 6

Classify documents by type

POST
/classify
Classify document by type (sync)
classify-document-sync 1 param body → 200400401415429500
POST
/classify/async
Classify document by type
classify-document 1 param body → 200400401415429500
POST
/extract/{document_type}/{config_name}
Extract data from a document using specified config
extract-data-from-a-document-with-config 4 params body → 200400401415429500
POST
/extract/{document_type}
Extract data from a document (sync)
extract-data-from-a-document 3 params body → 200400401415429500
POST
/generate_upload_url/{document_type}/{config_name}
Extract doc at a Sensible URL using specified config
generate-an-upload-url-with-config 4 params body → 200400401415429500
POST
/extract_from_url/{document_type}/{config_name}
Extract doc at your URL using config
provide-a-download-url-with-config 4 params body → 200400401415429500

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are ExtractionSyncResponse (21 properties), ExtractFromUrlResponse (9 properties), UploadResponse (5 properties), ValidationsSummary (5 properties). Each schema is shown below with its type and property counts.

FileMetadata
object
Metadata about the PDF file, for example author, authoring tool, and modified date.
3 properties
Errors
array
Extraction error messages.
ClassifyAsyncSingleResponse
object
3 properties
ExtractionSyncResponse
object
21 properties
ValidationsSummary
object
Summary of the extracted fields that fail validation rules you write in the Sensible app.
5 properties
ContentTypeResponse
string
The content type of the document.
DocumentUrl
string
URL that responds to a GET request with the bytes of the document you want to extract data from. This URL must be either publicly accessible, or presigned with…
ClassificationSummary
array
Metadata about how Sensible scores configs against the document to extract from. By default, Sensible compares all configs in the document type, then chooses t…
ExtractionCreated
string
Date and time Sensible created the initial empty extraction and set its status to WAITING.
Validations
array
Which extracted fields failed validation rules you write in the Sensible app
ConfigurationVersion
string
Version number for the configuration.
ExtractionId
string
Unique ID for the extraction, used to retrieve the extraction
Score
object
The score for the extraction, used to help choose the best extraction.
3 properties
ExtractFromUrlResponse
object
9 properties
ExtractionError
object
Extraction error message
3 properties
ExtractFromUrlRequest
object
4 properties 1 required
DocName
string
If you specify the filename of the document using the documentname parameter, then Sensible displays the name in extraction history in the Sensible app and ret…
Validation
object
3 properties
GenerateUrlRequest
object
3 properties
ExtraDataRecord
object
Extra data in the form of flat key/value pairs you attach to an asynchronous extraction endpoint request, for example, {"applicantid": "A-123", "expectedpremiu…
PostprocessorOutput
object
A custom schema that you define using a [postprocessor](https://docs.sensible.so/docs/postprocessor). For example, define this output when your app consumes a…
ExtractionStatus
string
Status of the extraction: - WAITING: Sensible created an initial empty extraction and is waiting for the document. - PROCESSING: Sensible received the document…
ClassifySingleResponse
object
3 properties
ReviewStatus
string
The extraction's review status. For more information, see [Human review](https://docs.sensible.so/docs/human-review). Specify a webhook in the extraction reque…
Classification
object
4 properties
ConfigurationName
string
Name of the "configuration", a collection of SenseML queries for extracting document data.
Coverage
number
The coverage score measures how fully an extraction captured all your target data in the document. It's a percentage comparing non-null, [validated](https://do…
DocumentTypeName
string
Unique user-friendly name for a document type
EnvironmentResponse
string
Name of the environment to which the configuration used by this extraction was published.
Charged
integer
The number of extractions charged to your account for this extraction ID.
ContentTypeParameter
string
Content type of the document being presented for extraction. Required for the CSV file type.
ParsedDocument
object
Data extracted from the document, structured as an array of fields. Configure the verbosity parameter in the SenseML configuration to return extraction metadat…
ExtractionCompleted
string
Date and time Sensible set the extraction's status to COMPLETED
Webhook
object
Pushes extraction results to the specified webhook under the following circumstances, so you don't have to poll for results status: - When Sensible sets "statu…
2 properties
UploadResponse
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

sensible-so-document-api-openapi.yml Raw ↑

Other APIs Sensible publishes across the network.

sensible-so Configuration API
sensible-so Document type API
sensible-so Get Excel from documents API
sensible-so Portfolio API
sensible-so Reference document API
sensible-so Retrieve extractions API
Where this information came from

This is an independent, third-party profile of sensible-so Document API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.