Zippendo Python SDK

Official Python client for the Zippendo shipping & logistics API. Models are pydantic v2, so requests and responses are both type-hinted and validated at runtime. Requires Python 3.8+.

Install

pip install zippendo

Authentication

Create an API token in your Zippendo dashboard (Settings → API tokens) — a Bearer token prefixed with zipp_. Pass it as access_token:

import os
import zippendo

config = zippendo.Configuration(access_token=os.environ["ZIPPENDO_API_TOKEN"])

The base URL defaults to https://api.zippendo.com.

Resources & clients

The API is split into resource clients — ShipmentsApi, OrdersApi, CarriersApi, AddressesApi, RulesApi, WebhooksApi, TokensApi, and more. Create an ApiClient from your config, then the resource clients you need:

with zippendo.ApiClient(config) as client:
    shipments = zippendo.ShipmentsApi(client)
    orders = zippendo.OrdersApi(client)

The `org_id` parameter

Every call takes an org_id (your organization ID, found in the dashboard). It is explicit on each call by design: one API token can be granted access to multiple organizations, and org_id selects which one the request acts on.

Listing & pagination

List endpoints accept page (1-based) and limit, and return a page with data plus total, page, limit, and total_pages:

with zippendo.ApiClient(config) as client:
    shipments = zippendo.ShipmentsApi(client)
    result = shipments.list_shipments("org_8f3kd92ld0", page=1, limit=50)
    print(result.data)                       # list[Shipment]
    print(result.total, result.total_pages)  # pagination metadata

Creating resources

with zippendo.ApiClient(config) as client:
    orders = zippendo.OrdersApi(client)
    order = orders.create_order(
        "org_8f3kd92ld0",
        zippendo.CreateOrderRequest(
            order_number="1001",
            order_channel_id="chan_7d2k1",
            order_lines=[zippendo.CreateOrderRequestOrderLinesInner(name="T-shirt", quantity=2)],
        ),
    )
    print(order.id)

See ./docs for the full request/response shape of every operation.

Error handling

Non-2xx responses raise ApiException. The body is Zippendo's canonical { code, error, message } — branch on the machine-readable code:

from zippendo.rest import ApiException

try:
    shipments.get_shipment("org_8f3kd92ld0", "shp_missing")
except ApiException as e:
    print(e.status, e.body)   # e.body contains the JSON, e.g. {"code": "SHIPMENT_NOT_FOUND", ...}

Configuration

Point the client at a different environment by overriding host:

config = zippendo.Configuration(
    access_token=os.environ["ZIPPENDO_API_TOKEN"],
    host="https://staging.api.zippendo.com",
)

Reference

Full per-endpoint and per-model documentation is in ./docs. Hosted reference: https://www.zippendo.com/docs/api-reference/overview.

License

MIT

Metadata

Release files for zippendo 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zippendo 1.0.1
File	Size	Uploaded	Provenance
zippendo-1.0.1.tar.gz	164.4 kB	Jul 31, 2026	Without provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for zippendo 1.0.1
File	Interpreter	ABI	Platform	Reset
zippendo-1.0.1-py3-none-any.whl 336.4 kB Jul 31, 2026 Without provenance	Python 3	none	any	Details

Total release size: 500.9 kB

Release files / zippendo-1.0.1.tar.gz

Download URL	zippendo-1.0.1.tar.gz
Size	164.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`0f9b08738abddf0fb6ada8e78d9c0800c624695f5a0c481a4ab5c4ad56378167`
BLAKE2b-256 checksum How to use checksums	`e2972dfc105decd40a5f61fafa32097691e53a8f11cd2db81b2da774647a3947`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.6`

Release files / zippendo-1.0.1-py3-none-any.whl

Download URL	zippendo-1.0.1-py3-none-any.whl
Size	336.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c4d3335f510b2536df90502969a13bcc2bfedde4e73198cba5975da7490aa6eb`
BLAKE2b-256 checksum How to use checksums	`cf5d8d1e2bb0f139a82bc319349d0033ae88bbe0c711d4b7595712815d6ece28`
Upload date	Jul 31, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.6`

Security for zippendo 1.0.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.