> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get one Tariff

> Retrieve a single Tariff record by its Id.

## Authentication

<Note>
  This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
  The authenticated user must be a full unrestricted administrator or have the **`Tariff-Read`** role.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the Tariff record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/billing/tariffs/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/billing/tariffs/87654321',
    {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://spaces.nexudus.com/api/billing/tariffs/87654321',
      headers={
          'Authorization': 'Bearer YOUR_TOKEN'
      }
  )

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="BusinessId" type="integer">
  Business Id.
</ResponseField>

<ResponseField name="BusinessName" type="string">
  Business name.
</ResponseField>

<ResponseField name="Name" type="string">
  Tariff name.
</ResponseField>

<ResponseField name="SystemTariffType" type="integer">
  System tariff type. See `eTariffType` enum values: `1` = FullTimePrivateOffice, `2` = PartTimePrivateOffice, `3` = FullTimeDedicatedDesk, `4` = PartTimeDedicatedDesk, `5` = FullTimeHotDesk, `6` = PartTimeHotDesk, `7` = FullTimeOther, `8` = PartTimeOther, `9` = Storage, `10` = VirtualOffice, `11` = Virtual, `99` = Other.
</ResponseField>

<ResponseField name="Price" type="number">
  Price.
</ResponseField>

<ResponseField name="DefaultInvoicingDay" type="integer">
  Default invoicing day.
</ResponseField>

<ResponseField name="Visible" type="boolean">
  Whether the tariff is visible.
</ResponseField>

<ResponseField name="UseTimePasses" type="boolean">
  Whether to use time passes.
</ResponseField>

<ResponseField name="Description" type="string">
  Description.
</ResponseField>

<ResponseField name="InvoiceLineDisplayAs" type="string">
  Invoice line display text.
</ResponseField>

<ResponseField name="SignUpFee" type="number">
  Sign-up fee.
</ResponseField>

<ResponseField name="CurrencyId" type="integer">
  Currency Id.
</ResponseField>

<ResponseField name="CurrencyCode" type="string">
  Currency code.
</ResponseField>

<ResponseField name="TaxRateId" type="integer">
  Tax Rate Id.
</ResponseField>

<ResponseField name="ReducedTaxRateId" type="integer">
  Reduced Tax Rate Id.
</ResponseField>

<ResponseField name="ExemptTaxRateId" type="integer">
  Exempt Tax Rate Id.
</ResponseField>

<ResponseField name="FinancialAccountId" type="integer">
  Financial Account Id.
</ResponseField>

<ResponseField name="TermsAndConditions" type="string">
  Terms and conditions.
</ResponseField>

<ResponseField name="ContractDocumentFileName" type="string">
  Contract Document File Name.
</ResponseField>

<ResponseField name="NewContractDocumentUrl" type="string">
  New Contract Document Url.
</ResponseField>

<ResponseField name="ClearContractDocumentFile" type="boolean">
  Clear Contract Document File.
</ResponseField>

<ResponseField name="CancellationPeriod" type="integer">
  Cancellation period in days.
</ResponseField>

<ResponseField name="DisplayOrder" type="integer">
  Display order.
</ResponseField>

<ResponseField name="GroupName" type="string">
  Group name.
</ResponseField>

<ResponseField name="DisablePortalCancellations" type="boolean">
  Disable portal cancellations.
</ResponseField>

<ResponseField name="SubscribersLimit" type="integer">
  Subscribers limit.
</ResponseField>

<ResponseField name="CancellationLimitDays" type="integer">
  Cancellation limit in days.
</ResponseField>

<ResponseField name="DefaultContractTerm" type="integer">
  Default contract term in months.
</ResponseField>

<ResponseField name="CancelMemeberAccountAfter" type="integer">
  Cancel member account after days.
</ResponseField>

<ResponseField name="CheckinPricePlanLimit" type="integer">
  Check-in price plan limit.
</ResponseField>

<ResponseField name="CheckinMonthLimit" type="integer">
  Check-in month limit.
</ResponseField>

<ResponseField name="CheckinWeekLimit" type="integer">
  Check-in week limit.
</ResponseField>

<ResponseField name="VisitorMonthLimit" type="integer">
  Visitor month limit.
</ResponseField>

<ResponseField name="VisitorWeekLimit" type="integer">
  Visitor week limit.
</ResponseField>

<ResponseField name="VisitorDayLimit" type="integer">
  Visitor day limit.
</ResponseField>

<ResponseField name="HoursPricePlanLimit" type="integer">
  Hours price plan limit.
</ResponseField>

<ResponseField name="HoursMonthLimit" type="integer">
  Hours month limit.
</ResponseField>

<ResponseField name="HoursWeekLimit" type="integer">
  Hours week limit.
</ResponseField>

<ResponseField name="BookingMinuteWeekLimit" type="integer">
  Booking minute week limit.
</ResponseField>

<ResponseField name="BookingMinuteMonthLimit" type="integer">
  Booking minute month limit.
</ResponseField>

<ResponseField name="DiscountExtraServices" type="number">
  Discount percentage for extra services.
</ResponseField>

<ResponseField name="DiscountTimePasses" type="number">
  Discount percentage for time passes.
</ResponseField>

<ResponseField name="DiscountCharges" type="number">
  Discount percentage for charges.
</ResponseField>

<ResponseField name="InvoiceEvery" type="integer">
  Invoice every N months.
</ResponseField>

<ResponseField name="InvoiceEveryWeeks" type="integer">
  Invoice every N weeks.
</ResponseField>

<ResponseField name="AutoCancelAfter" type="integer">
  Auto cancel after days.
</ResponseField>

<ResponseField name="AdvanceInvoiceCycles" type="integer">
  Advance invoice cycles.
</ResponseField>

<ResponseField name="ProrateDayOfMonth" type="integer">
  Prorate day of month.
</ResponseField>

<ResponseField name="ProrateDaysBefore" type="integer">
  Prorate days before.
</ResponseField>

<ResponseField name="ProrateCancellations" type="boolean">
  Prorate cancellations.
</ResponseField>

<ResponseField name="ChargeAndExtend" type="integer">
  Charge and extend days.
</ResponseField>

<ResponseField name="ExcludeFromInvoice" type="boolean">
  Exclude From Invoice.
</ResponseField>

<ResponseField name="AutoRaiseInvoices" type="boolean">
  Auto raise invoices.
</ResponseField>

<ResponseField name="RaiseInvoiceEvery" type="integer">
  Raise invoice every N months.
</ResponseField>

<ResponseField name="RaiseInvoiceEveryWeeks" type="integer">
  Raise invoice every N weeks.
</ResponseField>

<ResponseField name="MinimumPrice" type="number">
  Minimum price.
</ResponseField>

<ResponseField name="MinimumPriceIncludeTimePasses" type="boolean">
  Include time passes in minimum price.
</ResponseField>

<ResponseField name="MinimumPriceIncludeExtraServices" type="boolean">
  Include extra services in minimum price.
</ResponseField>

<ResponseField name="MinimumPriceIncludeEvents" type="boolean">
  Include events in minimum price.
</ResponseField>

<ResponseField name="Archived" type="boolean">
  Whether the tariff is archived.
</ResponseField>

<ResponseField name="Starred" type="boolean">
  Whether the tariff is starred.
</ResponseField>

<ResponseField name="KeepNewAccountsOnHold" type="boolean">
  Keep new accounts on hold.
</ResponseField>

<ResponseField name="CanBePaused" type="boolean">
  Whether the tariff can be paused.
</ResponseField>

<ResponseField name="PauseYearlyLimit" type="integer">
  Pause yearly limit.
</ResponseField>

<ResponseField name="PauseCyclesLimit" type="integer">
  Pause cycles limit.
</ResponseField>

<ResponseField name="BookingDueDateStrategy" type="integer">
  Booking due date strategy. See `eTariffBookingDueDateStrategy` enum values: `1` = RenewalDate, `2` = BookingEndDate, `3` = BookingCreationDate, `4` = NextNthOfMonth.
</ResponseField>

<ResponseField name="BookingDueDateDayOfMonth" type="integer">
  Booking due date day of month.
</ResponseField>

<ResponseField name="TotalSignUpPrice" type="number">
  Total sign-up price.
</ResponseField>

<ResponseField name="TotalPrice" type="number">
  Total price.
</ResponseField>

<ResponseField name="IsVirtualOffice" type="boolean">
  Whether this is a virtual office tariff.
</ResponseField>

<ResponseField name="RequestAddressIdentityCheck" type="boolean">
  Request address identity check.
</ResponseField>

<ResponseField name="AddressIdentityCheckDescription" type="string">
  Address identity check description.
</ResponseField>

<ResponseField name="AddressIdentityCheckProvider" type="integer">
  Address identity check provider. See `eIdentityCheckProvider` enum values: `1` = Manual, `2` = StripeIdentity.
</ResponseField>

<ResponseField name="KeepPausedIfAddressMismatch" type="boolean">
  Keep paused if address mismatch.
</ResponseField>

<ResponseField name="AddressIdentityCheckRepeatPattern" type="integer">
  Address identity check repeat pattern. See `eIdentityCheckRepeatPattern` enum values: `1` = Never, `2` = Every3Months, `3` = Every6Months, `4` = Every12Months, `5` = Every24Months.
</ResponseField>

<ResponseField name="RequestIdentityCheck" type="boolean">
  Request identity check.
</ResponseField>

<ResponseField name="IdentityCheckProvider" type="integer">
  Identity check provider. See `eIdentityCheckProvider` enum values: `1` = Manual, `2` = StripeIdentity.
</ResponseField>

<ResponseField name="IdentityCheckRepeatPattern" type="integer">
  Identity check repeat pattern. See `eIdentityCheckRepeatPattern` enum values: `1` = Never, `2` = Every3Months, `3` = Every6Months, `4` = Every12Months, `5` = Every24Months.
</ResponseField>

<ResponseField name="IdentityCheckDescription" type="string">
  Identity check description.
</ResponseField>

<ResponseField name="SendOnBoardingFormByEmail" type="boolean">
  Send onboarding form by email.
</ResponseField>

<ResponseField name="FormPageId" type="integer">
  Form Page Id.
</ResponseField>

<ResponseField name="FormPageName" type="string">
  Form page name.
</ResponseField>

<ResponseField name="ProductsStore" type="integer[]">
  Products Store.
</ResponseField>

<ResponseField name="ProductsForward" type="integer[]">
  Products Forward.
</ResponseField>

<ResponseField name="ProductsRecycle" type="integer[]">
  Products Recycle.
</ResponseField>

<ResponseField name="ProductsShred" type="integer[]">
  Products Shred.
</ResponseField>

<ResponseField name="ProductsScan" type="integer[]">
  Products Scan.
</ResponseField>

<ResponseField name="ProductsReturn" type="integer[]">
  Products Return.
</ResponseField>

<ResponseField name="ProductsDeposit" type="integer[]">
  Products Deposit.
</ResponseField>

<ResponseField name="ProductsCollect" type="integer[]">
  Products Collect.
</ResponseField>

<ResponseField name="DeliveryPreferencesMail" type="string">
  Delivery preferences for mail.
</ResponseField>

<ResponseField name="DeliveryPreferencesParcels" type="string">
  Delivery preferences for parcels.
</ResponseField>

<ResponseField name="DeliveryPreferencesChecks" type="string">
  Delivery preferences for checks.
</ResponseField>

<ResponseField name="DeliveryPreferencesPublicity" type="string">
  Delivery preferences for publicity.
</ResponseField>

<ResponseField name="DeliveryPreferencesOther" type="string">
  Delivery preferences for other.
</ResponseField>

<ResponseField name="MaximumDeliveryStorageDays" type="integer">
  Maximum delivery storage days.
</ResponseField>

<ResponseField name="MaximumCompanyAliases" type="integer">
  Maximum company aliases.
</ResponseField>

<ResponseField name="MaximumRecipients" type="integer">
  Maximum recipients.
</ResponseField>

<ResponseField name="MaximumAddresses" type="integer">
  Maximum addresses.
</ResponseField>

<ResponseField name="TransferProductsToContract" type="boolean">
  Transfer products to contract.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "BusinessId": 0,
  "BusinessName": null,
  "Name": "",
  "SystemTariffType": 0,
  "Price": 0,
  "DefaultInvoicingDay": null,
  "Visible": false,
  "UseTimePasses": false,
  "Description": null,
  "InvoiceLineDisplayAs": null,
  "SignUpFee": null,
  "CurrencyId": 0,
  "CurrencyCode": null,
  "TaxRateId": null,
  "ReducedTaxRateId": null,
  "ExemptTaxRateId": null,
  "FinancialAccountId": null,
  "TermsAndConditions": null,
  "ContractDocumentFileName": null,
  "NewContractDocumentUrl": null,
  "ClearContractDocumentFile": null,
  "CancellationPeriod": 0,
  "DisplayOrder": 0,
  "GroupName": null,
  "DisablePortalCancellations": false,
  "SubscribersLimit": null,
  "CancellationLimitDays": null,
  "DefaultContractTerm": null,
  "CancelMemeberAccountAfter": null,
  "CheckinPricePlanLimit": null,
  "CheckinMonthLimit": null,
  "CheckinWeekLimit": null,
  "VisitorMonthLimit": null,
  "VisitorWeekLimit": null,
  "VisitorDayLimit": null,
  "HoursPricePlanLimit": null,
  "HoursMonthLimit": null,
  "HoursWeekLimit": null,
  "BookingMinuteWeekLimit": null,
  "BookingMinuteMonthLimit": null,
  "DiscountExtraServices": null,
  "DiscountTimePasses": null,
  "DiscountCharges": null,
  "InvoiceEvery": 0,
  "InvoiceEveryWeeks": 0,
  "AutoCancelAfter": null,
  "AdvanceInvoiceCycles": null,
  "ProrateDayOfMonth": null,
  "ProrateDaysBefore": null,
  "ProrateCancellations": false,
  "ChargeAndExtend": null,
  "ExcludeFromInvoice": null,
  "AutoRaiseInvoices": false,
  "RaiseInvoiceEvery": null,
  "RaiseInvoiceEveryWeeks": null,
  "MinimumPrice": null,
  "MinimumPriceIncludeTimePasses": false,
  "MinimumPriceIncludeExtraServices": false,
  "MinimumPriceIncludeEvents": false,
  "Archived": false,
  "Starred": false,
  "KeepNewAccountsOnHold": false,
  "CanBePaused": false,
  "PauseYearlyLimit": null,
  "PauseCyclesLimit": null,
  "BookingDueDateStrategy": 0,
  "BookingDueDateDayOfMonth": null,
  "TotalSignUpPrice": 0,
  "TotalPrice": 0,
  "IsVirtualOffice": false,
  "RequestAddressIdentityCheck": false,
  "AddressIdentityCheckDescription": null,
  "AddressIdentityCheckProvider": 0,
  "KeepPausedIfAddressMismatch": false,
  "AddressIdentityCheckRepeatPattern": 0,
  "RequestIdentityCheck": false,
  "IdentityCheckProvider": 0,
  "IdentityCheckRepeatPattern": 0,
  "IdentityCheckDescription": null,
  "SendOnBoardingFormByEmail": false,
  "FormPageId": null,
  "FormPageName": null,
  "ProductsStore": [],
  "ProductsForward": [],
  "ProductsRecycle": [],
  "ProductsShred": [],
  "ProductsScan": [],
  "ProductsReturn": [],
  "ProductsDeposit": [],
  "ProductsCollect": [],
  "DeliveryPreferencesMail": null,
  "DeliveryPreferencesParcels": null,
  "DeliveryPreferencesChecks": null,
  "DeliveryPreferencesPublicity": null,
  "DeliveryPreferencesOther": null,
  "MaximumDeliveryStorageDays": null,
  "MaximumCompanyAliases": null,
  "MaximumRecipients": null,
  "MaximumAddresses": null,
  "TransferProductsToContract": false,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "Tariff Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```