B
BECdex API

Blue Economy Certification API

REST API backend for Blue Economy certification, submission management, and assessment scoring.

Live
v1.0
REST API
JSON
Base URL https://api.becdex.com/api Laravel v11.55.0 PHP v8.2

🔐 Authentication

Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json

📋 Response Format

{ "status": "success",
"message": "...",
"data": { ... } }

🛡️ Auth Levels

  • Public — No token required
  • 🔒 User — Bearer token required
  • 🔶 Admin — Admin role required
GET Read data POST Create PUT Update DELETE Delete 🔒 Auth required 🔶 Admin only

API Endpoints

🔑
Authentication
Register, login, profile, sessions
9 endpoints ▶
POST/api/auth/registerRegister new company account
POST/api/auth/loginLogin & get Bearer token
POST/api/auth/forgot-passwordSend password reset email
POST/api/auth/reset-passwordReset password with token
DELETE/api/auth/logout🔒Logout & revoke token
GET/api/auth/me🔒Get authenticated user
PUT/api/auth/profile🔒Update profile info
PUT/api/auth/password🔒Change password
GET/api/auth/sessions🔒List active sessions
🌐
Public
No authentication required
6 endpoints ▶
GET/api/public/verified-companiesList verified companies
GET/api/public/indicatorsCatalog of 50 BEC indicators
GET/api/public/downloadsPublic downloadable files
GET/api/public/lookupsMaster data lookups
GET/api/public/cmsCMS content for frontend
POST/api/public/helpSend help message
📋
Submissions
Assessment submission management
14 endpoints ▶
GET/api/submissions🔒List my submissions
POST/api/submissions🔒Create new submission
GET/api/submissions/{id}🔒Get submission detail
DELETE/api/submissions/{id}🔒Delete draft submission
POST/api/submissions/{id}/submit🔒Submit for verification
GET/api/submissions/{id}/answers🔒Get assessment answers
PUT/api/submissions/{id}/answers🔒Bulk update answers
GET/api/submissions/{id}/documents🔒List uploaded documents
POST/api/submissions/{id}/documents🔒Upload evidence document
DELETE/api/submissions/{id}/documents/{docId}🔒Delete document
GET/api/submissions/{id}/score🔒Get score & requirements
POST/api/submissions/{id}/payment🔒Initiate Xendit payment
GET/api/submissions/{id}/payment/check🔒Check payment status
GET/api/submissions/{id}/activity-logs🔒Activity log history
🔔
Notifications & Payments
User notifications and payment history
5 endpoints ▶
GET/api/notifications🔒List notifications
POST/api/notifications/mark-read🔒Mark as read
GET/api/payments🔒Payment history
GET/api/payments/{id}🔒Payment detail
POST/api/payment/webhookXendit payment webhook
🛡️
Admin — Submissions
Review, verify, score and certify
13 endpoints ▶
GET/api/admin/submissions🔶All submissions
GET/api/admin/submissions/{id}🔶Submission detail
PUT/api/admin/submissions/{id}/indicators/{ind}🔶Score indicator
POST/api/admin/submissions/{id}/start🔶Start verification
POST/api/admin/submissions/{id}/approve🔶Approve submission
POST/api/admin/submissions/{id}/reject🔶Reject submission
POST/api/admin/submissions/{id}/return🔶Return for revision
POST/api/admin/submissions/{id}/survey🔶Schedule field survey
POST/api/admin/submissions/{id}/certificate🔶Issue certificate
GET/api/admin/dashboard/stats🔶Dashboard statistics
GET/api/admin/submissions/export/csv🔶Export submissions CSV
GET/api/admin/certificates🔶All certificates
GET/api/admin/payments🔶All payments
📊
Admin — Framework
Aspects, outcomes, principles, indicators, questions
20 endpoints ▶
GET/api/admin/framework/aspects🔶List aspects
POST/api/admin/framework/aspects🔶Create aspect
PUT/api/admin/framework/aspects/{id}🔶Update aspect
DELETE/api/admin/framework/aspects/{id}🔶Delete aspect
GET/api/admin/framework/outcomes🔶List outcomes
POST/api/admin/framework/outcomes🔶Create outcome
PUT/api/admin/framework/outcomes/{id}🔶Update outcome
GET/api/admin/framework/principles🔶List principles
POST/api/admin/framework/principles🔶Create principle
PUT/api/admin/framework/principles/{id}🔶Update principle
GET/api/admin/framework/indicators🔶List indicators
POST/api/admin/framework/indicators🔶Create indicator
PUT/api/admin/framework/indicators/{id}🔶Update indicator
DELETE/api/admin/framework/indicators/{id}🔶Delete indicator
GET/api/admin/framework/questions🔶List questions
POST/api/admin/framework/questions🔶Create question
PUT/api/admin/framework/questions/{id}🔶Update question
GET/api/admin/master/countries🔶List countries
GET/api/admin/master/company-fields🔶Company field types
GET/api/admin/settings🔶App settings
👥
Admin — Users, CMS & Downloads
User management, CMS content, file downloads
11 endpoints ▶
GET/api/admin/users🔶List all users
POST/api/admin/users🔶Create user
PUT/api/admin/users/{id}🔶Update user
DELETE/api/admin/users/{id}🔶Delete user
POST/api/admin/users/{id}/verify🔶Manually verify user
GET/api/admin/cms🔶Get all CMS content
PUT/api/admin/cms🔶Update CMS content
GET/api/admin/downloads🔶List downloads
POST/api/admin/downloads🔶Upload public file
DELETE/api/admin/downloads/{id}🔶Delete download
GET/api/admin/help🔶Help messages inbox