{"openapi":"3.0.0","paths":{"/api/v1/users/health":{"get":{"operationId":"UserController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["User"]}},"/api/v1/users/stats":{"get":{"operationId":"UserController_getStats","parameters":[],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/deleted-accounts":{"get":{"operationId":"UserController_findDeletedAccounts","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Search by original user id, name, email, or phone number","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/deleted-accounts/{id}":{"get":{"operationId":"UserController_findDeletedAccount","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]},"delete":{"operationId":"UserController_purgeDeletedAccount","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/export":{"get":{"operationId":"UserController_exportCsv","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Search by id, name, email, phone, region, or onboarding stage","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED"],"type":"string"}},{"name":"kycStatus","required":false,"in":"query","schema":{"enum":["PENDING","VERIFIED","REJECTED"],"type":"string"}},{"name":"onboardingStage","required":false,"in":"query","schema":{"enum":["EMAIL_PENDING","PROFILE_COMPLETE","KYC_PENDING","KYC_VERIFIED","COMPLETED"],"type":"string"}},{"name":"region","required":false,"in":"query","schema":{"type":"string"}},{"name":"emailVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"phoneNumberVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"kycVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"flaggedForReview","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users":{"get":{"operationId":"UserController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Search by id, name, email, phone, region, or onboarding stage","schema":{"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED"],"type":"string"}},{"name":"kycStatus","required":false,"in":"query","schema":{"enum":["PENDING","VERIFIED","REJECTED"],"type":"string"}},{"name":"onboardingStage","required":false,"in":"query","schema":{"enum":["EMAIL_PENDING","PROFILE_COMPLETE","KYC_PENDING","KYC_VERIFIED","COMPLETED"],"type":"string"}},{"name":"region","required":false,"in":"query","schema":{"type":"string"}},{"name":"emailVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"phoneNumberVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"kycVerified","required":false,"in":"query","schema":{"type":"boolean"}},{"name":"flaggedForReview","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]},"post":{"operationId":"UserController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserDto"}}}},"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/overview":{"get":{"operationId":"UserController_getOverview","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/security":{"get":{"operationId":"UserController_getSecurity","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/documents":{"get":{"operationId":"UserController_listDocuments","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]},"post":{"operationId":"UserController_addDocument","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUserDocumentDto"}}}},"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}":{"get":{"operationId":"UserController_findById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserResponseDto"}}}}},"tags":["User"],"security":[{"bearer":[]}]},"patch":{"operationId":"UserController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateUserDto"}}}},"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]},"delete":{"operationId":"UserController_delete","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/current/account-deletion/request":{"post":{"operationId":"UserController_requestCurrentAccountDeletion","parameters":[],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/current/account-deletion/confirm":{"post":{"operationId":"UserController_confirmCurrentAccountDeletion","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmAccountDeletionDto"}}}},"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/suspend":{"post":{"operationId":"UserController_suspend","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/activate":{"post":{"operationId":"UserController_activate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/deactivate":{"post":{"operationId":"UserController_deactivate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/force-logout":{"post":{"operationId":"UserController_forceLogout","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/flag-for-review":{"post":{"operationId":"UserController_flagForReview","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/clear-review-flag":{"post":{"operationId":"UserController_clearReviewFlag","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/current-location":{"patch":{"operationId":"UserController_updateCurrentLocation","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCurrentUserLocationDto"}}}},"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/users/{id}/documents/{documentId}":{"delete":{"operationId":"UserController_deleteDocument","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"documentId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["User"],"security":[{"bearer":[]}]}},"/api/v1/auth/health":{"get":{"operationId":"AuthController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Auth"]}},"/api/v1/auth/user/onboard/signup":{"post":{"operationId":"UserAuthController_requestEmailVerification","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestUserOnboardingEmailDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/onboard/verify-email":{"post":{"operationId":"UserAuthController_verifyEmail","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyUserEmailDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/onboard/complete":{"post":{"operationId":"UserAuthController_completeOnboarding","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteUserOnboardingDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/login":{"post":{"operationId":"UserAuthController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLoginDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/login/verify-2fa":{"post":{"operationId":"UserAuthController_verifyTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyUserTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/password-reset/request":{"post":{"operationId":"UserAuthController_requestPasswordReset","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestPasswordResetDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/user/password-reset/complete":{"post":{"operationId":"UserAuthController_completePasswordReset","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteUserPasswordResetDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"]}},"/api/v1/auth/current-user":{"get":{"operationId":"UserAuthController_getCurrentUser","parameters":[],"responses":{"200":{"description":""}},"tags":["Auth User"],"security":[{"bearer":[]}]}},"/api/v1/auth/user/2fa/status":{"get":{"operationId":"UserAuthController_getTwoFactorStatus","parameters":[],"responses":{"200":{"description":""}},"tags":["Auth User"],"security":[{"bearer":[]}]}},"/api/v1/auth/user/2fa/setup":{"post":{"operationId":"UserAuthController_setupTwoFactor","parameters":[],"responses":{"201":{"description":""}},"tags":["Auth User"],"security":[{"bearer":[]}]}},"/api/v1/auth/user/2fa/enable":{"post":{"operationId":"UserAuthController_enableTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCurrentTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"],"security":[{"bearer":[]}]}},"/api/v1/auth/user/2fa/disable":{"post":{"operationId":"UserAuthController_disableTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth User"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/invite":{"post":{"operationId":"AdminAuthController_invite","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteAdminDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/accept-invite":{"post":{"operationId":"AdminAuthController_acceptInvite","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptAdminInviteDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"]}},"/api/v1/auth/admin/login":{"post":{"operationId":"AdminAuthController_login","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"]}},"/api/v1/auth/admin/login/verify-2fa":{"post":{"operationId":"AdminAuthController_verifyTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyAdminTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"]}},"/api/v1/auth/admin/password-reset/request":{"post":{"operationId":"AdminAuthController_requestPasswordReset","parameters":[{"name":"origin","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestPasswordResetDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"]}},"/api/v1/auth/admin/password-reset/complete":{"post":{"operationId":"AdminAuthController_completePasswordReset","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompletePasswordResetDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"]}},"/api/v1/auth/current-admin":{"get":{"operationId":"AdminAuthController_getCurrentAdmin","parameters":[],"responses":{"200":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/2fa/status":{"get":{"operationId":"AdminAuthController_getTwoFactorStatus","parameters":[],"responses":{"200":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/2fa/setup":{"post":{"operationId":"AdminAuthController_setupTwoFactor","parameters":[],"responses":{"201":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/2fa/enable":{"post":{"operationId":"AdminAuthController_enableTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyCurrentTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/admin/2fa/disable":{"post":{"operationId":"AdminAuthController_disableTwoFactor","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableTwoFactorDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth Admin"],"security":[{"bearer":[]}]}},"/api/v1/auth/kyc/dojah-webhook":{"post":{"operationId":"AuthKycController_handleDojahWebhook","parameters":[{"name":"x-dojah-signature","required":true,"in":"header","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DojahKycWebhookDto"}}}},"responses":{"201":{"description":""}},"tags":["Auth KYC"]}},"/api/v1/events/health":{"get":{"operationId":"EventsController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Events"]}},"/api/v1/wallet/health":{"get":{"operationId":"WalletController_check","summary":"Wallet module health check","parameters":[],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletHealthResponseDto"}}}}},"tags":["Wallet"]}},"/api/v1/wallet/conversion-rate/current":{"get":{"operationId":"WalletController_getConversionRate","summary":"Get the current Naira-to-token conversion rate","parameters":[],"responses":{"200":{"description":""}},"tags":["Wallet"]}},"/api/v1/wallet/convert-to-token":{"post":{"operationId":"WalletController_convertToToken","summary":"Convert prepaid Naira balance to energy tokens","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertToTokenDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertToTokenResponseDto"}}}}},"tags":["Wallet"],"security":[{"bearer":[]}]}},"/api/v1/wallet/{userId}":{"get":{"operationId":"WalletController_getWallet","parameters":[{"name":"userId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletResponseDto"}}}}},"tags":["Wallet"],"security":[{"bearer":[]}]}},"/api/v1/wallet/topup/init":{"post":{"operationId":"WalletController_initTopup","summary":"Initialize wallet topup with Paystack","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitWalletTopupDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletTopupInitResponseDto"}}}}},"tags":["Wallet"],"security":[{"bearer":[]}]}},"/api/v1/wallet/topup/verify":{"post":{"operationId":"WalletController_verifyTopup","summary":"Verify wallet topup and credit wallet","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyWalletTopupDto"}}}},"responses":{"201":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletTopupVerifyResponseDto"}}}}},"tags":["Wallet"]}},"/api/v1/wallet/paystack/webhook":{"post":{"operationId":"WalletController_handlePaystackWebhook","summary":"Handle Paystack webhook callbacks","parameters":[{"name":"x-paystack-signature","required":true,"in":"header","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Wallet"]}},"/api/v1/organizations":{"get":{"operationId":"OrganizationController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"isActive","required":false,"in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":""}},"tags":["Organizations"],"security":[{"bearer":[]}]},"post":{"operationId":"OrganizationController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationDto"}}}},"responses":{"201":{"description":""}},"tags":["Organizations"],"security":[{"bearer":[]}]}},"/api/v1/organizations/{id}":{"get":{"operationId":"OrganizationController_findById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Organizations"],"security":[{"bearer":[]}]},"patch":{"operationId":"OrganizationController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOrganizationDto"}}}},"responses":{"200":{"description":""}},"tags":["Organizations"],"security":[{"bearer":[]}]}},"/api/v1/admins/health":{"get":{"operationId":"AdminController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Admin"]}},"/api/v1/admins":{"get":{"operationId":"AdminController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"role","required":false,"in":"query","schema":{"enum":["SUPER_ADMIN","ADMIN","ACCOUNTANT","ENGINEER"],"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","INACTIVE"],"type":"string"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin"],"security":[{"bearer":[]}]},"post":{"operationId":"AdminController_create","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdminDto"}}}},"responses":{"201":{"description":""}},"tags":["Admin"],"security":[{"bearer":[]}]}},"/api/v1/admins/{id}":{"get":{"operationId":"AdminController_findById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin"],"security":[{"bearer":[]}]},"patch":{"operationId":"AdminController_update","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminDto"}}}},"responses":{"200":{"description":""}},"tags":["Admin"],"security":[{"bearer":[]}]},"delete":{"operationId":"AdminController_delete","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Admin"],"security":[{"bearer":[]}]}},"/api/v1/admins/{id}/suspend":{"post":{"operationId":"AdminController_suspend","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminResponseDto"}}}}},"tags":["Admin"],"security":[{"bearer":[]}]}},"/api/v1/admins/{id}/activate":{"post":{"operationId":"AdminController_activate","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminResponseDto"}}}}},"tags":["Admin"],"security":[{"bearer":[]}]}},"/api/v1/stations/health":{"get":{"operationId":"StationController_check","summary":"Check station module health","description":"Returns a lightweight health payload for the station module.","parameters":[],"responses":{"200":{"description":"Station module is reachable.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"module":"station","status":"ok"},"error":null,"statusCode":200}}}}}},"tags":["Stations"]}},"/api/v1/stations":{"get":{"operationId":"StationController_findAll","summary":"List stations","description":"Returns paginated charging stations with their assigned rate, chargers, and recent charging sessions.","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"example":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"example":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive text search against station address.","schema":{"example":"Marina","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED","INACTIVE"],"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string"}},{"name":"localGovernmentArea","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","description":"Filter stations assigned to this tariff id.","schema":{"example":"22222222-2222-4222-8222-222222222222","type":"string"}}],"responses":{"200":{"description":"Paginated stations.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"data":[{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"}],"meta":{"page":1,"limit":20,"total":1,"totalPages":1,"hasNextPage":false,"hasPreviousPage":false}},"error":null,"statusCode":200}}}}}},"tags":["Stations"]},"post":{"operationId":"StationController_create","summary":"Create a station","description":"Creates a station using Location module metadata. If tariffId is provided, it must reference an existing tariff.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateStationDto"}}}},"responses":{"201":{"description":"Station created.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":201}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"example":{"success":false,"message":"tariffId must be a UUID","content":null,"error":{"path":"/api/v1/stations"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"The supplied tariffId does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Tariff not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]}},"/api/v1/stations/nearby":{"get":{"operationId":"StationController_findNearby","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive text search against station address.","schema":{"example":"Marina","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED","INACTIVE"],"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string"}},{"name":"localGovernmentArea","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","description":"Filter stations assigned to this tariff id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}},{"name":"latitude","required":true,"in":"query","description":"Latitude of the search origin.","schema":{"example":6.5244,"type":"number"}},{"name":"longitude","required":true,"in":"query","description":"Longitude of the search origin.","schema":{"example":3.3792,"type":"number"}},{"name":"radiusInMeters","required":false,"in":"query","description":"Optional maximum distance from the origin, in meters.","schema":{"minimum":1,"example":5000,"type":"number"}},{"name":"radiusMeters","required":false,"in":"query","schema":{"type":"number"}},{"name":"onlyAvailable","required":false,"in":"query","description":"When true, only stations with an available connector are returned.","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":""}},"tags":["Stations"]}},"/api/v1/stations/search-area":{"get":{"operationId":"StationController_searchArea","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive text search against station address.","schema":{"example":"Marina","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED","INACTIVE"],"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string"}},{"name":"localGovernmentArea","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","description":"Filter stations assigned to this tariff id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}},{"name":"north","required":true,"in":"query","schema":{"type":"number"}},{"name":"south","required":true,"in":"query","schema":{"type":"number"}},{"name":"east","required":true,"in":"query","schema":{"type":"number"}},{"name":"west","required":true,"in":"query","schema":{"type":"number"}},{"name":"onlyAvailable","required":false,"in":"query","description":"When true, only stations with an available connector are returned.","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":""}},"tags":["Stations"]}},"/api/v1/stations/closest/search":{"get":{"operationId":"StationController_findClosest","summary":"Find closest stations","description":"Returns stations sorted by distance from the provided latitude and longitude. Optional radius filters the results in meters.","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"example":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"example":20,"type":"number"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive text search against station address.","schema":{"example":"Marina","type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED","INACTIVE"],"type":"string"}},{"name":"state","required":false,"in":"query","schema":{"type":"string"}},{"name":"localGovernmentArea","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","description":"Filter stations assigned to this tariff id.","schema":{"example":"22222222-2222-4222-8222-222222222222","type":"string"}},{"name":"latitude","required":true,"in":"query","description":"Latitude of the search origin.","schema":{"example":6.5244,"type":"number"}},{"name":"longitude","required":true,"in":"query","description":"Longitude of the search origin.","schema":{"example":3.3792,"type":"number"}},{"name":"radiusInMeters","required":false,"in":"query","description":"Optional maximum distance from the origin, in meters.","schema":{"minimum":1,"example":5000,"type":"number"}},{"name":"radiusMeters","required":false,"in":"query","schema":{"type":"number"}},{"name":"onlyAvailable","required":false,"in":"query","description":"When true, only stations with an available connector are returned.","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"Paginated stations sorted by distance.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"data":[{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z","distanceInMeters":320}],"meta":{"page":1,"limit":20,"total":1,"totalPages":1,"hasNextPage":false,"hasPreviousPage":false}},"error":null,"statusCode":200}}}}},"400":{"description":"Validation failed or a station has invalid location data.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Invalid station location data","content":null,"error":{"path":"/api/v1/stations"},"statusCode":400}}}}}},"tags":["Stations"]}},"/api/v1/stations/{id}":{"get":{"operationId":"StationController_findById","summary":"Get a station by id","description":"Returns a station with assigned rate, chargers, and recent charging sessions.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}}],"responses":{"200":{"description":"Station found.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"404":{"description":"No station exists for the supplied id.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"]},"patch":{"operationId":"StationController_update","summary":"Update a station","description":"Updates station address, location, assigned rate, custom rate, or charger creation payload fields. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStationDto"}}}},"responses":{"200":{"description":"Station updated.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"example":{"success":false,"message":"location.latitude must be a number","content":null,"error":{"path":"/api/v1/stations"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"The station or supplied tariffId does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]},"delete":{"operationId":"StationController_delete","summary":"Delete a station","description":"Deletes a station. Admin authentication is required. Related chargers are removed by the station relation.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}}],"responses":{"200":{"description":"Station deleted.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"No station exists for the supplied id.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]}},"/api/v1/stations/{id}/tariff":{"patch":{"operationId":"StationController_assignTariff","summary":"Assign a tariff to a station","description":"Assigns an existing tariff configuration to an existing station. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignTariffToStationDto"}}}},"responses":{"200":{"description":"Tariff assigned to station.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"example":{"success":false,"message":"tariffId must be a UUID","content":null,"error":{"path":"/api/v1/stations"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"The station or rate does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Tariff not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]}},"/api/v1/stations/{id}/chargers":{"post":{"operationId":"StationController_addCharger","summary":"Add a charger to a station","description":"Creates a charger under an existing station. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddChargerToStationDto"}}}},"responses":{"201":{"description":"Charger created and attached to station.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","tariff":{"id":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"amountPerKilowatt":10,"effectivePricing":{"tariffId":"22222222-2222-4222-8222-222222222222","name":"Lagos Standard","type":"PER_KWH","rate":10,"currency":"NGN","kilowattHoursPerToken":1,"source":"STATION","isDefault":false},"chargers":[],"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"}},"error":null,"statusCode":201}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"example":{"success":false,"message":"chargerId must be a string","content":null,"error":{"path":"/api/v1/stations"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"No station exists for the supplied id.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]}},"/api/v1/stations/{id}/chargers/{chargerId}":{"delete":{"operationId":"StationController_removeCharger","summary":"Remove a charger from a station","description":"Deletes a charger only when it belongs to the supplied station. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Station id.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}},{"name":"chargerId","required":true,"in":"path","description":"Internal charger id to remove.","schema":{"example":"33333333-3333-4333-8333-333333333333","type":"string"}}],"responses":{"200":{"description":"Charger removed from station.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/stations"},"statusCode":401}}}}},"404":{"description":"The charger was not found in the supplied station.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Charger not found in station","content":null,"error":{"path":"/api/v1/stations"},"statusCode":404}}}}}},"tags":["Stations"],"security":[{"bearer":[]}]}},"/api/v1/location/health":{"get":{"operationId":"LocationController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/location/search":{"get":{"operationId":"LocationController_search","parameters":[{"name":"query","required":true,"in":"query","schema":{"example":"Ikeja City Mall","type":"string"}}],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/location/reverse-geocode":{"get":{"operationId":"LocationController_reverseGeocode","parameters":[{"name":"latitude","required":true,"in":"query","schema":{"example":6.6018,"type":"number"}},{"name":"longitude","required":true,"in":"query","schema":{"example":3.3515,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/location/distance":{"get":{"operationId":"LocationController_distance","parameters":[{"name":"fromLatitude","required":true,"in":"query","schema":{"example":6.6018,"type":"number"}},{"name":"fromLongitude","required":true,"in":"query","schema":{"example":3.3515,"type":"number"}},{"name":"toLatitude","required":true,"in":"query","schema":{"example":6.5244,"type":"number"}},{"name":"toLongitude","required":true,"in":"query","schema":{"example":3.3792,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/location/route-path":{"get":{"operationId":"LocationController_getRoutePath","parameters":[{"name":"currentLatitude","required":true,"in":"query","schema":{"example":6.6018,"type":"number"}},{"name":"currentLongitude","required":true,"in":"query","schema":{"example":3.3515,"type":"number"}},{"name":"destinationLatitude","required":true,"in":"query","schema":{"example":6.5244,"type":"number"}},{"name":"destinationLongitude","required":true,"in":"query","schema":{"example":3.3792,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/location/static-route-map":{"get":{"operationId":"LocationController_getStaticRouteMap","parameters":[{"name":"currentLatitude","required":true,"in":"query","schema":{"example":6.6018,"type":"number"}},{"name":"currentLongitude","required":true,"in":"query","schema":{"example":3.3515,"type":"number"}},{"name":"destinationLatitude","required":true,"in":"query","schema":{"example":6.5244,"type":"number"}},{"name":"destinationLongitude","required":true,"in":"query","schema":{"example":3.3792,"type":"number"}},{"name":"size","required":false,"in":"query","schema":{"example":"800x500","type":"string"}},{"name":"zoom","required":false,"in":"query","schema":{"example":13,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Location"]}},"/api/v1/chargers/health":{"get":{"operationId":"ChargerController_check","summary":"Check charger module health","description":"Returns a lightweight health payload for the charger module.","parameters":[],"responses":{"200":{"description":"Charger module is reachable.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"module":"charger","status":"ok"},"error":null,"statusCode":200}}}}}},"tags":["Chargers"]}},"/api/v1/chargers":{"get":{"operationId":"ChargerController_findAll","summary":"List chargers","description":"Returns paginated chargers with their assigned station and recent charging sessions. Supports status, station, and text search filters.","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"example":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"example":20,"type":"number"}},{"name":"status","required":false,"in":"query","description":"Filter chargers by operational status.","schema":{"$ref":"#/components/schemas/ChargerStatus"}},{"name":"stationId","required":false,"in":"query","description":"Filter chargers assigned to this station.","schema":{"example":"11111111-1111-4111-8111-111111111111","type":"string"}},{"name":"search","required":false,"in":"query","description":"Case-insensitive search against chargerId or uniqueBarcode.","schema":{"example":"CHR-001","type":"string"}}],"responses":{"200":{"description":"Paginated chargers.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"data":[{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"}],"meta":{"page":1,"limit":20,"total":1,"totalPages":1,"hasNextPage":false,"hasPreviousPage":false}},"error":null,"statusCode":200}}}}}},"tags":["Chargers"]},"post":{"operationId":"ChargerController_create","summary":"Create a charger","description":"Creates a charger and assigns it to an existing station. Admin authentication is required.","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChargerDto"}}}},"responses":{"201":{"description":"Charger created and assigned to station.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":201}}}}},"400":{"description":"Validation failed, including invalid voltage configuration.","content":{"application/json":{"schema":{"example":{"success":false,"message":"configuredOutputVoltage must be between minOutputVoltage and maxOutputVoltage","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":401}}}}},"404":{"description":"The supplied stationId does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":404}}}}}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/monitoring/summary":{"get":{"operationId":"ChargerController_getMonitoringSummary","parameters":[],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/code/{code}":{"get":{"operationId":"ChargerController_resolveConnectionCode","summary":"Resolve the connection code printed on a charger","parameters":[{"name":"code","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/qr/{qrToken}":{"get":{"operationId":"ChargerController_resolveQrToken","parameters":[{"name":"qrToken","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}":{"get":{"operationId":"ChargerController_findById","summary":"Get a charger by id","description":"Returns a charger with its assigned station and recent charging sessions.","parameters":[{"name":"id","required":true,"in":"path","description":"Internal charger id.","schema":{"example":"33333333-3333-4333-8333-333333333333","type":"string"}}],"responses":{"200":{"description":"Charger found.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"404":{"description":"No charger exists for the supplied id.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Charger not found","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":404}}}}}},"tags":["Chargers"]},"patch":{"operationId":"ChargerController_update","summary":"Update a charger","description":"Updates charger metadata, status, voltage configuration, or station assignment. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Internal charger id.","schema":{"example":"33333333-3333-4333-8333-333333333333","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateChargerDto"}}}},"responses":{"200":{"description":"Charger updated.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"ACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"400":{"description":"Validation failed, including invalid voltage configuration.","content":{"application/json":{"schema":{"example":{"success":false,"message":"minOutputVoltage cannot be greater than maxOutputVoltage","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":401}}}}},"404":{"description":"The charger or supplied stationId does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Charger not found","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":404}}}}}},"tags":["Chargers"],"security":[{"bearer":[]}]},"delete":{"operationId":"ChargerController_delete","summary":"Delete a charger","description":"Deletes a charger. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Internal charger id.","schema":{"example":"33333333-3333-4333-8333-333333333333","type":"string"}}],"responses":{"200":{"description":"Charger deleted.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":401}}}}},"404":{"description":"No charger exists for the supplied id.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Charger not found","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":404}}}}}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/runtime":{"get":{"operationId":"ChargerController_getRuntimeSnapshot","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/qr-code":{"post":{"operationId":"ChargerController_generateQrCode","summary":"Generate or replace a charger QR code","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands":{"get":{"operationId":"ChargerController_listCommands","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["PENDING","QUEUED","SENT","ACCEPTED","REJECTED","TIMED_OUT","FAILED","COMPLETED"],"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["REMOTE_START","REMOTE_STOP","RESET","UNLOCK_CONNECTOR","CHANGE_AVAILABILITY","TRIGGER_MESSAGE","GET_CONFIGURATION","GET_DIAGNOSTICS"],"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/events":{"get":{"operationId":"ChargerController_listEvents","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["PENDING","QUEUED","SENT","ACCEPTED","REJECTED","TIMED_OUT","FAILED","COMPLETED"],"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["REMOTE_START","REMOTE_STOP","RESET","UNLOCK_CONNECTOR","CHANGE_AVAILABILITY","TRIGGER_MESSAGE","GET_CONFIGURATION","GET_DIAGNOSTICS"],"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/alerts":{"get":{"operationId":"ChargerController_listAlerts","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["PENDING","QUEUED","SENT","ACCEPTED","REJECTED","TIMED_OUT","FAILED","COMPLETED"],"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["REMOTE_START","REMOTE_STOP","RESET","UNLOCK_CONNECTOR","CHANGE_AVAILABILITY","TRIGGER_MESSAGE","GET_CONFIGURATION","GET_DIAGNOSTICS"],"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/station":{"patch":{"operationId":"ChargerController_assignStation","summary":"Assign a charger to a station","description":"Moves an existing charger to an existing station. Admin authentication is required.","parameters":[{"name":"id","required":true,"in":"path","description":"Internal charger id.","schema":{"example":"33333333-3333-4333-8333-333333333333","type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignChargerToStationDto"}}}},"responses":{"200":{"description":"Charger assigned to station.","content":{"application/json":{"schema":{"example":{"success":true,"message":"Request processed successfully","content":{"id":"33333333-3333-4333-8333-333333333333","stationId":"11111111-1111-4111-8111-111111111111","chargerId":"CHR-001","uniqueBarcode":"BAR-001","networkConfig":{"ip":"10.0.0.1","protocol":"ocpp"},"minOutputVoltage":120,"maxOutputVoltage":240,"configuredOutputVoltage":220,"status":"INACTIVE","connectionStatus":"ONLINE","healthStatus":"HEALTHY","socketConnected":true,"lastHeartbeatAt":"2026-07-08T09:05:00.000Z","station":{"id":"11111111-1111-4111-8111-111111111111","address":"14 Marina Road, Lagos","location":{"latitude":6.4541,"longitude":3.3947},"tariffId":"22222222-2222-4222-8222-222222222222","createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"chargingSessions":[],"createdAt":"2026-07-08T09:00:00.000Z","updatedAt":"2026-07-08T09:00:00.000Z"},"error":null,"statusCode":200}}}}},"400":{"description":"Validation failed.","content":{"application/json":{"schema":{"example":{"success":false,"message":"stationId must be a UUID","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":400}}}}},"401":{"description":"Missing or invalid admin bearer token.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Unauthorized","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":401}}}}},"404":{"description":"The charger or station does not exist.","content":{"application/json":{"schema":{"example":{"success":false,"message":"Station not found","content":null,"error":{"path":"/api/v1/chargers"},"statusCode":404}}}}}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/start":{"post":{"operationId":"ChargerController_remoteStart","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRemoteStartCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/stop":{"post":{"operationId":"ChargerController_remoteStop","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRemoteStopCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/reset":{"post":{"operationId":"ChargerController_reset","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminResetCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/unlock":{"post":{"operationId":"ChargerController_unlockConnector","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminUnlockConnectorCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/change-availability":{"post":{"operationId":"ChargerController_changeAvailability","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminChangeAvailabilityCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/trigger-message":{"post":{"operationId":"ChargerController_triggerMessage","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminTriggerMessageCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/configuration":{"post":{"operationId":"ChargerController_getConfiguration","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminGetConfigurationCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/chargers/{id}/commands/diagnostics":{"post":{"operationId":"ChargerController_getDiagnostics","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminGetDiagnosticsCommandDto"}}}},"responses":{"201":{"description":""}},"tags":["Chargers"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/health":{"get":{"operationId":"ChargingSessionController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["ChargingSession"]}},"/api/v1/charging-sessions/current-user-sessions":{"get":{"operationId":"ChargingSessionController_findCurrentUserSessions","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["CREATED","AWAITING_PLUG_IN","VEHICLE_CONNECTED","START_SCHEDULED","START_REQUESTED","START_ACCEPTED","STARTED","CHARGING","PAUSED","STOP_REQUESTED","STOPPING","COMPLETED","START_FAILED","STOP_FAILED","CHARGER_OFFLINE","INTERRUPTED","EXPIRED","CANCELLED","PAYMENT_FAILED","STOPPED"],"type":"string"}},{"name":"paymentStatus","required":false,"in":"query","schema":{"enum":["PENDING","PARTIALLY_PAID","PAID","FAILED","REFUNDED"],"type":"string"}},{"name":"stationId","required":false,"in":"query","schema":{"type":"string"}},{"name":"chargerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"userId","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/current-user-sessions/{id}":{"get":{"operationId":"ChargingSessionController_findCurrentUserSessionById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/current-user-active":{"get":{"operationId":"ChargingSessionController_findCurrentUserActiveSession","parameters":[],"responses":{"200":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions":{"post":{"operationId":"ChargingSessionController_createCurrentUserSession","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateChargingSessionDto"}}}},"responses":{"201":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]},"get":{"operationId":"ChargingSessionController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"status","required":false,"in":"query","schema":{"enum":["CREATED","AWAITING_PLUG_IN","VEHICLE_CONNECTED","START_SCHEDULED","START_REQUESTED","START_ACCEPTED","STARTED","CHARGING","PAUSED","STOP_REQUESTED","STOPPING","COMPLETED","START_FAILED","STOP_FAILED","CHARGER_OFFLINE","INTERRUPTED","EXPIRED","CANCELLED","PAYMENT_FAILED","STOPPED"],"type":"string"}},{"name":"paymentStatus","required":false,"in":"query","schema":{"enum":["PENDING","PARTIALLY_PAID","PAID","FAILED","REFUNDED"],"type":"string"}},{"name":"stationId","required":false,"in":"query","schema":{"type":"string"}},{"name":"chargerId","required":false,"in":"query","schema":{"type":"string"}},{"name":"userId","required":false,"in":"query","schema":{"type":"string"}},{"name":"tariffId","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/{id}/start":{"post":{"operationId":"ChargingSessionController_startCurrentUserSession","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartChargingSessionDto"}}}},"responses":{"201":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/{id}":{"get":{"operationId":"ChargingSessionController_findById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/{id}/stop":{"post":{"operationId":"ChargingSessionController_stopCurrentUserSession","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopChargingSessionDto"}}}},"responses":{"201":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/charging-sessions/{id}/admin-stop":{"post":{"operationId":"ChargingSessionController_stopSessionAsAdmin","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StopChargingSessionDto"}}}},"responses":{"201":{"description":""}},"tags":["ChargingSession"],"security":[{"bearer":[]}]}},"/api/v1/jobs/health":{"get":{"operationId":"JobsController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Jobs"]}},"/api/v1/rates/health":{"get":{"operationId":"RateController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Charging Pricing"]}},"/api/v1/rates/token-price/default":{"get":{"operationId":"RateController_getDefaultTokenPrice","summary":"Get the fallback naira price for one internal charging token","parameters":[],"responses":{"200":{"description":""}},"tags":["Charging Pricing"]},"patch":{"operationId":"RateController_updateDefaultTokenPrice","summary":"Update the fallback charging token price","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDefaultTokenPriceDto"}}}},"responses":{"200":{"description":""}},"tags":["Charging Pricing"],"security":[{"bearer":[]}]}},"/api/v1/tariffs/health":{"get":{"operationId":"TariffController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Tariffs"]}},"/api/v1/tariffs":{"get":{"operationId":"TariffController_findAll","summary":"List tariff profiles","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"search","required":false,"in":"query","schema":{"type":"string"}},{"name":"type","required":false,"in":"query","schema":{"enum":["PER_KWH","PER_MINUTE","PER_SESSION","HYBRID"],"type":"string"}},{"name":"scope","required":false,"in":"query","schema":{"enum":["GLOBAL","STATION","CHARGER"],"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["ACTIVE","SUSPENDED","INACTIVE"],"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Tariffs"]},"post":{"operationId":"TariffController_create","summary":"Create a tariff profile","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTariffDto"}}}},"responses":{"201":{"description":""}},"tags":["Tariffs"],"security":[{"bearer":[]}]}},"/api/v1/tariffs/{id}":{"get":{"operationId":"TariffController_findById","summary":"Get a tariff profile","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Tariffs"]},"patch":{"operationId":"TariffController_update","summary":"Update a tariff profile; existing session snapshots remain unchanged","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTariffDto"}}}},"responses":{"200":{"description":""}},"tags":["Tariffs"],"security":[{"bearer":[]}]},"delete":{"operationId":"TariffController_delete","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Tariffs"],"security":[{"bearer":[]}]}},"/api/v1/tariffs/{id}/status":{"patch":{"operationId":"TariffController_updateStatus","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTariffStatusDto"}}}},"responses":{"200":{"description":""}},"tags":["Tariffs"],"security":[{"bearer":[]}]}},"/api/v1/transactions/health":{"get":{"operationId":"TransactionController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Transaction"]}},"/api/v1/transactions/current-user-transactions":{"get":{"operationId":"TransactionController_findCurrentUserTransactions","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"transactionType","required":false,"in":"query","schema":{"enum":["CREDIT","DEBIT"],"type":"string"}},{"name":"legalEntity","required":false,"in":"query","schema":{"enum":["NAIRA","TOKEN"],"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["PENDING","COMPLETED","FAILED"],"type":"string"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["PAYSTACK","MANUAL"],"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"userId","required":false,"in":"query","schema":{"type":"string"}},{"name":"chargingSessionId","required":false,"in":"query","schema":{"type":"string"}},{"name":"reference","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Transaction"],"security":[{"bearer":[]}]}},"/api/v1/transactions/current-user-transactions/{id}":{"get":{"operationId":"TransactionController_findCurrentUserTransactionById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Transaction"],"security":[{"bearer":[]}]}},"/api/v1/transactions":{"get":{"operationId":"TransactionController_findAll","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}},{"name":"transactionType","required":false,"in":"query","schema":{"enum":["CREDIT","DEBIT"],"type":"string"}},{"name":"legalEntity","required":false,"in":"query","schema":{"enum":["NAIRA","TOKEN"],"type":"string"}},{"name":"status","required":false,"in":"query","schema":{"enum":["PENDING","COMPLETED","FAILED"],"type":"string"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["PAYSTACK","MANUAL"],"type":"string"}},{"name":"walletId","required":false,"in":"query","schema":{"type":"string"}},{"name":"userId","required":false,"in":"query","schema":{"type":"string"}},{"name":"chargingSessionId","required":false,"in":"query","schema":{"type":"string"}},{"name":"reference","required":false,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Transaction"],"security":[{"bearer":[]}]}},"/api/v1/transactions/{id}":{"get":{"operationId":"TransactionController_findById","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Transaction"],"security":[{"bearer":[]}]}},"/api/v1/notifications/health":{"get":{"operationId":"NotificationsController_check","parameters":[],"responses":{"200":{"description":""}},"tags":["Notifications"]}},"/api/v1/notifications/device-tokens":{"post":{"operationId":"NotificationsController_registerDeviceToken","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterPushDeviceTokenDto"}}}},"responses":{"201":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]},"delete":{"operationId":"NotificationsController_unregisterDeviceToken","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnregisterPushDeviceTokenDto"}}}},"responses":{"200":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]}},"/api/v1/notifications/current-user-notifications":{"get":{"operationId":"NotificationsController_findCurrentUserNotifications","parameters":[{"name":"page","required":false,"in":"query","schema":{"default":1,"type":"number"}},{"name":"limit","required":false,"in":"query","schema":{"maximum":100,"default":20,"type":"number"}}],"responses":{"200":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]}},"/api/v1/notifications/current-user-notifications/unread-count":{"get":{"operationId":"NotificationsController_getCurrentUserUnreadCount","parameters":[],"responses":{"200":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]}},"/api/v1/notifications/current-user-notifications/read-all":{"patch":{"operationId":"NotificationsController_markAllCurrentUserNotificationsRead","parameters":[],"responses":{"200":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]}},"/api/v1/notifications/current-user-notifications/{id}/read":{"patch":{"operationId":"NotificationsController_markCurrentUserNotificationRead","parameters":[{"name":"id","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["Notifications"],"security":[{"bearer":[]}]}}},"info":{"title":"metropay Backend API","description":"metropay backend services","version":"1.0","contact":{}},"tags":[],"servers":[],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"UserResponseDto":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"emailVerified":{"type":"boolean"},"phoneNumberVerified":{"type":"boolean"},"kycVerified":{"type":"boolean"},"kycStatus":{"type":"string","enum":["PENDING","VERIFIED","REJECTED"]},"status":{"type":"string","enum":["ACTIVE","SUSPENDED"]},"onboardingStage":{"type":"string","enum":["EMAIL_PENDING","PROFILE_COMPLETE","KYC_PENDING","KYC_VERIFIED","COMPLETED"]},"region":{"type":"string","nullable":true},"nin":{"type":"string","nullable":true},"flaggedForReview":{"type":"boolean"},"lastActiveAt":{"type":"string","format":"date-time","nullable":true},"twoFactorEnabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"organizationId":{"type":"string"}},"required":["id","firstName","lastName","email","phoneNumber","emailVerified","phoneNumberVerified","kycVerified","kycStatus","status","onboardingStage","flaggedForReview","twoFactorEnabled","createdAt","updatedAt","organizationId"]},"CreateUserDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"password":{"type":"string"},"phoneNumber":{"type":"string"},"region":{"type":"string"},"nin":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED"]},"kycStatus":{"type":"string","enum":["PENDING","VERIFIED","REJECTED"]},"onboardingStage":{"type":"string","enum":["EMAIL_PENDING","PROFILE_COMPLETE","KYC_PENDING","KYC_VERIFIED","COMPLETED"]},"currentLocation":{"type":"object"},"organizationId":{"type":"string"}},"required":["firstName","lastName","email","password","phoneNumber"]},"ConfirmAccountDeletionDto":{"type":"object","properties":{"token":{"type":"string","description":"The 6 digit account deletion code sent by email","example":"123456"}},"required":["token"]},"CreateUserDocumentDto":{"type":"object","properties":{"type":{"type":"string","enum":["NIN","ID_CARD","UTILITY_BILL","OTHER"]},"name":{"type":"string"},"fileUrl":{"type":"string"},"metadata":{"type":"object"}},"required":["type","name"]},"UpdateCurrentUserLocationDto":{"type":"object","properties":{"currentLocation":{"type":"object"}},"required":["currentLocation"]},"UpdateUserDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"password":{"type":"string"},"phoneNumber":{"type":"string"},"region":{"type":"string"},"nin":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED"]},"kycStatus":{"type":"string","enum":["PENDING","VERIFIED","REJECTED"]},"onboardingStage":{"type":"string","enum":["EMAIL_PENDING","PROFILE_COMPLETE","KYC_PENDING","KYC_VERIFIED","COMPLETED"]},"currentLocation":{"type":"object"},"organizationId":{"type":"string"}}},"RequestUserOnboardingEmailDto":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]},"VerifyUserEmailDto":{"type":"object","properties":{"email":{"type":"string"},"token":{"type":"string"}},"required":["email","token"]},"CompleteUserOnboardingDto":{"type":"object","properties":{"email":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"password":{"type":"string"},"phoneNumber":{"type":"string"},"organizationId":{"type":"string"}},"required":["email","firstName","lastName","password"]},"UserLoginDto":{"type":"object","properties":{"email":{"type":"string"},"password":{"type":"string"}},"required":["email","password"]},"VerifyUserTwoFactorDto":{"type":"object","properties":{"twoFactorToken":{"type":"string"},"token":{"type":"string"}},"required":["twoFactorToken","token"]},"RequestPasswordResetDto":{"type":"object","properties":{"email":{"type":"string"}},"required":["email"]},"CompleteUserPasswordResetDto":{"type":"object","properties":{"token":{"type":"string"},"newPassword":{"type":"string"},"email":{"type":"string"}},"required":["token","newPassword","email"]},"VerifyCurrentTwoFactorDto":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"]},"DisableTwoFactorDto":{"type":"object","properties":{"password":{"type":"string"}},"required":["password"]},"InviteAdminDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"role":{"type":"string","enum":["SUPER_ADMIN","ADMIN","ACCOUNTANT","ENGINEER"]}},"required":["firstName","lastName","email","phoneNumber","role"]},"AcceptAdminInviteDto":{"type":"object","properties":{"token":{"type":"string"},"password":{"type":"string"}},"required":["token","password"]},"AdminLoginDto":{"type":"object","properties":{"email":{"type":"string"},"password":{"type":"string"}},"required":["email","password"]},"VerifyAdminTwoFactorDto":{"type":"object","properties":{"twoFactorToken":{"type":"string"},"token":{"type":"string"}},"required":["twoFactorToken","token"]},"CompletePasswordResetDto":{"type":"object","properties":{"token":{"type":"string"},"newPassword":{"type":"string"}},"required":["token","newPassword"]},"DojahKycWebhookDto":{"type":"object","properties":{"metadata":{"type":"object"},"entity":{"type":"object"},"data":{"type":"object"},"status":{"type":"string"}}},"WalletHealthResponseDto":{"type":"object","properties":{"module":{"type":"string","example":"wallet"},"status":{"type":"string","example":"ok"}},"required":["module","status"]},"ConvertToTokenDto":{"type":"object","properties":{"amount":{"type":"number","example":5000}},"required":["amount"]},"ConvertToTokenResponseDto":{"type":"object","properties":{"converted":{"type":"boolean"},"debitedNairaAmount":{"type":"string"},"creditedTokenAmount":{"type":"string"},"newNairaBalance":{"type":"string"},"newTokenBalance":{"type":"string"}},"required":["converted","debitedNairaAmount","creditedTokenAmount","newNairaBalance","newTokenBalance"]},"WalletTransactionResponseDto":{"type":"object","properties":{"id":{"type":"string"},"reference":{"type":"string"},"transactionType":{"type":"string"},"legalEntity":{"type":"string"},"status":{"type":"string"},"description":{"type":"string"},"amount":{"type":"string"},"previousNairaBalance":{"type":"string"},"newNairaBalance":{"type":"string"},"createdAt":{"format":"date-time","type":"string"}},"required":["id","reference","transactionType","legalEntity","status","description","amount","previousNairaBalance","newNairaBalance","createdAt"]},"WalletResponseDto":{"type":"object","properties":{"id":{"type":"string"},"userId":{"type":"string"},"nairaBalance":{"type":"string"},"tokenBalance":{"type":"string"},"rfidKey":{"type":"string"},"transactions":{"type":"array","items":{"$ref":"#/components/schemas/WalletTransactionResponseDto"}}},"required":["id","userId","nairaBalance","tokenBalance","rfidKey","transactions"]},"InitWalletTopupDto":{"type":"object","properties":{"amount":{"type":"number","example":5000},"callbackUrl":{"type":"string"}},"required":["amount"]},"WalletTopupInitResponseDto":{"type":"object","properties":{"reference":{"type":"string"},"authorizationUrl":{"type":"string"},"accessCode":{"type":"string"},"amount":{"type":"number"}},"required":["reference","authorizationUrl","accessCode","amount"]},"VerifyWalletTopupDto":{"type":"object","properties":{"reference":{"type":"string"}},"required":["reference"]},"WalletTopupVerifyResponseDto":{"type":"object","properties":{"credited":{"type":"boolean"},"message":{"type":"string"},"walletBalance":{"type":"string"}},"required":["credited","message","walletBalance"]},"CreateOrganizationDto":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string","example":"ACME-EV"},"adminFirstName":{"type":"string"},"adminLastName":{"type":"string"},"adminEmail":{"type":"string"}},"required":["name","code","adminFirstName","adminLastName","adminEmail"]},"UpdateOrganizationDto":{"type":"object","properties":{"name":{"type":"string"},"code":{"type":"string"},"isActive":{"type":"boolean"}}},"CreateAdminDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"role":{"type":"string","enum":["SUPER_ADMIN","ADMIN","ACCOUNTANT","ENGINEER"]},"password":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"],"default":"ACTIVE"}},"required":["firstName","lastName","email","phoneNumber","role","password"]},"UpdateAdminDto":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"role":{"type":"string","enum":["SUPER_ADMIN","ADMIN","ACCOUNTANT","ENGINEER"]},"password":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"],"default":"ACTIVE"}}},"AdminResponseDto":{"type":"object","properties":{"id":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"email":{"type":"string"},"phoneNumber":{"type":"string"},"role":{"type":"string","enum":["SUPER_ADMIN","ADMIN","ACCOUNTANT","ENGINEER"]},"twoFactorEnabled":{"type":"boolean"},"status":{"type":"string","enum":["ACTIVE","INACTIVE"]},"lastActiveAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","firstName","lastName","email","phoneNumber","role","twoFactorEnabled","status","createdAt","updatedAt"]},"CoordinatesDto":{"type":"object","properties":{"latitude":{"type":"number","description":"Latitude component of the station location.","example":6.4541},"longitude":{"type":"number","description":"Longitude component of the station location.","example":3.3947}},"required":["latitude","longitude"]},"ChargerStatus":{"type":"string","description":"Initial charger status. Defaults to INACTIVE when omitted.","enum":["INACTIVE","ACTIVE","OCCUPIED","MAINTENANCE"]},"CreateStationChargerDto":{"type":"object","properties":{"tariffId":{"type":"string","description":"Optional charger-specific tariff override. When omitted, the charger inherits the station tariff.","example":"22222222-2222-4222-8222-222222222222"},"chargerId":{"type":"string","description":"Human/business identifier for the physical charger.","example":"CHR-001"},"uniqueBarcode":{"type":"string","description":"Unique barcode printed on or assigned to the charger.","example":"BAR-001"},"networkConfig":{"type":"object","description":"Network configuration required to communicate with the charger.","example":{"ip":"10.0.0.1","protocol":"ocpp"}},"minOutputVoltage":{"type":"number","description":"Minimum supported output voltage.","example":120},"maxOutputVoltage":{"type":"number","description":"Maximum supported output voltage.","example":240},"configuredOutputVoltage":{"type":"number","description":"Configured operating output voltage.","example":220},"status":{"example":"INACTIVE","$ref":"#/components/schemas/ChargerStatus"}},"required":["chargerId","uniqueBarcode","networkConfig","minOutputVoltage","maxOutputVoltage","configuredOutputVoltage"]},"CreateStationDto":{"type":"object","properties":{"name":{"type":"string","example":"Marina Charging Hub"},"address":{"type":"string","description":"Street address or readable station location label.","example":"14 Marina Road, Lagos"},"location":{"description":"Station geolocation used for closest-station lookup.","allOf":[{"$ref":"#/components/schemas/CoordinatesDto"}]},"tariffId":{"type":"string","description":"Station tariff inherited by chargers without a direct tariff override. The global ₦500/token price is used when omitted.","example":"11111111-1111-4111-8111-111111111111"},"locationMetadata":{"type":"object","description":"Location provider metadata selected through the Location module."},"state":{"type":"string","example":"Lagos"},"localGovernmentArea":{"type":"string","example":"Lagos Island"},"owner":{"type":"string","example":"MetroCharge"},"openingHours":{"type":"string","example":"24/7"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","INACTIVE"]},"chargers":{"description":"Optional chargers to create together with the station.","type":"array","items":{"$ref":"#/components/schemas/CreateStationChargerDto"}}},"required":["address","location"]},"UpdateStationDto":{"type":"object","properties":{"name":{"type":"string","example":"Marina Charging Hub"},"address":{"type":"string","description":"Street address or readable station location label.","example":"14 Marina Road, Lagos"},"location":{"description":"Station geolocation used for closest-station lookup.","allOf":[{"$ref":"#/components/schemas/CoordinatesDto"}]},"tariffId":{"type":"string","description":"Station tariff inherited by chargers without a direct tariff override. The global ₦500/token price is used when omitted.","example":"11111111-1111-4111-8111-111111111111"},"locationMetadata":{"type":"object","description":"Location provider metadata selected through the Location module."},"state":{"type":"string","example":"Lagos"},"localGovernmentArea":{"type":"string","example":"Lagos Island"},"owner":{"type":"string","example":"MetroCharge"},"openingHours":{"type":"string","example":"24/7"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","INACTIVE"]},"chargers":{"description":"Optional chargers to create together with the station.","type":"array","items":{"$ref":"#/components/schemas/CreateStationChargerDto"}}}},"AssignTariffToStationDto":{"type":"object","properties":{"tariffId":{"type":"string","description":"Tariff profile to assign to the station.","example":"22222222-2222-4222-8222-222222222222"}},"required":["tariffId"]},"AddChargerToStationDto":{"type":"object","properties":{"tariffId":{"type":"string","description":"Optional charger-specific tariff override. When omitted, the charger inherits the station tariff.","example":"22222222-2222-4222-8222-222222222222"},"chargerId":{"type":"string","description":"Human/business identifier for the physical charger.","example":"CHR-001"},"uniqueBarcode":{"type":"string","description":"Unique barcode printed on or assigned to the charger.","example":"BAR-001"},"networkConfig":{"type":"object","description":"Network configuration required to communicate with the charger.","example":{"ip":"10.0.0.1","protocol":"ocpp"}},"minOutputVoltage":{"type":"number","description":"Minimum supported output voltage.","example":120},"maxOutputVoltage":{"type":"number","description":"Maximum supported output voltage.","example":240},"configuredOutputVoltage":{"type":"number","description":"Configured operating output voltage.","example":220},"status":{"example":"INACTIVE","$ref":"#/components/schemas/ChargerStatus"}},"required":["chargerId","uniqueBarcode","networkConfig","minOutputVoltage","maxOutputVoltage","configuredOutputVoltage"]},"ChargerDataTransferResponseDto":{"type":"object","properties":{}},"ChargerNetworkConfigDto":{"type":"object","properties":{"dataTransferResponses":{"description":"Explicit replies for known vendor DataTransfer messages. Unknown vendors/messages are rejected.","type":"array","items":{"$ref":"#/components/schemas/ChargerDataTransferResponseDto"}},"ocppEndpoint":{"type":"string","description":"OCPP base WebSocket URL. Defaults to the backend public /ocpp route when omitted or blank.","example":"wss://api.metrocharge.ng/ocpp"},"protocolVersion":{"type":"string","example":"1.6J"},"webSocketUrl":{"type":"string","description":"Charger WebSocket URL. Defaults to {OCPP base route}/{chargerId} when omitted or blank.","example":"wss://api.metrocharge.ng/ocpp/CHR-001"},"chargePointId":{"type":"string","description":"OCPP charge point identity. Kept equal to the chargerId by the backend.","example":"CHR-001"},"connectionType":{"type":"string","example":"4GLTE"},"ipAddress":{"type":"string","example":"10.0.0.1"},"username":{"type":"string"},"password":{"type":"string","writeOnly":true},"authToken":{"type":"string","writeOnly":true},"tlsEnabled":{"type":"boolean","default":true},"rejectUnauthorized":{"type":"boolean","default":true},"caCertificate":{"type":"string"},"clientCertificate":{"type":"string"},"clientKey":{"type":"string","writeOnly":true},"heartbeatIntervalSeconds":{"type":"number","default":60},"reconnectIntervalSeconds":{"type":"number","default":10},"maxReconnectAttempts":{"type":"number","default":10}}},"CreateChargerDto":{"type":"object","properties":{"stationId":{"type":"string","description":"Station that owns or hosts this charger.","example":"11111111-1111-4111-8111-111111111111"},"tariffId":{"type":"string","description":"Tariff assigned directly to this charger."},"name":{"type":"string","example":"Charger A - Bay 1"},"chargerId":{"type":"string","description":"OCPP charge point identity. The charger appends this exact value when connecting to /ocpp.","example":"CHR-001"},"serialNumber":{"type":"string","example":"MC-2026-0001"},"model":{"type":"string","example":"MC-DC-120"},"vendor":{"type":"string","example":"MetroCharge"},"maxPower":{"type":"number","example":120},"connectorTypes":{"example":["CCS2","Type 2"],"type":"array","items":{"type":"string"}},"uniqueBarcode":{"type":"string","description":"Unique barcode printed on or assigned to the charger.","example":"BAR-001"},"networkConfig":{"description":"Network configuration required to communicate with the charger.","example":{"ip":"10.0.0.1","protocol":"ocpp"},"allOf":[{"$ref":"#/components/schemas/ChargerNetworkConfigDto"}]},"minOutputVoltage":{"type":"number","description":"Minimum supported output voltage.","example":120,"minimum":0},"maxOutputVoltage":{"type":"number","description":"Maximum supported output voltage.","example":240,"minimum":0},"configuredOutputVoltage":{"type":"number","description":"Configured operating output voltage.","example":220,"minimum":0},"status":{"example":"INACTIVE","$ref":"#/components/schemas/ChargerStatus"}}},"UpdateChargerDto":{"type":"object","properties":{"stationId":{"type":"string","description":"Station that owns or hosts this charger.","example":"11111111-1111-4111-8111-111111111111"},"tariffId":{"type":"string","description":"Tariff assigned directly to this charger."},"name":{"type":"string","example":"Charger A - Bay 1"},"chargerId":{"type":"string","description":"OCPP charge point identity. The charger appends this exact value when connecting to /ocpp.","example":"CHR-001"},"serialNumber":{"type":"string","example":"MC-2026-0001"},"model":{"type":"string","example":"MC-DC-120"},"vendor":{"type":"string","example":"MetroCharge"},"maxPower":{"type":"number","example":120},"connectorTypes":{"example":["CCS2","Type 2"],"type":"array","items":{"type":"string"}},"uniqueBarcode":{"type":"string","description":"Unique barcode printed on or assigned to the charger.","example":"BAR-001"},"networkConfig":{"description":"Network configuration required to communicate with the charger.","example":{"ip":"10.0.0.1","protocol":"ocpp"},"allOf":[{"$ref":"#/components/schemas/ChargerNetworkConfigDto"}]},"minOutputVoltage":{"type":"number","description":"Minimum supported output voltage.","example":120,"minimum":0},"maxOutputVoltage":{"type":"number","description":"Maximum supported output voltage.","example":240,"minimum":0},"configuredOutputVoltage":{"type":"number","description":"Configured operating output voltage.","example":220,"minimum":0},"status":{"example":"INACTIVE","$ref":"#/components/schemas/ChargerStatus"}}},"AssignChargerToStationDto":{"type":"object","properties":{"stationId":{"type":"string","description":"Station id to assign this charger to.","example":"11111111-1111-4111-8111-111111111111"}},"required":["stationId"]},"AdminRemoteStartCommandDto":{"type":"object","properties":{"connectorId":{"type":"number"},"sessionId":{"type":"string"},"idTag":{"type":"string"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"AdminRemoteStopCommandDto":{"type":"object","properties":{"connectorId":{"type":"number"},"sessionId":{"type":"string"},"transactionId":{"type":"string"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"AdminResetCommandDto":{"type":"object","properties":{"type":{"type":"string"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"AdminUnlockConnectorCommandDto":{"type":"object","properties":{"connectorId":{"type":"number"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"AdminChangeAvailabilityCommandDto":{"type":"object","properties":{"connectorId":{"type":"number"},"type":{"type":"string"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}},"required":["type"]},"AdminTriggerMessageCommandDto":{"type":"object","properties":{"requestedMessage":{"type":"string"},"connectorId":{"type":"number"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}},"required":["requestedMessage"]},"AdminGetConfigurationCommandDto":{"type":"object","properties":{"key":{"type":"array","items":{"type":"string"}},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"AdminGetDiagnosticsCommandDto":{"type":"object","properties":{"location":{"type":"string"},"retries":{"type":"number"},"retryInterval":{"type":"number"},"immediate":{"type":"boolean"},"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"CreateChargingSessionDto":{"type":"object","properties":{"qrToken":{"type":"string"},"idempotencyKey":{"type":"string"}},"required":["qrToken"]},"StartChargingSessionDto":{"type":"object","properties":{"idempotencyKey":{"type":"string"}}},"StopChargingSessionDto":{"type":"object","properties":{"reason":{"type":"string"},"idempotencyKey":{"type":"string"}}},"UpdateDefaultTokenPriceDto":{"type":"object","properties":{"nairaPerToken":{"type":"number","example":500,"description":"Fallback naira price for one internal charging token (1 token = 1 kWh)."}},"required":["nairaPerToken"]},"TariffPeriodDto":{"type":"object","properties":{"startTime":{"type":"string","example":"08:00"},"endTime":{"type":"string","example":"18:00"},"rate":{"type":"number","example":650,"description":"Naira charged per internal energy token (1 token = 1 kWh)."}},"required":["startTime","endTime","rate"]},"CreateTariffDto":{"type":"object","properties":{"name":{"type":"string","example":"Lagos Standard"},"description":{"type":"string"},"type":{"type":"string","enum":["PER_KWH","PER_MINUTE","PER_SESSION","HYBRID"]},"rate":{"type":"number","example":650,"description":"Naira charged per internal energy token (1 token = 1 kWh)."},"sessionFee":{"type":"number","example":100,"description":"Additional fixed naira charge for HYBRID tariffs."},"useTimeBasedPricing":{"type":"boolean","default":false},"periods":{"type":"array","items":{"$ref":"#/components/schemas/TariffPeriodDto"}},"scope":{"type":"string","enum":["GLOBAL","STATION","CHARGER"],"default":"GLOBAL"},"stationId":{"type":"string"},"chargerId":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","INACTIVE"],"default":"ACTIVE"},"startDate":{"type":"string","example":"2026-07-13T00:00:00.000Z"},"endDate":{"type":"string","example":"2027-07-13T00:00:00.000Z"}},"required":["name","type","rate","startDate"]},"UpdateTariffDto":{"type":"object","properties":{"name":{"type":"string","example":"Lagos Standard"},"description":{"type":"string"},"type":{"type":"string","enum":["PER_KWH","PER_MINUTE","PER_SESSION","HYBRID"]},"rate":{"type":"number","example":650,"description":"Naira charged per internal energy token (1 token = 1 kWh)."},"sessionFee":{"type":"number","example":100,"description":"Additional fixed naira charge for HYBRID tariffs."},"useTimeBasedPricing":{"type":"boolean","default":false},"periods":{"type":"array","items":{"$ref":"#/components/schemas/TariffPeriodDto"}},"scope":{"type":"string","enum":["GLOBAL","STATION","CHARGER"],"default":"GLOBAL"},"stationId":{"type":"string"},"chargerId":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","SUSPENDED","INACTIVE"],"default":"ACTIVE"},"startDate":{"type":"string","example":"2026-07-13T00:00:00.000Z"},"endDate":{"type":"string","example":"2027-07-13T00:00:00.000Z"}}},"UpdateTariffStatusDto":{"type":"object","properties":{"status":{"type":"string","enum":["ACTIVE","SUSPENDED","INACTIVE"]}},"required":["status"]},"RegisterPushDeviceTokenDto":{"type":"object","properties":{"token":{"type":"string","description":"Firebase Cloud Messaging registration token"},"platform":{"type":"string","enum":["ANDROID","IOS"]},"appVersion":{"type":"string"}},"required":["token","platform"]},"UnregisterPushDeviceTokenDto":{"type":"object","properties":{"token":{"type":"string","description":"Firebase Cloud Messaging registration token"}},"required":["token"]}}}}