---
title: "Get a list of fees"
method: GET
path: "/api/v2/organizations/{orgSlug}/fees"
tags: ["Fees"]
---

# Get a list of fees

`GET /api/v2/organizations/{orgSlug}/fees`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/fees`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.community.fees.read`

Retrieve a list of fees based on provided filters 

 Required scopes: `flex.community.fees.read`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `_id` string
- `company` string
- `member` string
- `location` string
- `plan` string
- `issueDate` string
- `isRefundable` boolean
- `modifiedAt` string
- `createdAt` string
- `$select` string
- `$cursorNext` string
- `$cursorPrev` string
- `$limit` number

## Response `200`

- object
  - `rangeStart` number
  - `rangeEnd` number
  - `cursorNext` string
  - `cursorPrev` string
  - `results` FeeResultDto[]
    - `properties` object: An object that contains all custom properties that can be applied to the item.
    - `_id` string: The _id of the fee.
    - `name` string: The name of the fee.
    - `price` number: The unit price of the item described by the fee.
    - `quantity` number: The quantity described by the one-off charge.
    - `company` string: The _id of the company that the fee is associated with.
    - `member` string: The _id of the member that the fee is associated with.
    - `location` string: A reference to the location the fee is issued for.
    - `plan` string: A reference to the price plan assigned to the fee. It is used to determine the sales account when generating an invoice.
    - `planType` 'Plan' | 'ResourceRate': The type of the plan assigned to the fee.
    - `issueDate` string: The date the fee was issued.
    - `status` 'approved' | 'awaiting_approval': The status of the fee.
    - `discount` string: A reference to a discount definition.
    - `discountAmount` number: Manually granted discount for the specific fee.
    - `calculatedDiscountAmount` number: The actual discount amount coming from a discount defintion or from a manually granted discount.
    - `discountedPrice` number: The final fee unit price after granting the discount.
    - `isRefundable` boolean: If true, the one-off charge is counted as deposit and can be refunded later on.
    - `isPersonal` boolean: If true, the one-off charge is billed to the assigned member and not to the company.
    - `shouldBillInAdvance` boolean: If true, the one-off charge is billed in advance (respecting its date). By default one-off charges are not billed in advance.
    - `shouldUseCoins` boolean: In order for a fee to use coins you need to set this to true. By default it's set to false.
    - `coins` FeeCoinResultDto[]: The coins used for the fee.
      - `_id` string: The _id of the coin used for the fee.
      - `count` number: The count of the coins used for the fee.
    - `payment` FeePaymentDto
      - `_id` string: The _id of the payment associated with the fee. Appears, if a fee has been invoiced
      - `status` 'not_paid' | 'invoiced' | 'paid' | 'refunded' | 'waived': The status of the fee in terms of billing.
      - `creditNote` string: The _id of the credit note associated with the fee. Appears, if a fee was credited.
    - `source` string: The source of the fee.
    - `createdAt` string, date-time: The date when the fee has been created.
    - `createdBy` string: The user that created the fee.
    - `modifiedAt` string, date-time: The user that did the last modification to the fee. If no update is made this field will match the "createdBy" field.
    - `modifiedBy` string: The user that last updated the fee.

---

[API](https://skmtc.dev/officernd/apis/community-api.md) - [All operations](https://skmtc.dev/officernd/apis/community-api/llms.txt) - [OpenAPI document](https://skmtc.dev/officernd/apis/community-api/revisions/dad1b7912165?raw)