Fingerprint Pro Server API SDK (Legacy v3)

8.13.0 verified Mon Apr 27 auth: no python deprecated

Deprecated Python SDK for Fingerprint Pro Server API v3. Provides a client to manage identification events, webhook processing, and data exports for server-side usage. Current version 8.13.0 is the final release under this package name. Users must migrate to the new fingerprint-server-sdk package for Server API v4. Release cadence is irregular.

pip install fingerprint-pro-server-api-sdk==8.13.0

Common errors

error ModuleNotFoundError: No module named 'fingerprint_pro_server_api_sdk' ↓

cause Package not installed or using new name fingerprint_server_sdk.

fix

Install the correct package: 'pip install fingerprint-pro-server-api-sdk==8.13.0' or migrate to fingerprint_server_sdk.

error AttributeError: module 'fingerprint_pro_server_api_sdk' has no attribute 'FingerprintApi' ↓

cause FingerprintApi is in the api submodule, not top-level.

fix

Use 'from fingerprint_pro_server_api_sdk.api import FingerprintApi'.

error ApiException: (401) Reason: Unauthorized ↓

cause API key missing or not configured with 'Bearer' prefix.

fix

Set api_key and prefix: config.api_key['Authorization'] = 'your_key'; config.api_key_prefix['Authorization'] = 'Bearer'.

Warnings

deprecated Package is deprecated. Use fingerprint_server_sdk (v9+) for Server API v4. No further updates planned. ↓

fix Migrate to fingerprint_server_sdk following the official migration guide: https://dev.fingerprint.com/reference/migrating-from-server-api-v3-to-v4

breaking Import path changed in v9.0.0. fingerprint_pro_server_api_sdk renamed to fingerprint_server_sdk. All class names may differ. ↓

fix Replace 'import fingerprint_pro_server_api_sdk' with 'import fingerprint_server_sdk' and update class references per v4 docs.

gotcha API key must be passed as 'Authorization' header with 'Bearer' prefix via api_key_prefix. Omitting the prefix causes authentication errors. ↓

fix Set config.api_key_prefix['Authorization'] = 'Bearer' before making requests.

gotcha FingerprintApi is located in the api submodule, not top-level. Importing directly from the package root raises AttributeError. ↓

fix Use 'from fingerprint_pro_server_api_sdk.api import FingerprintApi'.

Imports

ApiClient

wrong

from fingerprint_server_sdk import ApiClient

correct

from fingerprint_pro_server_api_sdk import ApiClient

Wrong package: fingerprint_server_sdk uses a different client class

Configuration

from fingerprint_pro_server_api_sdk import Configuration

FingerprintApi

wrong

from fingerprint_pro_server_api_sdk import FingerprintApi

correct

from fingerprint_pro_server_api_sdk.api import FingerprintApi

FingerprintApi is in the api submodule

Quickstart

Initialize the legacy SDK client and search events. Authentication using bearer token. Works with v3 API.

import os
from fingerprint_pro_server_api_sdk import ApiClient, Configuration
from fingerprint_pro_server_api_sdk.api import FingerprintApi

config = Configuration()
config.api_key['Authorization'] = os.environ.get('FINGERPRINT_API_KEY', '')
config.api_key_prefix['Authorization'] = 'Bearer'

client = ApiClient(config)
api = FingerprintApi(client)

try:
    events = api.search_events()
    print(events)
except Exception as e:
    print(f"Error: {e}")