List customers on a plan

GET {{baseUrl}}/planDetails/:plan_id/customers?limit=<integer>&next_page=<string>&status=all

Fetches a list of customers on a specific plan (by default, only currently active plans are included)

Request Params

KeyDatatypeRequiredDescription
limitstringMax number of results that should be returned
next_pagestringCursor that indicates where the next page of results should start.
statusstringStatus of customers on a given plan. Defaults to active.
  • all - Return current, past, and upcoming customers of the plan.
  • active - Return current customers of the plan.
  • ended - Return past customers of the plan.
  • upcoming - Return upcoming customers of the plan.

Multiple statuses can be OR'd together using commas, e.g. active,ended. Note: ended,upcoming combination is not yet supported. |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:[{&quot;customer_details&quot;:{&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;customer_config&quot;:{&quot;salesforce_account_id&quot;:&quot;\u003cstring\u003e&quot;},&quot;ingest_aliases&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;custom_fields&quot;:{&quot;exercitation_20&quot;:&quot;\u003cstring\u003e&quot;,&quot;veniam__9&quot;:&quot;\u003cstring\u003e&quot;,&quot;reprehenderit_1&quot;:&quot;\u003cstring\u003e&quot;,&quot;minim3f3&quot;:&quot;\u003cstring\u003e&quot;},&quot;current_billable_status&quot;:{&quot;value&quot;:&quot;unbillable&quot;,&quot;effective_at&quot;:&quot;\u003cdateTime\u003e&quot;}},&quot;plan_details&quot;:{&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_fields&quot;:{&quot;proidente&quot;:&quot;\u003cstring\u003e&quot;,&quot;dolore4d&quot;:&quot;\u003cstring\u003e&quot;,&quot;enim2&quot;:&quot;\u003cstring\u003e&quot;,&quot;esse_535&quot;:&quot;\u003cstring\u003e&quot;},&quot;starting_on&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;customer_plan_id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;ending_before&quot;:&quot;\u003cdateTime\u003e&quot;}},{&quot;customer_details&quot;:{&quot;external_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;customer_config&quot;:{&quot;salesforce_account_id&quot;:&quot;\u003cstring\u003e&quot;},&quot;ingest_aliases&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;custom_fields&quot;:{&quot;in_e26&quot;:&quot;\u003cstring\u003e&quot;,&quot;ut_4&quot;:&quot;\u003cstring\u003e&quot;},&quot;current_billable_status&quot;:{&quot;value&quot;:&quot;unbillable&quot;,&quot;effective_at&quot;:&quot;\u003cdateTime\u003e&quot;}},&quot;plan_details&quot;:{&quot;id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;custom_fields&quot;:{&quot;incididuntb0&quot;:&quot;\u003cstring\u003e&quot;,&quot;Excepteur_1&quot;:&quot;\u003cstring\u003e&quot;},&quot;starting_on&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;customer_plan_id&quot;:&quot;\u003cuuid\u003e&quot;,&quot;ending_before&quot;:&quot;\u003cdateTime\u003e&quot;}}],&quot;next_page&quot;:&quot;\u003cstring\u003e&quot;}