# Asiko API > Reference documentation for the Asiko e-commerce platform API — retail, wholesale, orders, payments, loyalty, and real-time notifications. ## Docs - [Add a new address](https://secdocs.asikoexpress.com/api-reference/addresses/add-a-new-address.md) - [Delete an address](https://secdocs.asikoexpress.com/api-reference/addresses/delete-an-address.md) - [List my addresses](https://secdocs.asikoexpress.com/api-reference/addresses/list-my-addresses.md) - [Set an address as the default](https://secdocs.asikoexpress.com/api-reference/addresses/set-an-address-as-the-default.md) - [Update an address](https://secdocs.asikoexpress.com/api-reference/addresses/update-an-address.md) - [Approve a pending trade account](https://secdocs.asikoexpress.com/api-reference/admin-trade-accounts/approve-a-pending-trade-account.md) - [Assign role to user (Super Admin only)](https://secdocs.asikoexpress.com/api-reference/admin-users/assign-role-to-user-super-admin-only.md) - [Deactivate user](https://secdocs.asikoexpress.com/api-reference/admin-users/deactivate-user.md) - [Get user by ID](https://secdocs.asikoexpress.com/api-reference/admin-users/get-user-by-id.md) - [List all users](https://secdocs.asikoexpress.com/api-reference/admin-users/list-all-users.md) - [Reactivate user](https://secdocs.asikoexpress.com/api-reference/admin-users/reactivate-user.md) - [Remove role from user (Super Admin only)](https://secdocs.asikoexpress.com/api-reference/admin-users/remove-role-from-user-super-admin-only.md) - [Suspend user](https://secdocs.asikoexpress.com/api-reference/admin-users/suspend-user.md) - [Approve a pending wholesale application — sends the applicant a set-password code](https://secdocs.asikoexpress.com/api-reference/admin-wholesale/approve-a-pending-wholesale-application-—-sends-the-applicant-a-set-password-code.md) - [List wholesale applications, optionally filtered by review status](https://secdocs.asikoexpress.com/api-reference/admin-wholesale/list-wholesale-applications-optionally-filtered-by-review-status.md) - [Reject a pending wholesale application](https://secdocs.asikoexpress.com/api-reference/admin-wholesale/reject-a-pending-wholesale-application.md) - [[DEMO] Dashboard summary](https://secdocs.asikoexpress.com/api-reference/analytics/[demo]-dashboard-summary.md) - [[DEMO] Revenue snapshots](https://secdocs.asikoexpress.com/api-reference/analytics/[demo]-revenue-snapshots.md) - [Disable TOTP 2FA](https://secdocs.asikoexpress.com/api-reference/auth/disable-totp-2fa.md) - [Generate TOTP secret and QR code](https://secdocs.asikoexpress.com/api-reference/auth/generate-totp-secret-and-qr-code.md) - [Login with email/password (+ optional TOTP for admins)](https://secdocs.asikoexpress.com/api-reference/auth/login-with-emailpassword-+-optional-totp-for-admins.md) - [Register a new retail account (sends an email verification code)](https://secdocs.asikoexpress.com/api-reference/auth/register-a-new-retail-account-sends-an-email-verification-code.md) - [Register a new trade account (pending approval)](https://secdocs.asikoexpress.com/api-reference/auth/register-a-new-trade-account-pending-approval.md) - [Request a password reset OTP code (rate-limited)](https://secdocs.asikoexpress.com/api-reference/auth/request-a-password-reset-otp-code-rate-limited.md) - [Resend the email verification OTP code (rate-limited)](https://secdocs.asikoexpress.com/api-reference/auth/resend-the-email-verification-otp-code-rate-limited.md) - [Reset password using the OTP code from forgot-password](https://secdocs.asikoexpress.com/api-reference/auth/reset-password-using-the-otp-code-from-forgot-password.md) - [Revoke all tokens for current user](https://secdocs.asikoexpress.com/api-reference/auth/revoke-all-tokens-for-current-user.md) - [Rotate refresh token and get new access token](https://secdocs.asikoexpress.com/api-reference/auth/rotate-refresh-token-and-get-new-access-token.md) - [Verify a registration email OTP code and log in](https://secdocs.asikoexpress.com/api-reference/auth/verify-a-registration-email-otp-code-and-log-in.md) - [Verify TOTP code and enable 2FA](https://secdocs.asikoexpress.com/api-reference/auth/verify-totp-code-and-enable-2fa.md) - [Get brand by ID](https://secdocs.asikoexpress.com/api-reference/brands/get-brand-by-id.md) - [List brands with product counts](https://secdocs.asikoexpress.com/api-reference/brands/list-brands-with-product-counts.md) - [[DEMO] Create discount code](https://secdocs.asikoexpress.com/api-reference/campaigns/[demo]-create-discount-code.md) - [[DEMO] List campaigns](https://secdocs.asikoexpress.com/api-reference/campaigns/[demo]-list-campaigns.md) - [[DEMO] Validate discount code](https://secdocs.asikoexpress.com/api-reference/campaigns/[demo]-validate-discount-code.md) - [Add an item to the cart](https://secdocs.asikoexpress.com/api-reference/cart/add-an-item-to-the-cart.md) - [Get current cart](https://secdocs.asikoexpress.com/api-reference/cart/get-current-cart.md) - [Remove an item from the cart](https://secdocs.asikoexpress.com/api-reference/cart/remove-an-item-from-the-cart.md) - [Get category by ID](https://secdocs.asikoexpress.com/api-reference/categories/get-category-by-id.md) - [List categories as a tree](https://secdocs.asikoexpress.com/api-reference/categories/list-categories-as-a-tree.md) - [Get a saved recipient by ID](https://secdocs.asikoexpress.com/api-reference/customers/get-a-saved-recipient-by-id.md) - [List saved recipients — people you have checked out orders for who are not yourself](https://secdocs.asikoexpress.com/api-reference/customers/list-saved-recipients-—-people-you-have-checked-out-orders-for-who-are-not-yourself.md) - [Create brand (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/create-brand-admin-only.md) - [Create category (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/create-category-admin-only.md) - [Create product (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/create-product-admin-only.md) - [Delete brand (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/delete-brand-admin-only.md) - [Delete category (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/delete-category-admin-only.md) - [Delete product (Admin only) — deactivates it rather than a hard delete](https://secdocs.asikoexpress.com/api-reference/inventory/delete-product-admin-only-—-deactivates-it-rather-than-a-hard-delete.md) - [Update brand (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/update-brand-admin-only.md) - [Update category (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/update-category-admin-only.md) - [Update product (Admin only)](https://secdocs.asikoexpress.com/api-reference/inventory/update-product-admin-only.md) - [Get full invoice details by ID](https://secdocs.asikoexpress.com/api-reference/invoices/get-full-invoice-details-by-id.md) - [List invoices for the current wholesale account](https://secdocs.asikoexpress.com/api-reference/invoices/list-invoices-for-the-current-wholesale-account.md) - [Get loyalty points summary (available, earned, redeemed, membership date, discount value)](https://secdocs.asikoexpress.com/api-reference/loyalty/get-loyalty-points-summary-available-earned-redeemed-membership-date-discount-value.md) - [Get points history (earned/redeemed activity log)](https://secdocs.asikoexpress.com/api-reference/loyalty/get-points-history-earnedredeemed-activity-log.md) - [Record a product share and award points](https://secdocs.asikoexpress.com/api-reference/loyalty/record-a-product-share-and-award-points.md) - [Redeem points for a discount value (minimum 500 points, 2000 points = 7.5 EUR)](https://secdocs.asikoexpress.com/api-reference/loyalty/redeem-points-for-a-discount-value-minimum-500-points-2000-points-=-75-eur.md) - [Upload a product image to object storage](https://secdocs.asikoexpress.com/api-reference/media/upload-a-product-image-to-object-storage.md) - [List in-app notifications for the current user](https://secdocs.asikoexpress.com/api-reference/notifications/list-in-app-notifications-for-the-current-user.md) - [Send a notification (real delivery for EMAIL channel with email+html supplied)](https://secdocs.asikoexpress.com/api-reference/notifications/send-a-notification-real-delivery-for-email-channel-with-email+html-supplied.md) - [Advance the delivery tracking status for an order (Admin only)](https://secdocs.asikoexpress.com/api-reference/orders/advance-the-delivery-tracking-status-for-an-order-admin-only.md) - [Cancel an order (only while it is awaiting payment)](https://secdocs.asikoexpress.com/api-reference/orders/cancel-an-order-only-while-it-is-awaiting-payment.md) - [Check out the current cart into an order](https://secdocs.asikoexpress.com/api-reference/orders/check-out-the-current-cart-into-an-order.md) - [Get full order details by ID](https://secdocs.asikoexpress.com/api-reference/orders/get-full-order-details-by-id.md) - [Get the delivery tracking timeline for an order](https://secdocs.asikoexpress.com/api-reference/orders/get-the-delivery-tracking-timeline-for-an-order.md) - [List orders for the current user](https://secdocs.asikoexpress.com/api-reference/orders/list-orders-for-the-current-user.md) - [Mark an order as paid (called by payment-service)](https://secdocs.asikoexpress.com/api-reference/orders/mark-an-order-as-paid-called-by-payment-service.md) - [Wholesale account overview: lifetime order total and next delivery slot](https://secdocs.asikoexpress.com/api-reference/orders/wholesale-account-overview:-lifetime-order-total-and-next-delivery-slot.md) - [[DEMO] Create payment intent](https://secdocs.asikoexpress.com/api-reference/payments/[demo]-create-payment-intent.md) - [[DEMO] Get payment by ID](https://secdocs.asikoexpress.com/api-reference/payments/[demo]-get-payment-by-id.md) - [Browse products — search, filter (category/brand/price/pack size/dietary/rating), sort, and facet counts](https://secdocs.asikoexpress.com/api-reference/products/browse-products-—-search-filter-categorybrandpricepack-sizedietaryrating-sort-and-facet-counts.md) - [Full-text product search](https://secdocs.asikoexpress.com/api-reference/products/full-text-product-search.md) - [Get product by ID](https://secdocs.asikoexpress.com/api-reference/products/get-product-by-id.md) - [Cheapest active products](https://secdocs.asikoexpress.com/api-reference/recommendations/cheapest-active-products.md) - [Most recently added products](https://secdocs.asikoexpress.com/api-reference/recommendations/most-recently-added-products.md) - [Personalized picks (falls back to best-sellers for guests / no history)](https://secdocs.asikoexpress.com/api-reference/recommendations/personalized-picks-falls-back-to-best-sellers-for-guests-no-history.md) - [Products currently on a time-boxed sale](https://secdocs.asikoexpress.com/api-reference/recommendations/products-currently-on-a-time-boxed-sale.md) - [Products tagged as everyday staples](https://secdocs.asikoexpress.com/api-reference/recommendations/products-tagged-as-everyday-staples.md) - [Products the current user has recently viewed](https://secdocs.asikoexpress.com/api-reference/recommendations/products-the-current-user-has-recently-viewed.md) - [Top products by sales volume](https://secdocs.asikoexpress.com/api-reference/recommendations/top-products-by-sales-volume.md) - [You might also like — same category as this product](https://secdocs.asikoexpress.com/api-reference/recommendations/you-might-also-like-—-same-category-as-this-product.md) - [Get referral code, totals (successful referrals, rewards earned), and referral history](https://secdocs.asikoexpress.com/api-reference/referrals/get-referral-code-totals-successful-referrals-rewards-earned-and-referral-history.md) - [Create a review (one per user per product)](https://secdocs.asikoexpress.com/api-reference/reviews/create-a-review-one-per-user-per-product.md) - [List reviews for a product](https://secdocs.asikoexpress.com/api-reference/reviews/list-reviews-for-a-product.md) - [Join the email subscriber list (sends a confirmation email)](https://secdocs.asikoexpress.com/api-reference/subscribers/join-the-email-subscriber-list-sends-a-confirmation-email.md) - [Change password (revokes all other sessions on success)](https://secdocs.asikoexpress.com/api-reference/users/change-password-revokes-all-other-sessions-on-success.md) - [Get current user profile](https://secdocs.asikoexpress.com/api-reference/users/get-current-user-profile.md) - [Update account: profile fields, push-notification toggle, and/or add delivery addresses — each key optional](https://secdocs.asikoexpress.com/api-reference/users/update-account:-profile-fields-push-notification-toggle-andor-add-delivery-addresses-—-each-key-optional.md) - [[DEMO] Paystack webhook endpoint](https://secdocs.asikoexpress.com/api-reference/webhooks/[demo]-paystack-webhook-endpoint.md) - [[DEMO] Stripe webhook endpoint](https://secdocs.asikoexpress.com/api-reference/webhooks/[demo]-stripe-webhook-endpoint.md) - [Get the current wholesale account and business information](https://secdocs.asikoexpress.com/api-reference/wholesale/get-the-current-wholesale-account-and-business-information.md) - [Set your password using the code emailed after your application's approval](https://secdocs.asikoexpress.com/api-reference/wholesale/set-your-password-using-the-code-emailed-after-your-applications-approval.md) - [Submit a wholesale account application](https://secdocs.asikoexpress.com/api-reference/wholesale/submit-a-wholesale-account-application.md): No password is collected here. Submitting returns a tracking ID (e.g. CRA-2658190) — the application goes under review, and an email with a set-password code is sent once an admin approves it. - [Update business information (each field optional)](https://secdocs.asikoexpress.com/api-reference/wholesale/update-business-information-each-field-optional.md) - [Add an item to the wishlist](https://secdocs.asikoexpress.com/api-reference/wishlist/add-an-item-to-the-wishlist.md) - [List items on the current wishlist](https://secdocs.asikoexpress.com/api-reference/wishlist/list-items-on-the-current-wishlist.md) - [Remove an item from the wishlist](https://secdocs.asikoexpress.com/api-reference/wishlist/remove-an-item-from-the-wishlist.md) - [Authentication](https://secdocs.asikoexpress.com/authentication.md): JWT-based authentication, email verification, roles, and 2FA - [Domain Events Catalog](https://secdocs.asikoexpress.com/domain-events.md): Every internal event the platform defines, and exactly what happens when each fires - [Internal & Non-Exposed Endpoints](https://secdocs.asikoexpress.com/internal-endpoints.md): Routes that exist in the codebase but are not reachable through the public gateway - [Introduction](https://secdocs.asikoexpress.com/introduction.md): Everything you need to integrate with the Asiko platform API - [Rate Limiting](https://secdocs.asikoexpress.com/rate-limiting.md): Request limits enforced at the gateway - [Real-time Notifications](https://secdocs.asikoexpress.com/realtime-notifications.md): WebSocket push for in-app notifications and admin alerts - [Response Format & Errors](https://secdocs.asikoexpress.com/response-format.md): The standard success envelope, pagination shape, and error format used everywhere ## OpenAPI Specs - [user-service](https://secdocs.asikoexpress.com/openapi/user-service.json) - [product-service](https://secdocs.asikoexpress.com/openapi/product-service.json) - [product-service-inventory](https://secdocs.asikoexpress.com/openapi/product-service-inventory.json) - [payment-service](https://secdocs.asikoexpress.com/openapi/payment-service.json) - [order-service](https://secdocs.asikoexpress.com/openapi/order-service.json) - [engagement-service](https://secdocs.asikoexpress.com/openapi/engagement-service.json) - [admin-service](https://secdocs.asikoexpress.com/openapi/admin-service.json)