Endpoint
All requests must include an
Authorization: Bearer YOUR_API_KEY header. See Authentication for details.POSTPath:
/v1/audit/appBase URL:
https://api.fraudtraceai.com
Submit a mobile app package for automated risk emulation. Mobile Trace drives the app through its full UI flow inside an instrumented sandbox, captures screenshots, intercepts network calls, and extracts any UPI Virtual Payment Addresses (VPAs) surfaced in the app’s deposit or payment screens. The result tells you whether the app is carrying hidden fraud infrastructure before it reaches your users or merchant ecosystem.
Audits are asynchronous. The API accepts your submission and returns a job ID. You poll a separate status endpoint to retrieve results. The exact polling mechanism will be documented at launch.
Request
Request Body
The Android package name of the app you want to audit (e.g.
com.example.app). This must be the canonical package identifier as it appears in the app’s manifest. APK upload support is also planned for apps not yet published to the Play Store.The mobile platform. Currently
android is the supported value. iOS support is planned for a future release.Example Request
Planned Response
Whenstatus is FLAGGED, the findings array is populated with detected risk signals and risk_score will be elevated. When status is CLEARED, findings is empty, suspicious permissions are absent, and risk_score is near zero.
Response Fields
The Android package name you submitted, echoed back for correlation.
The platform value you submitted (
android).Overall audit verdict. Possible values:
FLAGGED— one or more risk signals were detected during emulation.CLEARED— no risk signals detected; the app passed the audit.PENDING— the audit is still running (returned when polling before completion).ERROR— the app could not be emulated (e.g. package not found, incompatible build).
A normalized risk score between
0.0 (no risk) and 1.0 (highest risk), computed from the combination and severity of all findings. Use this as a quick triage signal — scores above 0.7 typically indicate apps with active fraud infrastructure.List of individual risk signals detected during the audit. Empty for
CLEARED apps.A breakdown of the app’s declared Android permissions and which ones Mobile Trace considers suspicious given the app’s stated purpose.
The number of screenshots captured during emulation. These screenshots document the app screens that triggered findings. In a future release, screenshot URLs will be included in the response for manual review.
The UTC timestamp at which the audit finished. Format:
YYYY-MM-DDTHH:MM:SSZ.