Verify — Signature

Detect and isolate a handwritten signature from a document image.

Endpoint

POSThttps://gateway.startappz.co.ke/api/v1/sandbox/verify-signature

Swap sandbox for live once you have production credentials.

Authentication

Send your credentials as headers:

Header	Value
`X-API-Key`	Your public key
`X-API-Secret`	Your secret (shown once at issue time)

Request parameters

Parameter	Type	Required	Description
`file`	File (multipart)	required	Image / PDF containing the signature.

Response parameters

All responses follow the standard envelope: { code, message, data }.

Field	Type	Description
`code`	String	Internal status code (e.g. `200.001`).
`message`	String	Human-readable status / error description.
`data`	Object	Endpoint-specific payload (fields below).
`data.verified`	Boolean	True when a valid signature is detected.
`data.confidence`	Float	Detection confidence (0–1).

Sandbox masking

By default, sandbox responses mask PII (names, IDs, dates, phone numbers). You can grant unmasked consent per key from your dashboard.

import requests url = "https://gateway.startappz.co.ke/api/v1/sandbox/verify-signature" headers = { "X-API-Key": "vfy_sandbox_yourkey", "X-API-Secret": "yoursecret", } files = {"file": open("document.jpg", "rb")} r = requests.post(url, headers=headers, files=files) print(r.status_code, r.json())

$response = Http::withHeaders([ 'X-API-Key' => 'vfy_sandbox_yourkey', 'X-API-Secret' => 'yoursecret', ])->attach( 'file', file_get_contents('document.jpg'), 'document.jpg' )->post('https://gateway.startappz.co.ke/api/v1/sandbox/verify-signature'); return $response->json();

{ "code": "200.001", "message": "Success", "data": { "success": true, "verified": true, "action": "accept", "message": "Signature detected", "document_type": "signature", "confidence": 0.88, "confidence_level": "high", "sandbox": true } }