Integrate self-service in minutes

Let customers book their own treatment appointments fully automatically after reporting a claim. Via APIs, policies and referrals can be verified. Case details are sent automatically so customers don't need to fill in information. The process is secured with BankID.

Contact sales

Why choose Speare Self-Service?

Automated workflow

Create case → Customer gets link → Self-service booking → Transferred to provider

BankID verified

Customer is authenticated with Norwegian BankID for secure identity verification

Real-time availability

Live availability for psychologists/providers from integrated booking systems

Multi-channel notifications

Built-in email and SMS notifications to the customer

How it works

Partner creates case

API call with customer details

Customer is notified

Email/SMS with booking link

BankID, choose time, confirm

Transferred to provider

Booking sent automatically

Get started

Get started in 3 simple steps:

Get your API key

Contact us at support@speare.no to get your partner account and API key. We'll set you up with sandbox access for testing.

Create a case

Send customer details via API. They automatically receive a booking link.

curl -X POST "https://behandlingsdekning.no//api/v1/cases" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key-here" \
  -d '{
    "partnerCaseId": "CASE-123",
    "patientFirstName": "Ola",
    "patientLastName": "Nordmann",
    "patientEmail": "ola@example.no",
    "patientPhone": "+47 12345678",
    "injuryDate": "2024-01-15",
    "injuryDescription": "Ryggskade etter bilulykke",
    "treatmentType": "fysioterapi",
    "bookingDeadline": "2024-02-15"
  }'

Customer books automatically

Customer receives an email/SMS with their unique booking link. They log in with BankID, see available times and confirm their appointment. The booking is automatically transferred to the provider.

Technical reference

Complete API documentation for developers

Base URL

https://behandlingsdekning.no//api/v1

Authentication

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

X-API-Key: your-api-key-here

Rate limiting

Rate limiting applies to all API requests

Public100 requests per minute
Authenticated500 requests per minute
Login5 requests per 15 minutes

Error responses

All errors follow a consistent JSON format:

{
  "error": "Invalid API key",
  "statusCode": 401,
  "details": {
    "code": "INVALID_API_KEY"
  }
}

Case endpoints

Authentication required

All case endpoints require a valid X-API-Key header.

Booking endpoints

Public access

These endpoints are used by customers via their unique case UUID. No API key required.

Partner authentication

Webhooks

Coming soon

Partners will be able to register webhooks to receive real-time updates about case status changes. This feature is planned for a future release.

HTTP status codes

Code	Description
`200`	Successful request
`201`	Resource created
`400`	Bad request - Invalid input
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - No access
`404`	Not found - Resource does not exist
`429`	Too many requests - Rate limit exceeded
`500`	Internal server error

Case status values

Status	Description
`pending_patient_action`	Waiting for customer to book appointment
`booked`	Customer has booked appointment
`deadline_expired`	Booking deadline has expired
`assistance_requested`	Customer has requested booking assistance
`recalled`	Case recalled by partner
`archived`	Case is archived
`error`	Error processing case

Ready to integrate?

Get started today with our user-friendly API. Our team is ready to help you integrate self-service into your insurance workflow.

Email: support@speare.no