Loans
Loans provides users with access to loans for purchasing farming inputs, expanding operations, or improving infrastructure.
1. Request a Farm Loan
Endpoint
POST /v1/financial-services/loans/request
Description
Submits a loan application for a farmer.
Request Body
| Field | Type | Description |
|---|---|---|
userId | string | The ID of the farmer applying for the loan. |
loanAmount | number | The amount of the loan requested. |
loanPurpose | string | The purpose of the loan (e.g., purchasing seeds, equipment). |
Responses
| Status | Description |
|---|---|
| 201 Created | Loan application submitted successfully. |
| 400 Bad Request | Invalid data in request. |
Example Request
curl -X POST "https://api.growforme.com/v1/financial-services/loans/request" \
-H "Content-Type: application/json" \
-H "X-API-Key: your_api_key" \
-d '{
"userId": "farmer123",
"loanAmount": 20000,
"loanPurpose": "purchase equipment"
}