Skip to main content

growwer

The Growwer customer API. Authenticate every call with an API key created on your profile page, sent as Authorization: Bearer <key>. A read key can call every GET operation; writes need a read and write key and an Idempotency-Key header.

Idempotency: use a new Idempotency-Key (1 to 255 printable ASCII characters without spaces) for each operation and reuse it only to retry that same operation. Keys belong to your account, not to one API key.

  • A successful write is stored for 30 days: a retry with the same key and the same request replays its response with Idempotent-Replayed: true and does nothing again.
  • A refused write (4xx) has no effect and releases its key: once you fix the cause, retry with the same key and the write runs.
  • A failed write (5xx) may have taken effect, so it is never run again under its key: a retry gets 409 idempotency_outcome_unknown. Check whether it took effect before retrying with a new key.
  • A retry while the first request is still running gets 409 idempotency_request_in_progress. A request still running after 5 minutes is treated as failed: a retry gets 409 idempotency_outcome_unknown.
  • The same key with a different request (method, path, query or body) gets 409 idempotency_key_reused. A write without the header gets 400 idempotency_key_required.

Every response carries X-Request-Id. Errors share one shape, {code, message, requestId, details?}. Money is integer cents plus a currency code and dates are ISO-8601.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 1
  • Package version: 1.0.1
  • Generator version: 7.24.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://growwer.com/contact/

Requirements.

Python 3.10+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/viralitymedia/growwer-api-sdk.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/viralitymedia/growwer-api-sdk.git)

Then import the package:

import growwer

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import growwer

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import growwer
from growwer.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://tool.growwer.com
# See configuration.py for a list of all supported configuration parameters.
configuration = growwer.Configuration(
    host = "https://tool.growwer.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure Bearer authorization: apiKey
configuration = growwer.Configuration(
    access_token = os.environ["BEARER_TOKEN"]
)


# Enter a context with an instance of the API client
with growwer.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = growwer.AccountApi(api_client)

    try:
        # Your account
        api_response = api_instance.get_me()
        print("The response of AccountApi->get_me:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AccountApi->get_me: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://tool.growwer.com

Class Method HTTP request Description
AccountApi get_me GET /api/v1/me Your account
AccountApi get_vocabulary GET /api/v1/vocabulary Codes and names
AccountApi put_seller_holiday PUT /api/v1/seller/holiday Set your holiday
BuyerMoneyApi download_buyer_transaction_document GET /api/v1/wallets/buyer/transactions/{id}/document Download the document of a wallet movement
BuyerMoneyApi get_buyer_wallet GET /api/v1/wallets/buyer Get your buyer wallet
BuyerMoneyApi get_invoice_pdf GET /api/v1/invoices/{id}/pdf Download an invoice
BuyerMoneyApi list_buyer_transactions GET /api/v1/wallets/buyer/transactions List your buyer wallet movements
BuyerMoneyApi list_invoices GET /api/v1/invoices List your invoices
CatalogueApi discard_media PUT /api/v1/projects/{id}/discards/{mediaId} Discard a media for a project
CatalogueApi favourite_media PUT /api/v1/projects/{id}/favourites/{mediaId} Add a media to the favourites of a project
CatalogueApi get_catalogue_media GET /api/v1/medias/{id} Get a media
CatalogueApi list_flash_offers GET /api/v1/flash-offers List flash offers
CatalogueApi request_medias POST /api/v1/projects/{id}/media-requests Request specific medias for a project
CatalogueApi search_project_medias GET /api/v1/projects/{id}/medias Search the catalogue for a project
CatalogueApi undiscard_media DELETE /api/v1/projects/{id}/discards/{mediaId} Restore a discarded media for a project
CatalogueApi unfavourite_media DELETE /api/v1/projects/{id}/favourites/{mediaId} Remove a media from the favourites of a project
FilesApi upload_file POST /api/v1/files Upload a file
ManagedServicesApi estimate_managed_service_proposals POST /api/v1/managed-service/campaigns/{id}/proposals/estimate Estimate accepting proposals
ManagedServicesApi get_managed_service_campaign GET /api/v1/managed-service/campaigns/{id} Get a managed service campaign
ManagedServicesApi get_managed_service_proposals_summary GET /api/v1/managed-service/campaigns/{id}/proposals-summary Download the summary of a campaign's proposals
ManagedServicesApi list_managed_service_campaigns GET /api/v1/managed-service/campaigns List your managed service campaigns
ManagedServicesApi list_managed_service_proposals GET /api/v1/managed-service/campaigns/{id}/proposals List the proposals of a campaign
ManagedServicesApi request_managed_service_campaign POST /api/v1/managed-service/campaign-requests Request a new campaign
ManagedServicesApi request_managed_service_info POST /api/v1/managed-service/info-requests Ask about the managed service
ManagedServicesApi review_managed_service_proposals POST /api/v1/managed-service/campaigns/{id}/proposals/review Accept or reject proposals
OrdersApi approve_order POST /api/v1/orders/{id}/approve Approve an order's delivery
OrdersApi approve_order_draft POST /api/v1/orders/{id}/approve-draft Approve a draft
OrdersApi cancel_order POST /api/v1/orders/{id}/cancel Cancel an order
OrdersApi create_order POST /api/v1/orders Place an order
OrdersApi download_order_briefing GET /api/v1/orders/{id}/briefing Download the draft you attached to an order
OrdersApi download_order_draft GET /api/v1/orders/{id}/draft Download the draft of an order
OrdersApi estimate_order POST /api/v1/orders/estimate Estimate an order
OrdersApi get_order GET /api/v1/orders/{id} Get an order
OrdersApi list_orders GET /api/v1/orders List your orders
OrdersApi request_order_draft_update POST /api/v1/orders/{id}/request-draft-update Request changes to a draft
OrdersApi request_order_update POST /api/v1/orders/{id}/request-update Request changes to a delivery
ProjectsApi create_project POST /api/v1/projects Create a project
ProjectsApi delete_project DELETE /api/v1/projects/{id} Delete a project
ProjectsApi get_project GET /api/v1/projects/{id} Get a project
ProjectsApi list_projects GET /api/v1/projects List your projects
ProjectsApi update_project PATCH /api/v1/projects/{id} Edit a project
SavedFiltersApi count_saved_filter_medias GET /api/v1/projects/{id}/saved-filters/{filterId}/media-count Count the medias of a saved filter
SavedFiltersApi create_saved_filter POST /api/v1/projects/{id}/saved-filters Save a filter
SavedFiltersApi delete_saved_filter DELETE /api/v1/projects/{id}/saved-filters/{filterId} Delete a saved filter
SavedFiltersApi list_saved_filters GET /api/v1/projects/{id}/saved-filters List the saved filters of a project
SellerMediasApi apply_seller_media_competitive_fees POST /api/v1/seller/medias/{id}/apply-competitive-fees Set the competitive fees Growwer suggests
SellerMediasApi get_seller_media GET /api/v1/seller/medias/{id} Get a media you sell on
SellerMediasApi list_seller_medias GET /api/v1/seller/medias List the medias you sell on
SellerMediasApi update_seller_media PATCH /api/v1/seller/medias/{id} Edit the fees of a media you sell on
SellerMoneyApi download_seller_transaction_document GET /api/v1/wallets/seller/transactions/{id}/document Download the document of a seller wallet movement
SellerMoneyApi download_withdrawal_invoice GET /api/v1/withdrawals/{id}/invoice Download the invoice of a withdrawal
SellerMoneyApi get_seller_wallet GET /api/v1/wallets/seller Get your seller wallet
SellerMoneyApi list_seller_transactions GET /api/v1/wallets/seller/transactions List your seller wallet movements
SellerMoneyApi list_withdrawals GET /api/v1/withdrawals List your withdrawals
SellerOrdersApi accept_seller_order POST /api/v1/seller/orders/{id}/accept Accept an order
SellerOrdersApi deliver_seller_order POST /api/v1/seller/orders/{id}/deliver Deliver an order
SellerOrdersApi deliver_seller_order_draft POST /api/v1/seller/orders/{id}/deliver-draft Deliver a draft
SellerOrdersApi deliver_seller_order_draft_update POST /api/v1/seller/orders/{id}/deliver-draft-update Deliver a draft update
SellerOrdersApi deliver_seller_order_update POST /api/v1/seller/orders/{id}/deliver-update Deliver an update
SellerOrdersApi download_seller_order_briefing GET /api/v1/seller/orders/{id}/briefing Download the draft the buyer attached to an order
SellerOrdersApi download_seller_order_draft GET /api/v1/seller/orders/{id}/draft Download the draft of an order you sell
SellerOrdersApi get_seller_order GET /api/v1/seller/orders/{id} Get an order you sell
SellerOrdersApi list_seller_orders GET /api/v1/seller/orders List the orders you sell
SellerOrdersApi refute_seller_order_draft_update POST /api/v1/seller/orders/{id}/refute-draft-update Refuse a draft update
SellerOrdersApi refute_seller_order_update POST /api/v1/seller/orders/{id}/refute-update Refuse an update
SellerOrdersApi reject_seller_order POST /api/v1/seller/orders/{id}/reject Reject an order

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

apiKey

  • Type: Bearer authentication

Author

support@growwer.com

Metadata

Release files for growwer 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 growwer 1.0.1
File Size Uploaded Provenance
growwer-1.0.1.tar.gz 143.2 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for growwer 1.0.1
File Interpreter ABI Platform
growwer-1.0.1-py3-none-any.whl Python 3 none any Details

Total release size: 487.3 kB

Release files / growwer-1.0.1.tar.gz

Download URL growwer-1.0.1.tar.gz
Size 143.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f5f4decaaaaa7738408f30b97f96e7b59096050e639ddcd99a13ccd56771768b
BLAKE2b-256 checksum
How to use checksums
58f9fb5c73ad8ad8c6bac5c5c587f2f1ad69563862f26ebe513accd1282bfa4b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

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

Download URL growwer-1.0.1-py3-none-any.whl
Size 344.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8be45024f82774d098cd99c694f3895d5a786923025e0880dba7eb61c4f3371c
BLAKE2b-256 checksum
How to use checksums
930974d429d69b87252f52193e069f66e28ade32c17d5e29049380a6da6ba9d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

Security for growwer 1.0.1

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for growwer-1.0.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 22, 2026.

Transparency log

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.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page