--- title: "Retrieve OrganizationConfig" method: GET path: "/organizations/{orgId}/organizationconfig" tags: ["OrganizationConfig"] --- # Retrieve OrganizationConfig `GET /organizations/{orgId}/organizationconfig` Retrieve the Organization-wide configuration details. ## Path parameters - `orgId` string, required ## Response `200` Return the Organization configuration - OrganizationConfigResponse - `id` string, required — The UUID of the entity. - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response. - `timezone` string — The timezone for the Organization. - `yearEpoch` string — The first bill date *(in ISO-8601 format)* for yearly billing periods. - `monthEpoch` string — The first bill date *(in ISO-8601 format)* for monthly billing periods. - `weekEpoch` string — The first bill date *(in ISO-8601 format)* for weekly billing periods. - `dayEpoch` string — The first bill date *(in ISO-8601 format)* for daily billing periods. - `currency` string — The currency code for the currency used in this Organization. For example: USD, GBP, or EUR. - `currencyConversions` CurrencyConversion[] — Currency conversion rates from Bill currency to Organization currency. For example, if Account is billed in GBP and Organization is set to USD, Bill line items are calculated in GBP and then converted to USD using the defined rate. - `from` string, required — Currency to convert from. For example: GBP. - `to` string, required — Currency to convert to. For example: USD. - `multiplier` number, double — Conversion rate between currencies. - `daysBeforeBillDue` integer — The number of days after the Bill generation date shown on Bills as the due date. - `scheduledBillInterval` number, double — Specifies the required interval for updating bills. * **For portions of an hour (minutes)**. Two options: **0.25** (15 minutes) and **0.5** (30 minutes). * **For full hours.** Eight possible values: **1**, **2**, **3**, **4**, **6**, **8**, **12**, or **24**. * **Default.** The default is **0**, which disables scheduling. - `standingChargeBillInAdvance` boolean — Specifies whether the standing charge is billed in advance at the start of each billing period, or billed in arrears at the end of each billing period. * **TRUE** - bill in advance *(start of each billing period)*. * **FALSE** - bill in arrears *(end of each billing period)*. - `commitmentFeeBillInAdvance` boolean — Specifies whether commitments *(prepayments)* are billed in advance at the start of each billing period, or billed in arrears at the end of each billing period. * **TRUE** - bill in advance *(start of each billing period)*. * **FALSE** - bill in arrears *(end of each billing period)*. - `minimumSpendBillInAdvance` boolean — Specifies whether minimum spend amounts are billed in advance at the start of each billing period, or billed in arrears at the end of each billing period. * **TRUE** - bill in advance *(start of each billing period)*. * **FALSE** - bill in arrears *(end of each billing period)*. - `autoApproveBillsGracePeriod` integer — Grace period before bills are auto-approved. Used in combination with the field `autoApproveBillsGracePeriodUnit`. - `autoApproveBillsGracePeriodUnit` 'MINUTES' | 'HOURS' | 'DAYS' — Time unit of grace period before bills are auto-approved. Used in combination with the field `autoApproveBillsGracePeriod`. - `externalInvoiceDate` 'LAST_DAY_OF_ARREARS' | 'FIRST_DAY_OF_NEXT_PERIOD' — The date to use for the invoice date. - `suppressedEmptyBills` boolean — Specifies whether to supress generating bills that have no line items. * **TRUE** - prevents generating bills with no line items. * **FALSE** - bills are still generated even when they have no line items. - `consolidateBills` boolean — Specifies whether to consolidate different billing frequencies onto the same bill. * **TRUE** - consolidate different billing frequencies onto the same bill. * **FALSE** - bills are not consolidated. - `defaultStatementDefinitionId` string — Organization level default `statementDefinitionId` to be used when there is no statement definition linked to the account. Statement definitions are used to generate bill statements, which are informative backing sheets to invoices. - `billPrefix` string — Prefix to be used for sequential invoice numbers. This will be combined with the `sequenceStartNumber`. - `sequenceStartNumber` integer — The starting number to be used for sequential invoice numbers. This will be combined with the `billPrefix`. - `autoGenerateStatementMode` 'NONE' | 'JSON' | 'JSON_AND_CSV' — Specify whether to auto-generate statements once Bills are *approved* or *locked*. It will not auto-generate if a bill is in *pending* state. The default value is **None**. - **None**. Statements will not be auto-generated. - **JSON**. Statements are auto-generated in JSON format. - **JSON and CSV**. Statements are auto-generated in both JSON and CSV formats. - `creditApplicationOrder` BillCreditType[] — The order in which any Prepayment or Balance credit amounts on Accounts are to be drawn-down against for billing. Four options: - `"PREPAYMENT","BALANCE"`. Draw-down against Prepayment credit before Balance credit. - `"BALANCE","PREPAYMENT"`. Draw-down against Balance credit before Prepayment credit. - `"PREPAYMENT"`. Only draw-down against Prepayment credit. - `"BALANCE"`. Only draw-down against Balance credit. - `allowNegativeBalances` boolean — Allow balance amounts to fall below zero. This feature is enabled on request. Please get in touch with m3ter Support or your m3ter contact if you would like it enabling for your organization(s). - `allowOverlappingPlans` boolean — Allows plans to overlap time periods for different contracts. - `dtCreated` string, date-time — The DateTime when the organization config was created *(in ISO-8601 format)*. - `dtLastModified` string, date-time — The DateTime when the organization config was last modified *(in ISO-8601 format)*. - `createdBy` string — The id of the user who created this organization config. - `lastModifiedBy` string — The id of the user who last modified this organization config. ## Other responses - `4XX` — Error message - `5XX` — Error message --- [API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)