Get Commissions

GET /v1/transactions/{transactionId}/tiers/{tierId}/commissions

Retrieves the list of commissions for a specific transaction and tier. This will only return the list of commissions to which you have access. It may not be the full list of commissions associated with the transaction.

Path parameters

  • transactionId string(uuid) Required

    The id of the transaction.

  • tierId string(uuid) Required

    The id of the tier.

Responses

  • 200 application/json

    Request succeeded.

    Hide response attributes Show response attributes object
    • id string(uuid)

      The unique id.

    • createdTimestamp string(date-time) | null

      The date and time of creation in UTC time.

    • modifiedTimestamp string(date-time) | null

      The date and time last modification in UTC time.

    • agentId string(uuid) Required

      The unique id of the agent that gets the commission.

    • officeId string(uuid)

      The unique id of the office with which the agent is associated.

    • amount number(currency)

      The total commission amount the agent is receiving. This includes any fees that were subtracted.

    • percentage number(double)

      The percentage of the total commission for the agent. This will be specified as a decimal. For example, 5% will be specified as 0.05.

    • endCode string Required

      The code representing the end or side of the transaction.

      Values are B or S.

    • endCount number(double) Required

      The total number of ends or sides this commission represents.

      Minimum value is 0, maximum value is 2.

    • calculationMethodCode string | null

      The code representing the calculation method used for the commission. This will be "A" for amount or "P" for percentage.

      Values are A or P.

    • taxAmount number(currency)

      The total amount in tax applied to the commission.

    • totalFeeAmount number(currency)

      The total amount of fees applied to the commission.

    • totalFeeTaxAmount number(currency)

      The total amount in tax applied to just the fees for the commission.

    • fees array[object] | null

      The list of fees associated with the commission.

      Represents a fee that is related to a commission.

      Hide fees attributes Show fees attributes object
      • id string(uuid)

        The unique id.

      • createdTimestamp string(date-time) | null

        The date and time of creation in UTC time.

      • modifiedTimestamp string(date-time) | null

        The date and time last modification in UTC time.

      • percentage number(double)

        The percentage of the commission. This will be specified as a decimal. For example, 5% will be specified as 0.05.

      • amount number(currency)

        The amount of the fee.

      • calculationMethodCode string | null

        The code for the method used to calculate the fee.

        Values are A or P.

      • taxAmount number(currency)

        The amount of tax applied to the fee.

      • taxPercentage number(double)

        The tax rate applied to the fee. This will be specified as a decimal. For example, 5% will be specified as 0.05.

      • paymentMethodCode string | null

        The code for the method used to pay the fee.

      • fee object

        A read only representation of a fee associated with a transaction.

        Additional properties are NOT allowed.

        Hide fee attributes Show fee attributes object
        • shortName string | null

          The short name of the fee.

        • name string | null

          The name of the fee.

    • agent object

      A read only representation of an agent.

      Additional properties are NOT allowed.

      Hide agent attributes Show agent attributes object
      • firstName string | null

        The first name of the agent.

      • middleName string | null

        The middle name of the agent.

      • lastName string | null

        The last name of the agent.

    • office object

      A read only representation of an office.

      Additional properties are NOT allowed.

      Hide office attributes Show office attributes object
      • name string | null

        The name of the office.

      • code string | null

        The code for the office.

  • 400 application/json

    Invalid request. See response body for details.

    Hide response attributes Show response attributes object
    • id string

      The unique identifier for the error.

    • code integer(int32)

      A code used to help identify the type of error. This is typically set to the same value as the http status code.

    • message string

      A summary or short message describing the error.

    • details array[string] | null

      A list of more detailed errors messages.

  • 401 application/json

    Unauthorized. See response body for details.

    Hide response attributes Show response attributes object
    • id string

      The unique identifier for the error.

    • code integer(int32)

      A code used to help identify the type of error. This is typically set to the same value as the http status code.

    • message string

      A summary or short message describing the error.

    • details array[string] | null

      A list of more detailed errors messages.

  • 403 application/json

    Permission denied. See response body for details.

    Hide response attributes Show response attributes object
    • id string

      The unique identifier for the error.

    • code integer(int32)

      A code used to help identify the type of error. This is typically set to the same value as the http status code.

    • message string

      A summary or short message describing the error.

    • details array[string] | null

      A list of more detailed errors messages.

  • 404 application/json

    Not found. See response body for details.

    Hide response attributes Show response attributes object
    • id string

      The unique identifier for the error.

    • code integer(int32)

      A code used to help identify the type of error. This is typically set to the same value as the http status code.

    • message string

      A summary or short message describing the error.

    • details array[string] | null

      A list of more detailed errors messages.

GET /v1/transactions/{transactionId}/tiers/{tierId}/commissions
curl \
 --request GET 'https://api.lwolf.com/backoffice/v1/transactions/{transactionId}/tiers/{tierId}/commissions'
Response examples (200)
[
  {
    "id": "string",
    "fees": [
      {
        "id": "string",
        "fee": {
          "name": "string",
          "shortName": "string"
        },
        "amount": 0,
        "taxAmount": 0,
        "percentage": 0,
        "taxPercentage": 0,
        "createdTimestamp": "string",
        "modifiedTimestamp": "string",
        "paymentMethodCode": "string",
        "calculationMethodCode": "A"
      }
    ],
    "agent": {
      "lastName": "string",
      "firstName": "string",
      "middleName": "string"
    },
    "amount": 0,
    "office": {
      "code": "string",
      "name": "string"
    },
    "agentId": "string",
    "endCode": "B",
    "endCount": 0,
    "officeId": "string",
    "taxAmount": 0,
    "percentage": 0,
    "totalFeeAmount": 0,
    "createdTimestamp": "string",
    "modifiedTimestamp": "string",
    "totalFeeTaxAmount": 0,
    "calculationMethodCode": "A"
  }
]
Response examples (400)
{
  "id": "string",
  "code": 0,
  "details": [
    "string"
  ],
  "message": "string"
}
Response examples (401)
{
  "id": "string",
  "code": 0,
  "details": [
    "string"
  ],
  "message": "string"
}
Response examples (403)
{
  "id": "string",
  "code": 0,
  "details": [
    "string"
  ],
  "message": "string"
}
Response examples (404)
{
  "id": "string",
  "code": 0,
  "details": [
    "string"
  ],
  "message": "string"
}