GradeMY

Identify the connected GradeMY account with a stable opaque ID.

get_connected_profile

Read this account's remaining scan allowance and UTC reset month; does not sell or change entitlements.

get_scan_allowance

Check the existing scan_id without consuming another credit. A complete response already includes the evidence report: present it directly, without a redundant report lookup. Follow next_action while still processing. Never replace a slow or failed job by creating another scan automatically.

get_scan_status

Retrieve or revisit a completed owned scan; does not consume a scan credit. Use for an existing report or a follow-up requesting its evidence. If the current get_scan_status response already contains a report, use that report. Explain suggested corrections without claiming they have been applied.

get_scan_report

Scan a public store domain or product URL when the user requests a new scan. Accept a bare domain (such as liquiddeath.com). buyer_query is optional and should be empty unless the user supplied a shopping request. Creates one job and consumes one credit; do not call again to check progress or explain fixes. Use the returned next_action. Authentication and allowance are checked here.

scan_store

Use after get_scan_status confirms completion to show an inline evidence card. Accept only the existing owned scan_id, never a client-supplied report. Also use when the user asks to reopen the visual report. Reads saved evidence; creates no scan, consumes no credit and applies no store changes. Call once per requested display, not for progress polling. Text clients can use the structured report without UI. Explain corrections from this saved evidence.

show_scan_report