Version 1.0 - Open Source

Collaborative Fraud Prevention API

Share and search problematic clients across industries. Protect your business by learning from others' experiences.

{{ number_format($stats['total_clients']) }}
Reported Clients
{{ number_format($stats['total_reports']) }}
Total Reports
{{ number_format($stats['total_companies']) }}
Active Companies
{{ number_format($stats['total_categories']) }}
Categories

Key Features

Secure Authentication

Company registration with admin approval. All API calls require bearer token authentication.

Advanced Search

Search by email, phone, name, tax ID and more. Track multiple phone numbers per client.

Fraud Classification

11 predefined fraud types including non-payment, chargeback fraud, identity theft and more.

Bulk Operations

Upload multiple client reports at once with our bulk endpoint. Perfect for large datasets.

Statistics & Insights

View global fraud trends and your company's contribution to the network.

Auto-generated Docs

Complete API documentation with interactive examples powered by Scribe.

Perfect For

Logistics
E-commerce
Financial
Real Estate
Services
Telecom
Hospitality
More...

Quick Start

1. Clone the Repository

git clone https://github.com/yourusername/blacklisthub-api.git
cd blacklisthub-api

2. Install Dependencies

composer install
cp .env.example .env
php artisan key:generate

3. Setup Database

php artisan migrate --seed

4. Start Server

php artisan serve
Default Admin Credentials
Email: admin@blacklist.com | Password: password123
⚠️ Change these in production!

API Example

Report a Client

curl -X POST http://localhost:8000/v1/blacklist \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "category_id": 1,
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "1234567890",
    "fraud_type_id": 1,
    "debt_amount": 5000.00,
    "additional_info": "Failed to pay for services"
  }'

Open Source & Community Driven

BlacklistHub is open source and welcomes contributions from developers worldwide.