360 Evaluation Engine

Farmer360 — Crop

POST https://credit.farmsky.africa/api/v1/farmer360/crop

Score a crop farmer: CRB 25% · Agro-Ecological 25% · Cash Flow 25% · Market 25% → 1000 pts.

credit:write

Headers

Authorization string required Defaults to Bearer {CLIENT_ID}:{CLIENT_SECRET}

Your API client id and secret, joined by a colon. Manage credentials in the Console.

x-api-key string optional Defaults to {API_KEY}

Alternative single-value secret key header (equivalent to X-Api-Secret). Never expose it in client-side code.

Content-Type string required Defaults to application/json

All request bodies are JSON unless the endpoint accepts multipart/form-data (file uploads).

Body Params

farmer_identity object required

national_id + names.

farm_details object required

GPS, crop type, planting date, cycle length, irrigation.

financial_data object required

Statement type + uploaded statement file id.

API Request Examples

curl --request POST \
  --url https://credit.farmsky.africa/api/v1/farmer360/crop \
  --header 'Authorization: Bearer {CLIENT_ID}:{CLIENT_SECRET}' \
  --header 'x-api-key: {API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{"farmer_identity":{"national_id":"31234567","first_name":"Jane","last_name":"Wanjiku"},"farm_details":{"latitude":-0.2827,"longitude":36.0662,"crop_type":"MAIZE","planting_date":"2026-03-14","crop_cycle_days":120,"has_irrigation":false},"financial_data":{"statement_type":"mpesa","statement_file_id":"file_abc123"}}'

const res = await fetch('https://credit.farmsky.africa/api/v1/farmer360/crop', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {CLIENT_ID}:{CLIENT_SECRET}',
    'x-api-key': '{API_KEY}',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "farmer_identity": {
      "national_id": "31234567",
      "first_name": "Jane",
      "last_name": "Wanjiku"
    },
    "farm_details": {
      "latitude": -0.2827,
      "longitude": 36.0662,
      "crop_type": "MAIZE",
      "planting_date": "2026-03-14",
      "crop_cycle_days": 120,
      "has_irrigation": false
    },
    "financial_data": {
      "statement_type": "mpesa",
      "statement_file_id": "file_abc123"
    }
  }),
});
const data = await res.json();
console.log(data);

import requests

url = "https://credit.farmsky.africa/api/v1/farmer360/crop"
headers = {
    "Authorization": "Bearer {CLIENT_ID}:{CLIENT_SECRET}",
    "x-api-key": "{API_KEY}",
    "Content-Type": "application/json",
}
payload = {
    "farmer_identity": {
        "national_id": "31234567",
        "first_name": "Jane",
        "last_name": "Wanjiku"
    },
    "farm_details": {
        "latitude": -0.2827,
        "longitude": 36.0662,
        "crop_type": "MAIZE",
        "planting_date": "2026-03-14",
        "crop_cycle_days": 120,
        "has_irrigation": False
    },
    "financial_data": {
        "statement_type": "mpesa",
        "statement_file_id": "file_abc123"
    }
}
resp = requests.post(url, headers=headers, json=payload)
print(resp.json())

<?php
$ch = curl_init();
curl_setopt_array($ch, [
  CURLOPT_URL => "https://credit.farmsky.africa/api/v1/farmer360/crop",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer {CLIENT_ID}:{CLIENT_SECRET}",
    "x-api-key: {API_KEY}",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
  "farmer_identity" => [
    "national_id" => "31234567",
    "first_name" => "Jane",
    "last_name" => "Wanjiku"
  ],
  "farm_details" => [
    "latitude" => -0.2827,
    "longitude" => 36.0662,
    "crop_type" => "MAIZE",
    "planting_date" => "2026-03-14",
    "crop_cycle_days" => 120,
    "has_irrigation" => false
  ],
  "financial_data" => [
    "statement_type" => "mpesa",
    "statement_file_id" => "file_abc123"
  ]
]),
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;

import java.net.URI;
import java.net.http.*;

HttpClient client = HttpClient.newHttpClient();
String payload = "{\"farmer_identity\":{\"national_id\":\"31234567\",\"first_name\":\"Jane\",\"last_name\":\"Wanjiku\"},\"farm_details\":{\"latitude\":-0.2827,\"longitude\":36.0662,\"crop_type\":\"MAIZE\",\"planting_date\":\"2026-03-14\",\"crop_cycle_days\":120,\"has_irrigation\":false},\"financial_data\":{\"statement_type\":\"mpesa\",\"statement_file_id\":\"file_abc123\"}}";
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://credit.farmsky.africa/api/v1/farmer360/crop"))
    .header("Authorization", "Bearer {CLIENT_ID}:{CLIENT_SECRET}")
    .header("x-api-key", "{API_KEY}")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString(payload))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	payload := strings.NewReader(`{"farmer_identity":{"national_id":"31234567","first_name":"Jane","last_name":"Wanjiku"},"farm_details":{"latitude":-0.2827,"longitude":36.0662,"crop_type":"MAIZE","planting_date":"2026-03-14","crop_cycle_days":120,"has_irrigation":false},"financial_data":{"statement_type":"mpesa","statement_file_id":"file_abc123"}}`)
	req, _ := http.NewRequest("POST", "https://credit.farmsky.africa/api/v1/farmer360/crop", payload)
	req.Header.Add("Authorization", "Bearer {CLIENT_ID}:{CLIENT_SECRET}")
	req.Header.Add("x-api-key", "{API_KEY}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

RESPONSE

{
  "request_id": "req_8f2c1a9b7d3e4f60",
  "ok": true,
  "data": {
    "score_1000": 742,
    "band": "STRONG",
    "score_breakdown": {
      "crb": 178,
      "agro_ecological": 205,
      "cash_flow": 190,
      "market": 169
    },
    "explanation": "Healthy cash flow and favourable agro-ecological conditions…"
  }
}

{
  "error": "VERIFICATION_FAILED",
  "message": "Identity could not be verified."
}

{
  "error": "unauthorized",
  "message": "API credentials required. Send Authorization: Bearer <client_id>:<secret>."
}