Find perceptually similar prior proofs in this store

GET

https://numueg.app/api/v1/stores/{store_id}/payment-proofs/{proof_id}/similar

Last modified:2026-09-19 16:39:33

x-numu-scope:settings:read

Surface prior proofs whose pHash is within Hamming distance ≤ 8.

Looser than the dedup gate (≤ 5) — at review time the merchant
benefits from seeing "even loosely similar" submissions, not just
near-exact ones. Populates the "Possibly related submissions"
panel above Approve/Reject so the merchant can spot e.g. the
same screenshot resubmitted across two orders.

Empty result when the proof has no perceptual_hash (predates
Phase A) or when nothing similar exists in the per-store
90-day window the repository scans.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//payment-proofs//similar' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": [
        {
            "proof_id": "3090c5b2-ec00-4120-8732-cacbd73d7ad8",
            "order_id": "93101167-9065-4b9c-b98b-5d789a3ed9fe",
            "order_number": "string",
            "status": "string",
            "transaction_ref": "string",
            "declared_amount_cents": 0,
            "created_at": "2019-08-24T14:15:22.123Z",
            "signed_image_url": "string",
            "hamming_distance": 0
        }
    ],
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Reject a customer-submitted proof

Create new invoice