---
updatedAt: 2026-04-27T16:03:58.000Z
agentTools:
  siteIndex: https://developers.pismo.io/llms.txt
  projectIndex: https://developers.pismo.io/pismo-docs/llms.txt
---

# Configure minimum value by accrual type

Configure a minimum value for an accrual type. At cycle closing, if the calculated value for an accrual of that type is lower that the configured minimum value, the minimum value is used instead.

This is an immutable configuration. So, to override a previous configuration, you have to create a new configuration for the same level in the hierarchy. The old configuration is maintained to track the changes, but it's not used.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Revolving credit - Interest accruals",
    "version": "2.74.0",
    "description": "Endpoints to manage accruals in the credit card cycle.",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io/credit-cycle-interest-accruals",
      "description": "Sandbox API server for testing"
    }
  ],
  "tags": [
    {
      "name": "Accrual types minimum value",
      "description": "Endpoints for setting minimum values of accrual types"
    }
  ],
  "components": {
    "schemas": {
      "AccrualType": {
        "type": "string",
        "description": "Accrual type. Should be one of the following values:\n  `REFINANCING`\n  `OVERDUE`\n  `WITHDRAWAL_INTEREST`\n  `BILLPAYMENT_INTEREST`\n  `OVERDRAFT_INTEREST`\n  `FINANCIAL_TAX`\n",
        "maxLength": 20,
        "example": "REFINANCING"
      },
      "AccrualTypeMinimumValueRequest": {
        "type": "object",
        "properties": {
          "accrual_type": {
            "$ref": "#/components/schemas/AccrualType"
          },
          "hierarchy_name": {
            "$ref": "#/components/schemas/HierarchyName"
          },
          "hierarchy_value": {
            "$ref": "#/components/schemas/HierarchyValue"
          },
          "minimum_amount_to_post": {
            "$ref": "#/components/schemas/MinimumAmountToPost"
          }
        },
        "required": [
          "accrual_type",
          "hierarchy_name",
          "hierarchy_value",
          "minimum_amount_to_post"
        ]
      },
      "AccrualTypeMinimumValueResponse": {
        "type": "object",
        "properties": {
          "accrual_type": {
            "$ref": "#/components/schemas/AccrualType"
          },
          "hierarchy_name": {
            "$ref": "#/components/schemas/HierarchyName"
          },
          "hierarchy_value": {
            "$ref": "#/components/schemas/HierarchyValue"
          },
          "minimum_amount_to_post": {
            "$ref": "#/components/schemas/MinimumAmountToPost"
          }
        },
        "required": [
          "accrual_type",
          "hierarchy_name",
          "hierarchy_value",
          "minimum_amount_to_post"
        ]
      },
      "HierarchyName": {
        "type": "string",
        "enum": [
          "ORG_ID",
          "PROGRAM_ID",
          "ACCOUNT_ID"
        ],
        "example": "ACCOUNT_ID"
      },
      "HierarchyValue": {
        "type": "string",
        "description": "If `hierarchy_name` is `PROGRAM_ID` or `ACCOUNT_ID`, the hierarchy value must be an integer. If `hierarchy_name` is `ORG_ID`, the value must be a string.",
        "example": "123456789"
      },
      "MinimumAmountToPost": {
        "type": "number",
        "format": "double",
        "example": 100.23
      },
      "StandardErrorResponse": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "example": "1020030"
          },
          "message": {
            "type": "string",
            "example": "Error message"
          }
        }
      }
    },
    "responses": {
      "500InternalServerError": {
        "description": "Internal Server Error",
        "content": {
          "application/json": {
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/StandardErrorResponse"
                }
              ]
            },
            "examples": {
              "Internal Server Error": {
                "description": "Service is unavailable",
                "value": {
                  "code": "GN0001",
                  "message": "Service is unavailable"
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "paths": {
    "/v1/accrual-type-minimum-value": {
      "post": {
        "summary": "Configure minimum value by accrual type",
        "description": "Configure a minimum value for an accrual type. At cycle closing, if the calculated value for an accrual of that type is lower that the configured minimum value, the minimum value is used instead.\n\nThis is an immutable configuration. So, to override a previous configuration, you have to create a new configuration for the same level in the hierarchy. The old configuration is maintained to track the changes, but it's not used.\n",
        "operationId": "postAccrualTypeMinimumValue",
        "tags": [
          "Accrual types minimum value"
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccrualTypeMinimumValueRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccrualTypeMinimumValueResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandardErrorResponse"
                },
                "examples": {
                  "Missing request header or param": {
                    "description": "accrual_statuses",
                    "value": {
                      "code": "EX0001",
                      "message": "The header {HeaderName} is required | The property {PropertyName} is required."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    }
  }
}
```