{"library":"pysnow","title":"pysnow: ServiceNow HTTP Client Library","description":"pysnow is a Python library for interacting with the ServiceNow REST API, emphasizing ease of use, simple code, and elegant syntax. It supports both Python 2 and 3. As of version 0.7.17, the library is in a stable maintenance mode, meaning essential fixes are applied, but new feature development has shifted to `aiosnow`, an asynchronous counterpart.","language":"python","status":"maintenance","last_verified":"Mon May 18","install":{"commands":["pip install pysnow"],"cli":null},"imports":["from pysnow import Client","from pysnow import OAuthClient","from pysnow import QueryBuilder"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nimport pysnow\n\n# Configure ServiceNow instance details from environment variables or provide directly\ninstance = os.environ.get('SNOW_INSTANCE', 'your_instance_name') # e.g., 'dev12345'\nuser = os.environ.get('SNOW_USER', 'your_username')\npassword = os.environ.get('SNOW_PASSWORD', 'your_password')\n\nif not all([instance, user, password]):\n    print(\"Please set SNOW_INSTANCE, SNOW_USER, and SNOW_PASSWORD environment variables or provide them directly.\")\nelse:\n    try:\n        # Create a client object\n        client = pysnow.Client(instance=instance, user=user, password=password)\n\n        # Define a resource, e.g., the incident table API\n        incident = client.resource(api_path='/table/incident')\n\n        # Query for incidents with state 1 (e.g., New) and print the first one\n        response = incident.get(query={'state': 1})\n        first_incident = response.first_or_none()\n\n        if first_incident:\n            print(f\"Found incident: {first_incident['number']} - {first_incident['short_description']}\")\n        else:\n            print(\"No incidents found with state 1.\")\n\n    except pysnow.exceptions.InvalidUsage as e:\n        print(f\"Client initialization error: {e}\")\n    except pysnow.exceptions.NoResults:\n        print(\"No results returned for the query (this is expected if raise_on_empty is True and no results).\")\n    except pysnow.exceptions.ResponseError as e:\n        print(f\"ServiceNow API error: {e.error['message']} - {e.error['detail']}\")\n    except Exception as e:\n        print(f\"An unexpected error occurred: {e}\")","lang":"python","description":"This quickstart demonstrates how to initialize the `pysnow` client, create a resource for the incident table, and fetch the first record matching a specific query. It includes basic error handling for common `pysnow` exceptions.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-18","installed_version":"0.7.17","pypi_latest":"0.7.17","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":3.6,"avg_import_s":0.74,"wheel_type":"sdist"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.67,"mem_mb":12.6,"disk_size":"27.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":3.3,"import_time_s":0.48,"mem_mb":12.6,"disk_size":"28M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.94,"mem_mb":14.1,"disk_size":"30.5M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":3.2,"import_time_s":0.8,"mem_mb":14.1,"disk_size":"31M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.77,"mem_mb":13.9,"disk_size":"20.3M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":4,"import_time_s":0.82,"mem_mb":13.9,"disk_size":"21M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.83,"mem_mb":15.1,"disk_size":"20.0M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":3.8,"import_time_s":0.83,"mem_mb":15.1,"disk_size":"20M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":null,"import_time_s":0.64,"mem_mb":12.3,"disk_size":"27.0M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"pysnow","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"noisy","install_time_s":3.7,"import_time_s":0.67,"mem_mb":12.3,"disk_size":"28M"}]}}