Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Recurly Python Client
Latest commit cb328c @cbarton cbarton Merge pull request #135 from recurly/bump_2_2_17
Bump version 2.2.17


Recurly Python Client

Recurly's Python client library is an interface to its REST API.


Recurly is packaged as a Python package. We recommend you install it with PyPI by adding it to your requirements.txt:

pip install recurly


Set your API key and optionally set a certificate authority certificate file and default currency:

import recurly

recurly.SUBDOMAIN = 'your-subdomain'
recurly.API_KEY = '012345678901234567890123456789ab'

# Set a certificate authority certs file to validate Recurly's certificate
recurly.CA_CERTS_FILE = '/etc/pki/tls/certs/ca-bundle.crt'

# Set a default currency for your API requests

Recurly Python Client Tests

To run these tests in Python 2.7, use the unittest test runner:

$ python -m unittest discover -s tests

Under Python 2.6 or earlier, install the unittest2 distribution and use it instead:

$ pip install unittest2 # or easy_install $ python -m unittest2 discover -s tests

The resource tests in will run using the HTTP fixtures in tests/fixtures. To run the tests against a live Recurly API endpoint, configure your Recurly test account and use its API key in the RECURLY_API_KEY environment variable:

$ RECURLY_API_KEY=1274...54e3 python -m unittest tests.test_resources

The live Recurly API endpoint can also be tested while validating the server certificate with the RECURLY_CA_CERTS_FILE environment variable, which should be a filename of concatenated certificate authority X.509 certificates:

$ RECURLY_API_KEY=1274...54e3 RECURLY_CA_CERTS_FILE=/etc/pki/tls/certs/ca-bundle.crt -m unittest tests.test_resources


Please see the Recurly API for more information.



Something went wrong with that request. Please try again.