Skip to main content

Library for communicating with GSX Web Services API.

Project description


gsxws is a Python library designed to work with Apple's GSX Web Services API. The goal is for it to support all the features of the API. Currently it supports most of them.

Please consult the GSX API documentation (Testing, Production) for more details.


  • Python 2.7 or later
  • contents of requirements.pip
  • GSX client certs and valid Apple ID with access to GSX Web Services


pip install gsxws

... or grab the latest dev version:

pip install -U -e git+git://


It goes a little something like this:

# check warranty status
import os
import gsxws
os.environ['GSX_CERT'] = '/path/to/gsx/client/cert.pem'
os.environ['GSX_KEY'] = '/path/to/gsx/client/cert_private_key.pem'
gsxws.connect(apple_id, sold_to)
mac = gsxws.Product('70033CDFA4S')
# get available parts for this machine

Check the tests folder for more examples.


  • Q: My script keeps prompting me for the private key passphrase - how could I automate this?

  • A: One way would be to remove the passphrase from the key:

    openssl rsa -in privatekey.pem -out privatekey.nopass.pem

Project details

Download files

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

Source Distribution

gsxws-0.94.tar.gz (29.1 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page