Home

CoViD Scam Directory API

If you are using this API, please add it to this list

1. addFraud Endpoint: This can be used to add a new entry to the database.

curl --location --request POST 'https://api.cov.social/v1/info/addFraud' \
--header 'Content-Type: application/json' \
--data-raw '{
    "phone": <PHONE_NO_OF_THE_SCAMMER>,
    "upi": <UPI_OF_THE_SCAMMER>,
    "account_number": <ACCOUNT_NO_OF_THE_SCAMMER>,
    "comment": <DETAILS_OF_THE_FRAUD>,
    "entity_name": <NAME_OF_THE_SCAMMER>,
    "region": {
        "name": <CITY>,
        "location": {
            "type": "Point",
            "coordinates": [<LONGITUDE>, <LATITUDE>]
        }
    },
    "reported_by": {
        "phone": <PHONE>,
        "email": <EMAIL>
    },
    "source": <URL_OR_SELF>
}'

2. findFraud Endpoint: Query the database for scam entry.

curl --location --request POST 'https://api.cov.social/v1/info/findFraud' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search": <SEARCH_TERM>
}'

3. findFraudCount Endpoint: Get the count of fraud entries for the search query. This will also return a view URL where users can be redirected to see the results in detail.

curl --location --request POST 'https://api.cov.social/v1/info/findFraudCount' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search": <SEARCH_TERM>
}'

4. getStats Endpoint: Get total reports, unique phone numbers, unique account numbers and unique UPI IDs.

curl --location --request GET 'https://api.cov.social/v1/info/getStats'