v1

latestOpenAPI 3.0.02026-07-24161215397.4 KB

Plans

Get plans

Retrieve a list of plans based on provided filters

Required scopes: flex.billing.plans.read

get/api/v2/organizations/{orgSlug}/plans

Path parameters

orgSlugstring required

organization slug

Query parameters

_idstring

Filter by plan id. Supports single id (e.g. _id=xxx) or multiple (e.g. _id[$in]=id1,id2).

namestring

Example:Plan Name

Filter by the exact name of the plan.

codestring

Example:EXMPL

Filter by the code of the plan.

locationstring

Example:6780f1ba4d5e6f7a8b9c0d1e

Filter by location

modifiedAtstring

Example:modifiedAt[$gte]=YYYY-MM-DDTHH:mm:ssZ

Filter by the modified date. Supports date comparison filters: $gt, $gte, $lt, $lte

createdAtstring

Example:createdAt[$gte]=YYYY-MM-DDTHH:mm:ssZ

Support date comparison filters: $gt, $gte, $lt, $lte

$selectstring

Select fields to return

$cursorNextstring

$cursorPrevstring

$limitnumber

Response

rangeStartnumber

rangeEndnumber

cursorNextstring

cursorPrevstring

Example response

{
  "results": [
    {
      "properties": {
        "customProperty1": "value1",
        "customProperty2": "value2"
      },
      "_id": "6a59d07d856fad4ee41952be",
      "name": "Plan Name",
      "description": "Example Description",
      "code": "EXMPL",
      "type": "Desk",
      "price": 100,
      "deposit": 50,
      "depositPercent": 20,
      "useDepositPercent": true,
      "locations": [
        "6a59d07d856fad4ee41952bf",
        "6a59d07d856fad4ee41952c0"
      ],
      "image": "exampleImageLink.com",
      "link": "exampleExternalLink.com",
      "intervalCount": 6,
      "revenueAccount": "6a59d07d856fad4ee41952c1",
      "setupFees": [
        "6a59d07d856fad4ee41952c2",
        "6a59d07d856fad4ee41952c3"
      ],
      "discounts": [
        "6a59d07d856fad4ee41952c4",
        "6a59d07d856fad4ee41952c5"
      ],
      "legalDocuments": [
        "6a59d07d856fad4ee41952c6",
        "6a59d07d856fad4ee41952c7"
      ],
      "shouldProrate": true,
      "credits": [],
      "useCoins": true,
      "extras": [],
      "requiresApproval": true,
      "allowsCancellation": true,
      "forMembers": true,
      "forTeamMembers": true,
      "forNonMembers": true,
      "shouldPassesGrantActiveStatus": true,
      "amenities": [
        "6a59d07d856fad4ee41952c8",
        "6a59d07d856fad4ee41952c9"
      ]
    }
  ]
}