---
title: "Get organization price plan details"
method: GET
path: "/v3/organizations/{organizationId}/price-plan"
tags: ["organizations"]
---

# Get organization price plan details

`GET /v3/organizations/{organizationId}/price-plan`

Get the BILL price plan details for an existing organization. The currently signed-in user must have the `ADMINISTRATOR` user role in the BILL organization to perform this operation.

A BILL price plan for an organization provides a range of information, including monthly subscription fees and the terms and conditions for additional charges in the price plan.

In the response, the `planTerms` object includes information about charges for price plan features based on a combination of charge `tier`, `quantity`, and `price`. We explain plan terms with an example.
* If `"tier": 1`, `"quantity": 5`, and `"price": 10`, the first 5 users will be charged $10 each.
* If `"tier": 2`, `"quantity": 10`, and `"price": 8`, the next 10 users will be charged $8 each. At this level, if there is no `tier` information, all users after tier 1 will be charged $8 each.

## Path parameters

- `organizationId` string, required — BILL-generated ID of the organization. The value begins with `008`.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Get organization price plan details response

- PricePlanResponseDto — Organization price plan response.
  - `id` string — BILL-generated ID of the price plan. The value begins with `ppl`.
  - `name` string — Price plan name
  - `monthlyPrice` number — Price plan monthly subscription fee
  - `allowTrial` boolean — Set as `true` if the price plan allows a trial
  - `priceVariesPerUser` boolean — Set as `true` if the price plan has per-user pricing
  - `planTerms` PlanTerm[] — Terms and conditions for additional charges in the price plan. These charges are for price plan features based on a combination of charge `type`, `tier`, `quantity`, and `price`.
    - `type` string — Plan charge type
    - `name` 'users' | 'credit' | 'debit' | 'documents' | 'check_US' | 'consoleUser' | 'company' | 'check_NonUS' | 'ePayment' | 'fax' | 'zenBill' | 'recvdEPayment' | 'AR' | 'PayPal' | 'mailInvoices' | 'supportChat' | 'supportEmail' | 'supportPhone' | 'syncPremium' | 'customRoles' | 'trainingLvl1' | 'trainingLvl2' | 'trainingLvl3' | 'acctMgmtLvl1' | 'acctMgmtLvl2' | 'acctMgmtLvl3' | 'demoAccounts' | 'centralBilling' | 'firmBranding' | 'salesTools' | 'multipleModules' | 'consoleCompany' | 'accountantUser' | 'unlimitedConsoles' | 'discount' | 'remoteCheckDeposit' | 'xeroSync' | 'approvalPolicy' | 'featureUser' | 'approvalUser' | 'netsuite2' | 'intacct' | 'salesforce' | 'fasterPayment_checkOvernight' | 'fasterPayment_check2Day' | 'fasterPayment_check3Day' | 'fasterPayment_ach' | 'fasterPayment_rpps' | 'apLvl1' | 'apLvl2' | 'apLvl3' | 'arLvl1' | 'arLvl2' | 'arLvl3' | 'qbe' | 'desBill' | 'OLBUser' | 'collaboratorUser' | 'intlEPmtUSDWire' | 'intlEPmtFxWire' | 'intlEPmtFxIACH' | 'voidCheck' | 'voidCheckReturned' | 'docUpload' | 'billCreated' | 'olbUserLastLogin' | 'collaboratorLastLogin' | 'invoiceEmailed' | 'nsf' | 'lastSupportAccess' | 'amexPayment' | 'netSuiteSyncImplementation' | 'intacctSyncImplementation' | 'syncSetup' | 'hybridDataEntry' | 'vcardPayment' | 'vcardPaymentVoidReissue' | 'suaProcessedCount' | 'suaProcessedAmount' | 'suaReturnedCount' | 'suaReturnedAmount' | 'premiumSupport' | 'premiumSupportPlus' | 'apiLicenseKeyFee' | 'apiUserLicenseFee' | 'apiMaintenanceFee' | 'developerSupportFee' | 'implementation' | 'syncMigration' | 'training' | 'docsOnCD' | 'contractBilling' | 'receivedCCPaymentCount' | 'walletPmt_IntlUSD' | 'walletPmt_IntlFX' | 'implementationNetSuite' | 'implementationIntacct' | 'implementationQuickBooksEnterprise' | 'implementationMicrosoftDynamics' | 'implementationSSO' | 'cardFunded_ePayment' | 'cardFunded_check' | 'dynamicApprovals' | 'syncImplementation' | 'vCardProcessedCount' | 'vCardProcessedAmount' | 'vCardReturnedCount' | 'vCardReturnedAmount' | 'guestPay_ePayment' | 'auditorUser' | 'payByCardProcessedCount' | 'payByCardProcessedAmount' | 'payByCardChargeBackCount' | 'payByCardChargeBackAmount' | 'payByCardCheckUSCount' | 'payByCardEPaymentCount' | 'intlUSDTransactionCount' | 'intlFXTransactionCount' | 'intlFXTransactionAmount' | 'noAccessUser' | 'intlFXReturnedCount' | 'intlFXReturnedAmount' | 'fasterPayment_rtp' | 'cardFunded_intlEPmtUSDWire' | 'fasterPayment_vcard' | 'applicableTax' | 'other' — Plan charge name
    - `tier` number — Plan charge tier
    - `quantity` number — Quantity for the plan charge
    - `price` number — Plan charge

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/revisions/0483350c434e/schema)