Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Support user id filtering in subscriptions list

Open
#1,057 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
45/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
python
Domain
api

Research direction

Start in planet/clients/subscriptions.py around the TODO at line 78 and compare list_subscriptions with the Subscriptions API's user_id parameter. Define the requested optional filtering and user-ID lookup behavior, then verify that both are exposed through the client and preserve existing listing behavior.

Written by the indexing model from the issue text.

Description

enhancement proposal

Is your feature request related to a problem? Please describe.
The SubsciptionsClient.list_subscriptions appears to yield all visible subscriptions within an org. The Subscriptions API has support for a user_id parameter to filter, but this does not yet appear to have support in the client.

Describe the solution you'd like

  • add support for optional user_id filter arg to SubsciptionsClient.list_subscriptions
  • add a utility to make it easy to lookup or get your own user_id

Describe alternatives you've considered
instead of separating get user id and user id filtering, there could be an arg such as owned_by_current_user. this would be easier to use but less directly mapped to the API params

Additional context
looks like someone left a TODO to add user_ud support here already https://github.com/planetlabs/planet-client-python/blob/main/planet/clients/subscriptions.py#L78

Dominant language
Python
Stars
300
Forks
99
Avg merge
9d 22h
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from planetlabs/planet-client-python

All issues in planetlabs/planet-client-python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.