Receive your apostille the same day or get your money back.
    Book now

    Notary & apostille API and booking widget

    Let your clients book online notary meetings from your own website or platform. Billing is arranged with your NotaryDirect contact.

    1. Booking widget (no developer needed)

    Paste one line where you want a "Book a notary meeting" button. Clients book a time, choose services and upload documents. Bookings are linked to your partner account.

    <script src="https://notarydirect.se/widget.js" data-partner="YOUR-SLUG" async></script>

    Options: data-mode="inline" to show the form directly on the page, data-label, data-color, data-lang="ua". The widget must be switched on for your account.

    Your own brand

    <script src="https://notarydirect.se/widget.js" data-partner="YOUR-SLUG" data-white-label="true" data-mode="inline" async></script>

    For the partner-branded form, NotaryDirect must enable white-label, configure your brand name, logo and color, and allow your website's exact HTTPS origin. Your contact email, terms URL and privacy policy URL are required. Clients book on your website with no NotaryDirect payment step. No wholesale prices are shown. Billing is arranged with your NotaryDirect contact.

    Embedded white-label bookings send booking details to your configured partner contact, not directly to the client. You send your own branded confirmation and follow-up. The video meeting is hosted by a separate meeting provider. API white-label bookings retain their existing neutral meeting-email behavior.

    2. REST API

    Base URL: https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1. Authenticate with your secret key, which you get from NotaryDirect. Never put it in browser code.

    Authorization: Bearer nd_live_...
    GET/servicesService ids and names
    GET/availabilityOpen meeting times (UTC, ISO 8601)
    POST/uploadsGet a one-time upload URL for a document
    POST/bookingsCreate a booking
    GET/bookingsYour 50 most recent bookings
    GET/bookings/{id}Booking details and meeting link
    POST/bookings/{id}/cancelCancel (until 24 hours before the meeting)

    Create a booking

    # 1. (optional) upload a document
    curl -X POST https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/uploads -H "Authorization: Bearer $KEY" \
      -H "Content-Type: application/json" -d '{"file_name":"passport.pdf"}'
    # -> { "file_path": "...", "upload_url": "...", "method": "PUT" }
    curl -X PUT "$UPLOAD_URL" -H "Content-Type: application/pdf" --data-binary @passport.pdf
    
    # 2. book
    curl -X POST https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/bookings -H "Authorization: Bearer $KEY" \
      -H "Content-Type: application/json" -d '{
      "meeting_datetime": "2026-11-03T09:30:00Z",
      "timezone": "Europe/London",
      "client": { "name": "Jane Doe", "email": "jane@example.com", "phone": "+447700900123" },
      "documents": [
        { "service": "certified_copy", "apostille": true, "file_path": "api/.../passport.pdf" }
      ],
      "destination_country": "Spain",
      "shipping": { "ship_to_partner": false },
      "external_reference": "your-order-123"
    }'

    Services: certified_copy, certified_signature, certification_of_facts, not_sure. For a hard copy, add shipping.address or set ship_to_partner: true (if enabled for you). Meetings are online video meetings only.

    Response

    {
      "id": "6f1c...", "booking_number": "ND-2026-0231",
      "meeting_datetime": "2026-11-03T09:30:00Z",
      "meeting_url": "https://...whereby.com/...",
      "client_name": "Jane Doe", "destination_country": "Spain",
      "channel": "api", "external_reference": "your-order-123",
      "created_at": "2026-10-18T12:00:00Z"
    }

    The API does not return prices, payment state, case status or tracking numbers. Questions about a booking are handled with your NotaryDirect contact.

    3. Booking notifications (webhooks)

    Give us an HTTPS URL and we send one signed POST per new booking, right after it is created. Verify that each message came from us using your signing secret:

    The widget sends bookings into NotaryDirect; the webhook tells your system that a booking was received. There are no status updates — handling of the case is coordinated with your NotaryDirect contact.

    X-NotaryDirect-Timestamp: 1767225600
    X-NotaryDirect-Signature: sha256=HMAC_SHA256(secret, timestamp + "." + raw_body)
    X-NotaryDirect-Event-Id: <event id>
    
    { "event": "booking.received", "data": { "id": "...", "booking_number": "ND-2026-0231",
      "meeting_datetime": "2026-11-03T09:30:00Z", "external_reference": "your-order-123" } }

    Errors and limits

    Errors return JSON {"error": ...} with status 400 (invalid input), 401 (bad key), 404, 409 (time no longer available). Limit: 600 requests per hour.

    NotaryDirect coordinates bookings. The notarial act itself is performed by an independent licensed Notary Public.

    Want a key? Book an intro call or email info@notarydirect.se.

    Integration guide

    1. Widget on your website

    1. Complete Brand, Contact and Legal in the activation checklist. Upload your logo.
    2. In Allowed websites, enter each exact HTTPS website origin, such as https://example.com. It permits the booking form on that website only; a subdomain needs its own entry.
    3. Copy a script below into your website's HTML where the booking button or form should appear. Choose button for a pop-up, or inline for a form on the page.
    4. Open the Embed preview to check your branding. This preview cannot upload documents or create bookings.
    5. Choose Go live when the required fields are complete. Test an actual booking only when you intend to create it.
    <script src="https://notarydirect.se/widget.js" data-partner="YOUR-SLUG" data-white-label="true" data-mode="button" async></script>
    <script src="https://notarydirect.se/widget.js" data-partner="YOUR-SLUG" data-white-label="true" data-mode="inline" async></script>

    2. API from your server

    Open API key in the checklist, create a key and save it securely when it is shown. Use it on your server only, never in browser code. Enable API access. Replace the sample meeting time with a free time returned by availability.

    https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1
    Authorization: Bearer YOUR_API_KEY

    List services

    curl "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/services" \
    +  -H "Authorization: Bearer $NOTARYDIRECT_KEY"

    Get availability (UTC)

    curl "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/availability" \
    +  -H "Authorization: Bearer $NOTARYDIRECT_KEY"

    Upload a document

    Request an upload URL, then PUT the file to the returned upload_url. Keep file_path for the booking.

    curl -X POST "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/uploads" -H "Authorization: Bearer $NOTARYDIRECT_KEY" \
    +  -H "Content-Type: application/json" -d '{"file_name":"document.pdf"}'
    curl -X PUT "$UPLOAD_URL" -H "Content-Type: application/pdf" --data-binary @document.pdf

    Create a booking

    curl -X POST "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/bookings" -H "Authorization: Bearer $NOTARYDIRECT_KEY" \
    +  -H "Content-Type: application/json" -d '{
      "meeting_datetime":"2026-11-10T10:00:00Z",
      "timezone":"Europe/London",
      "client":{"name":"Jane Doe","email":"jane@example.com","phone":"+447700900123"},
      "documents":[{"service":"certified_copy","apostille":true,"file_path":"FILE_PATH_FROM_UPLOAD"}],
      "destination_country":"Spain",
      "external_reference":"your-order-123"
    }'

    Read or cancel a booking

    curl "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/bookings/BOOKING_ID" \
    +  -H "Authorization: Bearer $NOTARYDIRECT_KEY"
    curl -X POST "https://fvrslnsccaefjsakyqdg.supabase.co/functions/v1/partner-api/v1/bookings/BOOKING_ID/cancel" -H "Authorization: Bearer $NOTARYDIRECT_KEY"

    Cancellation is available until 24 hours before the meeting. A successful cancellation returns booking_number and cancelled: true.

    3. Webhooks: new bookings only

    Set your HTTPS receiver URL in Webhook, create the signing secret and save it on your server. Enable webhooks. We send only booking.received with id, booking_number, meeting_datetime and external_reference. The test button sends the same event type with test data, without creating a booking.

    X-NotaryDirect-Timestamp: <Unix seconds>
    X-NotaryDirect-Signature: sha256=<hex HMAC>
    X-NotaryDirect-Event-Id: <event id>

    Verify HMAC-SHA256 over timestamp + "." + the exact raw request body before parsing JSON. Reject timestamps outside five minutes and remember event ids to avoid processing a retry twice. Return a 2xx response only after accepting the event.

    import { createHmac, timingSafeEqual } from 'node:crypto';
    // rawBody is the untouched request body Buffer; secret stays on your server.
    function verify(headers, rawBody, secret) {
      const ts = headers['x-notarydirect-timestamp'];
      const sig = headers['x-notarydirect-signature'] || '';
      if (!/^\d+$/.test(ts || '') || Math.abs(Date.now()/1000 - Number(ts)) > 300) return false;
      if (!/^sha256=[0-9a-f]{64}$/.test(sig)) return false;
      const expected = createHmac('sha256', secret).update(ts + '.').update(rawBody).digest();
      return timingSafeEqual(expected, Buffer.from(sig.slice(7), 'hex'));
    }
    import hashlib, hmac, time
    def verify(headers, raw_body, secret):
        ts = headers.get('X-NotaryDirect-Timestamp', '')
        signature = headers.get('X-NotaryDirect-Signature', '')
        if not ts.isdigit() or abs(time.time() - int(ts)) > 300:
            return False
        expected = 'sha256=' + hmac.new(secret.encode(), ts.encode() + b'.' + raw_body, hashlib.sha256).hexdigest()
        return hmac.compare_digest(expected, signature)

    Send a test event and check Recent deliveries. Failed attempts are queued with delays of 1, 5, 30, 120 and 720 minutes; delivery occurs on the next dispatcher run after the delay. After attempts are exhausted, use “Retry failed deliveries now” once your receiver works. Retries retain the event id; do not assume a precise delivery time.

    Troubleshooting

    403 — website not allowed
    Match the exact HTTPS origin, including subdomain. Check that NotaryDirect has not paused your integration.
    401 — key not accepted
    Check the Bearer header and that the key is active. Replace a revoked key.
    409 — time taken
    Fetch availability again and choose another free meeting time.
    429 — rate limit
    Wait before retrying and reduce repeated requests.