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 GSXWS API documentation 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

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
gsxws-0.92.tar.gz (27.0 kB) Copy SHA256 hash SHA256 Source None Sep 3, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page