API Overview

Use the experimental Themys API to extract and analyze legal documents.

Experimental API: The Themys Developer API is experimental. Endpoints, request and response formats, and availability may change without notice.

Base URL

https://themys.ca/api

Authentication

Create an API key in the Developer Portal, then send it with each programmatic request:

http

Authorization: Bearer YOUR_API_KEY

Keep API keys private. Create a new key and revoke the old one if you believe a key has been exposed.

Available endpoints

Endpoint	Purpose
`POST /api/extract`	Retrieve readable text from a public legal-document URL
`POST /api/analyze`	Analyze a public URL or supplied document text
`POST /api/analyze/batch`	Analyze up to five items in one request

See the endpoint pages for request and response examples.

Responses and limits

Successful responses use JSON. Invalid requests, missing authentication, or unavailable processing return an error response with a status code and an error message.

API availability and plan allowances depend on your account. Review your current allowance in the Developer Portal or your Themys settings.

Example

bash

curl -X POST https://themys.ca/api/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/terms"}'

Themys analysis is informational only and is not legal advice. Review the original document before making a decision.