ACTUM API Documentation

Complete digital notarization platform API for developers

99.9%

Uptime SLA

REST

API Standard

JSON

Data Format

HTTPS

Secure Only

API Overview

The ACTUM API provides comprehensive access to our digital notarization platform, enabling developers to integrate notary services into their applications.

Base URL

https://api.actumplatform.com/v1

Key Features

Smart notary matching
Real-time booking system
Identity verification
Digital signatures

Document management
Video conferencing
Compliance tracking
Webhook notifications

Authentication

The ACTUM API uses API key authentication. Include your API key in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.actumplatform.com/v1/notaries
                        

Get Your API Key

Sign up for an API key to start integrating with ACTUM. Choose from our flexible pricing plans based on your usage needs.

Get API Key

API Pricing

Choose Your API Plan

Plan	Monthly Fee	Included Calls	Overage Rate	Features
Basic	€99/month	1,000 calls	€0.10/call	Basic matching, Standard support
Professional	€299/month	5,000 calls	€0.08/call	Advanced matching, Webhooks, Priority support
Enterprise	€999/month	25,000 calls	€0.05/call	White-label API, Custom endpoints, SLA

API Endpoints

POST Match Notary

Find and match notaries based on specific criteria

Endpoint

POST /v1/notaries/match

Request Body

{
  "jurisdiction": "Germany",
  "document_type": "real_estate_deed",
  "language": "German",
  "service_type": "remote",
  "urgency": "standard",
  "client_location": {
    "city": "Berlin",
    "postal_code": "10115"
  }
}
                        

Response

{
  "success": true,
  "matches": [
    {
      "notary_id": "not_12345",
      "name": "Dr. Maria Schmidt",
      "specializations": ["real_estate", "corporate"],
      "rating": 4.9,
      "languages": ["German", "English"],
      "availability": "next_24_hours",
      "booking_url": "https://actum.com/book/not_12345",
      "hourly_rate": 120.00,
      "certifications": ["RON_certified", "eIDAS_qualified"]
    }
  ],
  "total_matches": 3,
  "match_criteria": {
    "jurisdiction_match": true,
    "document_type_match": true,
    "language_match": true,
    "service_type_match": true
  }
}

POST Create Booking

Book a notarization session with a matched notary

Endpoint

POST /v1/bookings

Request Body

{
  "notary_id": "not_12345",
  "client_name": "Hans Mueller",
  "client_email": "hans@example.com",
  "document_types": ["power_of_attorney"],
  "preferred_datetime": "2025-07-26T14:00:00Z",
  "service_type": "remote",
  "special_requirements": "German language required"
}
                        

Response

{
  "success": true,
  "booking_id": "book_67890",
  "session_id": "sess_abcdef",
  "status": "confirmed",
  "scheduled_datetime": "2025-07-26T14:00:00Z",
  "meeting_url": "https://meet.actum.com/sess_abcdef",
  "preparation_checklist": [
    "Valid government ID",
    "Document to be notarized",
    "Stable internet connection"
  ],
  "estimated_cost": {
    "session_fee": 85.00,
    "platform_fee": 15.00,
    "total": 100.00,
    "currency": "EUR"
  }
}

POST Verify Identity

Initiate identity verification process

Endpoint

POST /v1/verification/identity

Request Body

{
  "session_id": "sess_abcdef",
  "verification_type": "enhanced_id",
  "client_info": {
    "name": "Hans Mueller",
    "email": "hans@example.com",
    "phone": "+49-30-12345678"
  },
  "redirect_url": "https://yourapp.com/verification-complete"
}
                        

Response

{
  "success": true,
  "verification_id": "ver_xyz789",
  "verification_url": "https://verify.actum.com/ver_xyz789",
  "status": "pending",
  "cost": 8.50,
  "estimated_completion": "5-10 minutes"
}

POST Create Signature Session

Create a digital signature session for documents

Endpoint

POST /v1/signatures/session

Request Body

{
  "booking_id": "book_67890",
  "document_url": "https://yourapp.com/documents/contract.pdf",
  "signers": [
    {
      "name": "Hans Mueller",
      "email": "hans@example.com",
      "role": "client"
    },
    {
      "name": "Dr. Maria Schmidt",
      "email": "maria@notary.com",
      "role": "notary"
    }
  ],
  "signature_type": "qualified_electronic"
}
                        

Webhooks

ACTUM sends webhook events to notify your application about important events.

Webhook Events

booking.created - New booking created
booking.confirmed - Booking confirmed by notary
session.started - Notarization session started
session.completed - Session completed
verification.completed - ID verification completed
signature.completed - Document signed

Webhook Configuration

POST /v1/webhooks
{
  "url": "https://yourapp.com/webhooks/actum",
  "events": ["booking.confirmed", "session.completed"],
  "secret": "your_webhook_secret"
}
                        

SDKs & Libraries

JavaScript SDK

Official Node.js and browser SDK

npm install @actum/notary-sdk

View Examples

Python SDK

Official Python library

pip install actum-notary

View Examples

PHP SDK

Official PHP library

composer require actum/notary-sdk

View Examples

Java SDK

Official Java library

implementation 'com.actum:notary-sdk:1.0.0'

View Examples

Code Examples

Quick Start Example (JavaScript)

const ActumNotary = require('@actum/notary-sdk');

const client = new ActumNotary({
  apiKey: 'your_api_key',
  environment: 'production' // or 'sandbox'
});

// Find notaries
const matches = await client.notaries.match({
  jurisdiction: 'Germany',
  document_type: 'power_of_attorney',
  language: 'German',
  service_type: 'remote'
});

// Create booking
const booking = await client.bookings.create({
  notary_id: matches.data[0].notary_id,
  client_name: 'Hans Mueller',
  client_email: 'hans@example.com',
  document_types: ['power_of_attorney'],
  preferred_datetime: '2025-07-26T14:00:00Z'
});

console.log('Booking created:', booking.booking_id);
                        

Python Example

import actum_notary

client = actum_notary.Client(api_key='your_api_key')

# Find notaries
matches = client.notaries.match(
    jurisdiction='Germany',
    document_type='power_of_attorney',
    language='German',
    service_type='remote'
)

# Create booking
booking = client.bookings.create(
    notary_id=matches['data'][0]['notary_id'],
    client_name='Hans Mueller',
    client_email='hans@example.com',
    document_types=['power_of_attorney'],
    preferred_datetime='2025-07-26T14:00:00Z'
)

print(f"Booking created: {booking['booking_id']}")
                        

Get Your API Key

Start Building Today

Get instant access to the ACTUM API with your chosen subscription plan. Start integrating professional notary services into your application.

Immediate API key generation after payment
Production-ready API access
Complete documentation and examples
Priority technical support

Need Help?

Documentation

Comprehensive guides and references

View Docs

Community

Connect with other developers

Join Community

Support

Get help from our team

Contact Support