Partner Query Portal
Connect with your partner API key to query farmer data.
Connect your application
Query farmer data from your own systems with the ANDA Data API. Authenticate every request with your partner API key.
Base URL
https://stage.anda-global.com/wp-json/fis/v1/bank
Authentication
Send your key in the X-FIS-API-Key header on every request.
X-FIS-API-Key: YOUR_API_KEY
Quick start
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/farmers?region=Ashanti&per_page=10"
Endpoints
/me
Core
Your partner profile, enabled data products and status.
Sample request & response
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/me"
{
"partner_id": 7,
"institution_name": "United Bank",
"institution_type": "bank",
"institution_type_label": "Bank",
"api_key_prefix": "fis_sm1izK",
"allowed_scopes": ["credit_score", "transaction_summary", "market_prices"],
"scope_labels": {
"credit_score": "Credit score",
"transaction_summary": "Transaction summary",
"market_prices": "Market prices"
},
"rate_limit_per_hour": 1000,
"requests_used_last_hour": 14,
"requests_remaining_this_hour": 986,
"price_per_query": 0.05,
"status": "active",
"expires_at": null
}
/farmers
Core
Searchable directory of farmers (masked contact and location).
Sample request & response
searchName, phone or email fragmentregionFilter by regiondistrictFilter by districtcommunityFilter by communityvillageFilter by villagerisk_categoryRisk tier: excellent, very_good, good, fair, poor (requires credit_score scope)min_scoreMinimum credit score 300โ850 (requires credit_score scope)max_scoreMaximum credit score 300โ850 (requires credit_score scope)sortSort order: score_desc or score_asc (requires credit_score scope); default name AโZpagePage number (default 1)per_pageResults per page, max 100 (default 20)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/farmers?region=Ashanti&per_page=20&page=1"
{
"total": 128,
"page": 1,
"per_page": 20,
"pages": 7,
"credit_visible": true,
"farmers": [
{
"id": 42,
"name": "Kwame Mensah",
"avatar_url": "https://.../uploads/2026/07/kwame-small.webp",
"phone_masked": "024****89",
"email_masked": "k***@gmail.com",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"community": "Asokwa",
"village": "Ahinsan",
"credit_score": 712,
"risk_category": "low"
}
]
}
/farmer-profile/{id}
Core
Combined masked profile across every product you are enabled for.
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/farmer-profile/42"
{
"farmer_id": 42,
"name": "Kwame Mensah",
"avatar_url": "https://.../uploads/2026/07/kwame-small.webp",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"community": "Asokwa",
"village": "Ahinsan",
"phone_masked": "024****89",
"email_masked": "k***@gmail.com",
"sections": ["identity", "credit", "transactions", "production", "products", "orders"],
"credit": {
"score": 712,
"risk_category": "low",
"credit_limit_recommended": 5000.0,
"confidence_level": "high"
},
"transactions": {
"summary": { "total_orders": 54, "paid_gmv": 18250.0 },
"currency": "GHS"
},
"production": {
"summary": { "farm_count": 2, "commodity_count": 3 },
"farms": [
{ "farm_name": "Ahinsan Plot", "size": 4.5, "unit": "acre", "crops": "Maize, Cassava", "latitude": 6.6885421, "longitude": -1.6244563, "gps_accuracy": 8.0, "status": "active" }
],
"commodities": [
{ "commodity": "Maize", "variety": "Obatanpa", "quantity": 420.0, "unit": "kg", "typical_quantity": 1200.0, "typical_unit": "kg", "season": "major_season", "quality_grade": "A" }
]
},
"products": {
"count": 6,
"items": [
{ "title": "Fresh Maize 50kg", "price": "GHโต450.00", "stock_status": "instock", "sku": "MAIZE-50", "status": "Published" }
]
},
"orders": {
"count": 11,
"items": [
{ "number": "#1042", "status": "Completed", "total": "GHโต900.00", "date": "28 Sep 2026" }
]
},
"store": { "store_name": "Kwame Farms", "address": "Asokwa, Kumasi" },
"consent": { "bank_data_sharing_consent": true },
"query_cost": 0.05
}
/credit-score/{id}
Credit score
Behavioural credit score (300โ850), risk tier and components.
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/credit-score/42"
{
"farmer_id": 42,
"farmer_name": "Kwame Mensah",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"credit_score": 712,
"risk_category": "low",
"credit_limit_recommended": 5000.0,
"confidence": {
"level": "high",
"score": 0.86,
"data_freshness_days": 3,
"rolling_window_days": 90
},
"score_components": {
"payment_reliability": 82,
"delivery_consistency": 91,
"transaction_volume": 74,
"platform_tenure": 68,
"quality_rating": 78,
"farm_capacity": 61,
"supply_capacity": 55
},
"metrics": {
"total_gmv": 42150.0,
"total_orders": 54,
"on_time_delivery_rate": 0.93,
"gmv_90d": 12500.0
},
"last_calculated_at": "2026-09-30 11:04:22",
"query_cost": 0.05
}
/transaction-summary/{id}
Transactions
Order volume, GMV and top commodities.
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/transaction-summary/42"
{
"farmer_id": 42,
"farmer_name": "Kwame Mensah",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"currency": "GHS",
"summary": {
"total_orders": 54,
"paid_orders": 49,
"total_gmv": 42150.0,
"paid_gmv": 38900.0,
"average_paid_order_value": 793.88,
"commodity_count": 4,
"first_transaction_at": "2025-01-12 08:30:00",
"last_transaction_at": "2026-09-28 16:45:00"
},
"last_90_days": { "paid_orders": 17, "paid_gmv": 12500.0 },
"top_commodities": [
{ "commodity": "Maize", "orders": 21, "quantity": 420.0, "unit": "kg", "gmv": 15800.0 }
],
"query_cost": 0.05
}
/production-records/{id}
Production
Farms and commodity inventory.
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/production-records/42"
{
"farmer_id": 42,
"farmer_name": "Kwame Mensah",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"summary": {
"farm_count": 2,
"commodity_count": 3,
"farm_size_totals": [{ "unit": "acre", "total": 7.5 }]
},
"farms": [
{
"farm_name": "Ahinsan Plot",
"size": 4.5,
"unit": "acre",
"ownership_status": "owned",
"crops": "Maize, Cassava",
"irrigation_type": "rain-fed",
"soil_type": "loam",
"latitude": 6.6885421,
"longitude": -1.6244563,
"gps_accuracy": 8.0,
"planting_date": "2026-03-01",
"expected_harvest_date": "2026-07-15",
"status": "active"
}
],
"commodities": [
{
"commodity": "Maize",
"variety": "Obatanpa",
"quantity": 420.0,
"unit": "kg",
"typical_quantity": 1200.0,
"typical_unit": "kg",
"season": "major_season",
"quality_grade": "A",
"harvest_date": "2026-07-20",
"harvest_end_date": "2026-08-10"
}
],
"query_cost": 0.05
}
/market-prices
Market prices
Ask vs paid prices (normalised to GHS/kg) by commodity and region.
Sample request & response
commodityCommodity name (optional โ omit for a full snapshot)regionRegion, or "all" for national (optional)gradeQuality grade: premium, grade_a, grade_b, standard, ungraded, or "all" (optional)daysTrend window 1โ365 (default 30), used with commodity
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/market-prices?region=Ashanti"
{
"commodity": null,
"region": "all",
"grade": "all",
"as_of": "2026-10-02 09:15:00",
"count": 1,
"prices": [
{
"commodity": "Maize",
"grade": "grade_a",
"grade_label": "Grade A",
"region": "all",
"avg_price_per_kg": 6.60,
"ask": {
"avg_price_per_kg": 6.60,
"avg_price": 330.00,
"unit": "bag",
"unit_weight_kg": 50.0,
"sample_size": 12,
"price_date": "2026-10-02"
},
"paid": {
"avg_price_per_kg": 6.35,
"avg_price": 317.50,
"unit": "bag",
"unit_weight_kg": 50.0,
"sample_size": 7,
"price_date": "2026-10-02"
},
"paid_vs_ask_percent": -3.8,
"sample_size": 19,
"price_date": "2026-10-02"
}
],
"query_cost": 0.05
}
/logistics-quality/{id}
Logistics
Delivery performance, on-time rate, spoilage and ratings.
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/logistics-quality/42"
{
"farmer_id": 42,
"farmer_name": "Kwame Mensah",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"summary": {
"total_deliveries": 48,
"completed_deliveries": 46,
"on_time_deliveries": 43,
"on_time_rate_percent": 93.5,
"spoilage_incidents": 1,
"average_customer_rating": 4.7,
"average_delivery_minutes": 95,
"last_delivery_at": "2026-09-28 16:45:00"
},
"recent_deliveries": [
{
"status": "delivered",
"scheduled_at": "2026-09-28 14:00:00",
"delivered_at": "2026-09-28 15:30:00",
"delivery_minutes": 90,
"on_time": true,
"spoilage_reported": false,
"customer_rating": 5.0
}
],
"query_cost": 0.05
}
/farmer-identity/{id}
Identity
KYC basics (national ID masked).
Sample request & response
{id}Farmer ID (path)
curl -H "X-FIS-API-Key: YOUR_API_KEY" \
"https://stage.anda-global.com/wp-json/fis/v1/bank/farmer-identity/42"
{
"farmer_id": 42,
"full_name": "Kwame Mensah",
"gender": "male",
"phone_masked": "024****89",
"phone_verified": true,
"email_masked": "k***@gmail.com",
"location": {
"country": "Ghana",
"region": "Ashanti",
"district": "Kumasi Metropolitan",
"village": "Ahinsan"
},
"national_id": {
"type": "Ghana Card",
"on_file": true,
"masked": "GHA-****-****-4"
},
"approval_status": "approved",
"approved_at": "2026-02-18 10:22:00",
"registered_at": "2026-02-10 09:00:00",
"profile_completion_percent": 88,
"query_cost": 0.05
}
All responses are JSON. Personal data (phone, email, national ID) is always masked. Endpoints marked with a product require that product to be enabled on your account. Values shown above are illustrative.
How the credit score is calculated
The credit score is led by a farmer's real marketplace behaviour - sales, payments, deliveries and buyer ratings (88% of the weight) - complemented by two production-capacity signals from their registered farms and commodity inventory (12%). Each component is scored 0-100, combined with the weights below into a weighted average, then mapped onto a 300-850 scale. Behaviour stays dominant, so a farmer cannot materially raise the score through self-reported figures alone.
30%Payment reliability — Share of settled orders that were paid, less a penalty for failed/cancelled orders.22%Delivery consistency — Completion and on-time delivery rates, less penalties for spoilage and failed deliveries.14%Transaction volume — Annualised paid GMV and order frequency (60% value, 40% frequency).12%Platform tenure — How long the farmer has been active, boosted for steady monthly ordering.10%Quality rating — Average verified buyer rating and package-condition feedback.6%Farm capacity — Registered land under cultivation (normalised to acres), crop diversity, land ownership and GPS-verified location.6%Supply capacity — Typical seasonal volume the farmer produces, commodity diversity, quality grade and warehouse readiness.
weighted = ฮฃ(component_score ร weight) // 0โ100
credit_score = round(300 + weighted ร 5.5) // clamped to 300โ850
750โ850Excellent700โ749Very good600โ699Good500โ599Fair300โ499Poor
Recent activity is weighted through a 90-day rolling window, so the score is forward-looking. Each response also carries a confidence level (low / medium / high) based on how much settled history exists and how fresh it is - treat a low-confidence score as indicative only. The recommended credit limit is derived from annualised paid GMV and average order value, scaled by the score tier and capped between GHS 500 and GHS 50,000.