com.atiproto.repo.subscription.count

Count active subscriptions. If subject is provided, counts subscriptions received by that DID. If omitted, counts subscriptions the authenticated user has active (as the subscriber). Optionally filtered by a start/end datetime window (matching billingStartDate). When the authenticated user is the subject/owner of the target, the response also includes the sum of amounts.

Repository @atiproto.com did:plc:4x5dcv6u4wlkjcssto7f22nu namespace authority
Details · query
Kindquery
Authoritysubscription.repo.atiproto.com
Indexed

Query

query · GET

Parameters

query string

endDate

string · datetime

Only count subscriptions whose billingStartDate is at or before this timestamp

startDate

string · datetime

Only count subscriptions whose billingStartDate is at or after this timestamp

subject

string · did

DID of the user being subscribed to. If omitted, the query counts subscriptions the authenticated user has active as the subscriber.

Output

application/json

amount

integer

Sum of all subscription amounts in cents. Only returned when the authenticated user is the subject/owner of the target (or when counting their own active subscriptions).

count

requiredinteger

Number of active subscriptions matching the filter

currency

string

Currency of the summed amount. Only returned when the authenticated user is the subject/owner of the target (or when counting their own active subscriptions).

  • maxLength: 3

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Count active (completed) items. If recordUri is provided, counts items for that record. If subject is provided, counts items received by that DID. If neither is provided, counts items sent by the authenticated user. Optionally filtered by a start/end datetime window. When the authenticated user is the subject/owner of the target, the response also includes the sum of amounts.

  • A record representing a subscription from one user to another

  • Get a specific subscription sent by the authenticated user. Looks up by subscription record uri or subject (recipient) DID. These are mutually exclusive; uri takes precedence.

  • Validate that the authenticated user (as the sender/subscriber) has an active, Stripe-verified subscription. Looks up by subscriptionUri (a specific subscription record) or subject (recipient DID). These are mutually exclusive; subscriptionUri takes precedence.

  • List subscriptions received by the authenticated user (subscriptions where the authed user is the recipient/subject). Includes subscriptions marked private, which are only stored in atiproto's database.