Skip to main content

SDK for using the Idfy API in Python

Project description

Idfy Python SDK

Build Status PyPI

A Python SDK for simple integration with the Idfy REST API.

Supports Python 3.5 and above. (3.5, 3.6, 3.7)


The package is available on PyPI. Use of Pipenv is recommended (

pipenv install idfy-sdk

Although it's just as easy to install without Pipenv:

pip install idfy-sdk

External libraries

This SDK was made to use as few external libraries as possible. It uses only the excellent "Requests" module ( which is probably the most commonly used Python library as of the writing of this document.

Working on the Code

Developers who want to make changes to the codebase are welcome to do so, but if you want to run the included unit-tests you need to download and run the Idfy mock server ( Once the server is up and running, all you have to do is navigate to the root folder of the SDK and type:

python -m unittest

If you're developing on a Linux-based system, remember to replace "python" with your desired Python interpreter as appropriate.

We know that many of our customers have very talented in-house developers, and we want to encourage our customers to make any changes they want to make the SDK perfectly suit their needs. Please feel free to send any potential questions or suggestions for improvement to our support channels listed below. We appreciate the feedback.


Sample Usage

The example below shows how to get the details of a specific document.

# Import the SDK into your module
import idfy_sdk

# Set your credentials and desired scopes
idfy_sdk.IdfyConfiguration.set_client_credentials("Your client ID here", "Your client secret here", ["A list containing all your desired scopes (see documentation)"])

# Make a call to retrieve the document
service =

document_info = service.get_document(document_id)


Asynchronous Methods

Using the async methods will make the program no longer run strictly single-threaded. The SDK is also able to make use of some of the features introduced to the asyncio module in Python 3.7, so running the code on that version or later might yield slight improvemets to efficiency and robustness when using async methods.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for idfy-sdk, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size idfy_sdk-1.1.0-py3-none-any.whl (283.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size idfy_sdk-1.1.0.tar.gz (108.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page