Manual Verification

Submit a manual KYC verification for Kenyan organisation types (NGO, Trust, Society, CBO, SACCO, MSEA, MCCS, Club, Retirement). Returns 202 with search_id for async processing, or 200 when a recent cache hit exists (≤ 2 weeks).

Request

POST/api/v1/manual

{{baseUrl}}/api/v1/manual

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Body Parameters

Parameter	Type	Description	Required
reference_number	string	Organisation reference / registration number	required
type	string	NGO \| Trust \| Society \| CBO \| SACCO \| MSEA \| MCCS \| Club \| Retirement	required

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 202,
  "message": "Verification submitted for processing",
  "data": {
    "search_id": 123,
    "search_status": "In Progress",
    "reference_number": "NGO-123456",
    "type": "NGO"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code (typically mirrors HTTP)
message	string	Human-readable status message
data	object	Payload for the verified resource
request_id	string	UUID for support and audit trails

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.