# Get a list of available commission agents

Endpoint: GET /commission-agents
Version: 1.44
Security: bearerAuth

## Query parameters:

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

  - `name` (string)
    Filter by name
    Example: "xyz | in:x,y | like:xyz"

  - `type` (string)
    Filter by type
    Example: "xyz | in:x,y | like:xyz"

## Response 200 fields (application/json):

  - `id` (integer)
    Internal identifier of commission agent
    Example: 1

  - `name` (string, required)
    Name of the commission agent

  - `contractOwnerId` (integer)
    Contract Owner identifier
    Example: 1

  - `accountNumber` (string)
    Account number of the commission agent

  - `accountsReference` (string)
    Accounts reference of the commission agent

  - `vatRegNumber` (string)
    Vat registration number of the commission agent

  - `address` (object, required)

  - `address.id` (integer)
    Internal identifier for address entry
    Example: 1

  - `address.businessName` (string)
    Business name

  - `address.address1` (string, required)
    Address line 1

  - `address.address2` (string)
    Address line 2

  - `address.address3` (string)
    Address line 3

  - `address.town` (string, required)
    Town

  - `address.county` (string)
    County

  - `address.postcode` (string, required)
    Postcode

  - `address.country` (string, required)
    ISO 3166 alpha-2 code representing country
    Example: "GB"

  - `companyNumber` (string, required)
    Company number of the commission agent

  - `type` (string, required)
    Commission Agent Type
    Enum: "INTERNAL", "EXTERNAL"

  - `parentAgentCommissionId` (integer)
    Internal identifier of the parent commission agent
    Example: 1

  - `availableFromDate` (string, required)
    Commission agent start date

  - `availableToDate` (string)
    Commission agent end date

  - `usageCommissionPaidOn` (string)
    Commission to be paid on
    Enum: "PROFIT", "TURNOVER"

  - `usageCommissionPercentage` (number)
    Usage commission percentage

  - `rentalCommissionPaidOn` (string)
    Commission to be paid on
    Enum: "PROFIT", "TURNOVER"

  - `rentalCommissionPercentage` (number)
    Rental commission percentage

  - `adhocCommissionPaidOn` (string)
    Commission to be paid on
    Enum: "PROFIT", "TURNOVER"

  - `adhocCommissionPercentage` (number)
    Adhoc commission percentage

  - `paymentTermsInDays` (integer)
    Payment terms in days

  - `paymentMethod` (string)
    Payment method
    Enum: "CHEQUE", "DIRECT_DEBIT", "CANCELLED_DD", "CANCELLED_CARD", "CREDIT_CARD", "PAYPAL", "BACS", "POST_OFFICE_PAYMENT_CARD", "EZYPAY", "GO_CARDLESS", "GC_INSTANT_BANK_PAYMENTS", "STRIPE", "STRIPE_CARD", "STRIPE_DD", "FINASTRA", "FAST_PAY", "OTHER"


## Response 400 fields

## Response 401 fields

## Response 500 fields