Azeez Muibi
127 lines
3.1 KiB
JSON
127 lines
3.1 KiB
JSON
{
|
|
"get": {
|
|
"tags": ["Loan Charges"],
|
|
"summary": "Get all loan charges with optional filtering",
|
|
"description": "Retrieve loan charges with various filter options including loan ID, charge code, etc.",
|
|
"operationId": "getLoanCharges",
|
|
"parameters": [
|
|
{
|
|
"name": "loan_id",
|
|
"in": "query",
|
|
"description": "Filter by loan ID",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer"
|
|
},
|
|
"example": 7463
|
|
},
|
|
{
|
|
"name": "transaction_id",
|
|
"in": "query",
|
|
"description": "Filter by transaction ID",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"example": "TRX789"
|
|
},
|
|
{
|
|
"name": "code",
|
|
"in": "query",
|
|
"description": "Filter by charge code",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string"
|
|
},
|
|
"example": "INTEREST"
|
|
},
|
|
{
|
|
"name": "start_date",
|
|
"in": "query",
|
|
"description": "Filter by start date (ISO format)",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
},
|
|
"example": "2023-01-01T00:00:00Z"
|
|
},
|
|
{
|
|
"name": "end_date",
|
|
"in": "query",
|
|
"description": "Filter by end date (ISO format)",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
},
|
|
"example": "2023-12-31T23:59:59Z"
|
|
},
|
|
{
|
|
"name": "due_before",
|
|
"in": "query",
|
|
"description": "Filter charges due before this date (ISO format)",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
},
|
|
"example": "2023-12-31T23:59:59Z"
|
|
},
|
|
{
|
|
"name": "due_after",
|
|
"in": "query",
|
|
"description": "Filter charges due after this date (ISO format)",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "string",
|
|
"format": "date-time"
|
|
},
|
|
"example": "2023-01-01T00:00:00Z"
|
|
},
|
|
{
|
|
"name": "page",
|
|
"in": "query",
|
|
"description": "Page number for pagination",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"default": 1,
|
|
"minimum": 1
|
|
},
|
|
"example": 1
|
|
},
|
|
{
|
|
"name": "limit",
|
|
"in": "query",
|
|
"description": "Number of items per page (max 100)",
|
|
"required": false,
|
|
"schema": {
|
|
"type": "integer",
|
|
"default": 20,
|
|
"minimum": 1,
|
|
"maximum": 100
|
|
},
|
|
"example": 20
|
|
}
|
|
],
|
|
"responses": {
|
|
"200": {
|
|
"description": "Successful operation",
|
|
"content": {
|
|
"application/json": {
|
|
"schema": {
|
|
"$ref": "../schemas/LoanChargesResponse.json"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"400": {
|
|
"description": "Invalid request"
|
|
},
|
|
"500": {
|
|
"description": "Internal server error"
|
|
}
|
|
}
|
|
}
|
|
} |