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: trueand 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 409idempotency_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 400idempotency_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
- Balance
- CatalogueMedia
- CatalogueMediaFlashOffer
- CatalogueMediaMetrics
- CatalogueOffer
- CatalogueOfferOrNull
- CataloguePostOffer
- CataloguePostOfferAllOfExtras
- CataloguePostOfferAllOfExtrasSensitiveTopic
- CodeName
- CountSavedFilterMedias200Response
- CreateProjectRequest
- CreateSavedFilterRequest
- Error
- GetBuyerWallet200Response
- GetMe200Response
- GetMe200ResponseBuyer
- GetMe200ResponseCatalogue
- GetMe200ResponseManagedService
- GetMe200ResponseSeller
- GetSellerWallet200Response
- GetVocabulary200Response
- GetVocabulary200ResponseTopicsInner
- Invoice
- LinkAdditionOrderBriefing
- LinkAdditionOrderBriefingRequest
- ListBuyerTransactions200Response
- ListFlashOffers200Response
- ListInvoices200Response
- ListManagedServiceCampaigns200Response
- ListManagedServiceProposals200Response
- ListOrders200Response
- ListProjects200Response
- ListSavedFilters200Response
- ListSellerMedias200Response
- ListSellerOrders200Response
- ListSellerTransactions200Response
- ListWithdrawals200Response
- ManagedServiceCampaign
- ManagedServiceCampaignProject
- ManagedServiceCampaignProposalCounts
- ManagedServiceCampaignStrategy
- ManagedServiceProposal
- ManagedServiceProposalBriefing
- ManagedServiceProposalBriefingLinksInner
- ManagedServiceProposalMedia
- ManagedServiceProposalReview
- ManagedServiceProposalReviewRequest
- ManagedServiceProposalReviewRequestReviewsInner
- ManagedServiceProposalsEstimate
- ManagedServiceProposalsEstimateRequest
- ManagedServiceRequest
- ManagedServiceRequestSent
- Money
- MoneyOrNull
- Order
- OrderActionReason
- OrderBriefing
- OrderChannel
- OrderCreateRequest
- OrderDelivery
- OrderDraft
- OrderEstimate
- OrderEstimateRequest
- OrderEstimateRequestBriefing
- OrderLink
- OrderLinkRequest
- OrderMedia
- OrderProject
- OrderStateHistoryInner
- OrderStateHistoryInnerReason
- PostOrderBriefing
- PostOrderBriefingRequest
- Project
- ProjectCatalogueMedia
- ProjectCatalogueMediaAllOfProject
- PutSellerHoliday200Response
- PutSellerHolidayRequest
- RequestMedias201Response
- RequestMediasRequest
- SavedFilter
- SavedFilterNotifications
- SellerFees
- SellerFeesOrNull
- SellerMedia
- SellerMediaFlashOffer
- SellerMediaLinkAdditionOffer
- SellerMediaLinkAdditionOfferPricingOptionsInner
- SellerMediaPostOffer
- SellerMediaPostOfferPricingOptionsInner
- SellerOrder
- SellerOrderBriefing
- SellerOrderChannel
- SellerOrderDraft
- SellerOrderDraftFile
- SellerOrderPostDelivery
- SellerOrderProject
- SellerOrderRefutation
- SellerOrderRejection
- SellerOrderRejectionReason
- SellerPostOrderBriefing
- SellerTransaction
- Transaction
- UpdateProjectRequest
- UpdateSellerMediaRequest
- UpdateSellerMediaRequestExtraServicesInner
- UpdateSellerMediaRequestLinkAdditionOffer
- UpdateSellerMediaRequestLinkAdditionOfferPricingOptionsInner
- UpdateSellerMediaRequestPostOffer
- UpdateSellerMediaRequestPostOfferPricingOptionsInner
- UploadFile201Response
- Withdrawal
Documentation For Authorization
Authentication schemes defined for the API:
apiKey
- Type: Bearer authentication
Author
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| growwer-1.0.1.tar.gz | 143.2 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.