API reference / Apps
List Stripe customers
Customers in the workspace's Stripe, newest first: one by exact email, those whose name contains query, or those created since a date. Read only. Needs Stripe connected.
get
/api/v1/apps/stripe/customersOther ways to call it
CLI
troopy stripe customersMCP tool
troopy_stripe_customersRate limit60 calls in 60 seconds, for each key
Query parameters
emailstringAn exact email address
At most 200 characters
querystringPart of the customer's name, at least 3 characters
At least 3 characters · At most 100 characters
sincestringOnly customers created on or after this date
date
limitintegerAt most 50; ask for 10 or fewer to read them all at once
Default 10 · At least 1 · At most 50
cursorstringThe next value from the previous page
At most 200 characters
Response
200 · application/jsondata*array<object>7 properties
id*stringemail*string | nullname*string | nullcreated*stringISO 8601 date and time
delinquent*booleanStripe's flag for a customer whose latest invoice or payment failed
balance*numberWhat they owe (above 0) or are owed (below 0), in the main unit
currency*string | nullhasMore*booleannext*string | nullPass as cursor for the next page; null on the last
Errors
400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask an organization owner or admin.
429 rate_limitedWait the number of seconds in Retry-After, then retry.