> ## Documentation Index > Fetch the complete documentation index at: https://docs.spurtcommerce.com/llms.txt > Use this file to discover all available pages before exploring further. # Register a Store customer after OTP verification. > Register a Store customer after OTP verification. **Authentication:** Public; tenant validation applies. **Feature area:** Authentication **Implementation source:** `src/api/store/controllers/CustomerController.ts` **Request example provenance:** Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. **Response example provenance:** Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. > Example is based on the linked repository source. Replace example identifiers and credentials with values from your tenant. ## OpenAPI ````yaml /StoreAPI.json post /api/customer/register openapi: 3.0.3 info: title: SpurtCommerce Store API version: 6.0.0 description: >- Store API reference generated from the public SpurtCommerce repository (master, package version 6.0.0). Route inventory, controller annotations, request examples and response examples were used where available. Examples that are not explicitly defined by source annotations are marked illustrative in the operation description. This specification excludes Admin APIs. license: name: MIT url: https://github.com/spurtcommerce/spurtcommerce/blob/master/LICENSE servers: - url: https://api.example.com description: Replace with your SpurtCommerce API host. Paths include the /api prefix. security: [] tags: - name: Store description: Store API endpoint reference, organized by functional topic. - name: Cart description: >- Retrieve, create, update, and clear the authenticated customer shopping cart. x-parent: Store x-displayName: Cart - name: Customer address description: >- Create, retrieve, and manage customer addresses and live-address settings used during checkout. x-parent: Store x-displayName: Customer address - name: Customer profile description: >- Retrieve and update the signed-in customer profile and read customer permission modules and assignments. x-parent: Store x-displayName: Customer profile - name: Authentication description: >- Register customers, send and verify OTPs, sign in, sign out, and authenticate through supported OAuth providers. x-parent: Store x-displayName: Authentication - name: Wishlist description: >- Add products to the customer wishlist, list saved items, and remove wishlist entries. x-parent: Store x-displayName: Wishlist - name: Product discovery description: >- Discover products and categories, retrieve product details, compare products, and inspect filters, attributes, and variants. x-parent: Store x-displayName: Product discovery - name: Orders description: >- Retrieve order details and payment status, request cancellations, track shipments, download invoices, and retry payments. x-parent: Store x-displayName: Orders - name: Store content description: >- Retrieve storefront settings, categories, languages, zones, payment methods, CMS pages, banners, widgets, and contact information. x-parent: Store x-displayName: Store content - name: Payments description: >- Start supported Store payment flows for existing orders through PayPal, Razorpay, and Stripe. x-parent: Store x-displayName: Payments - name: Ratings and reviews description: >- Retrieve product rating counts, rating distributions, and customer reviews for product SKUs. x-parent: Store x-displayName: Ratings and reviews - name: Products x-parent: Product discovery description: Browse product listings and retrieve product details. - name: Categories x-parent: Product discovery description: Browse storefront product categories and category filters. - name: Product comparison x-parent: Product discovery description: Compare products and retrieve related product suggestions. - name: Attributes and variants x-parent: Product discovery description: Retrieve product attributes and variant options. - name: Product ratings and reviews x-parent: Product discovery description: Retrieve product ratings, statistics and customer reviews. - name: Customer login and sessions x-parent: Authentication description: Register, authenticate and sign out customer accounts. - name: OTP and verification x-parent: Authentication description: Send and verify one-time passwords for customer authentication. - name: OAuth authentication x-parent: Authentication description: Authenticate customers through supported OAuth providers. - name: Customer permissions x-parent: Customer profile description: Retrieve customer permission modules and assignments. - name: Address book x-parent: Customer address description: Manage customer delivery and billing addresses. - name: Cart items x-parent: Cart description: Retrieve, create and remove shopping cart items. - name: Order details and tracking x-parent: Orders description: Retrieve order details, tracking and payment status. - name: Order cancellation x-parent: Orders description: Retrieve cancellation reasons and submit cancellation requests. - name: Order payments x-parent: Orders description: Retry order payments and retrieve payment status. - name: Payment gateways x-parent: Payments description: Start Store payment flows for supported payment gateways. - name: Store configuration x-parent: Store content description: Retrieve storefront settings, payment methods and configuration. - name: Navigation and widgets x-parent: Store content description: Retrieve storefront banners, widgets and navigation data. - name: Localization x-parent: Store content description: Retrieve available languages, zones and localization options. - name: Contact and store information x-parent: Store content description: Retrieve store contact information and public store metadata. - name: Store pages x-parent: Store content description: Retrieve published storefront content pages. paths: /api/customer/register: post: tags: - Customer login and sessions summary: Register a Store customer after OTP verification. description: >- Register a Store customer after OTP verification. **Authentication:** Public; tenant validation applies. **Feature area:** Authentication **Implementation source:** `src/api/store/controllers/CustomerController.ts` **Request example provenance:** Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. **Response example provenance:** Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. > Example is based on the linked repository source. Replace example identifiers and credentials with values from your tenant. operationId: postApiCustomerRegister requestBody: required: true description: >- Request body follows the current CustomerRegisterRequest DTO. Required fields and password constraints are taken from class-validator decorators. content: application/json: schema: type: object properties: firstName: type: string maxLength: 32 description: Required. Customer first name. lastName: type: string description: Optional. Customer last name. companyName: type: string taxNumber: type: string password: type: string format: password minLength: 8 maxLength: 128 writeOnly: true description: >- Required. At least 8 characters; must include uppercase and lowercase letters and a number or symbol. emailId: type: string maxLength: 96 description: Required. Customer email address. otp: type: integer description: Required. OTP sent to the email address. phoneNumber: type: string maxLength: 15 description: Optional. Customer phone number. additionalProperties: true required: - firstName - password - emailId - otp examples: sample: summary: Sample request value: firstName: Asha lastName: Kumar password: emailId: asha@example.com otp: 123456 phoneNumber: '9876543210' responses: '200': description: >- Successful response. Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. content: application/json: schema: type: object properties: status: type: integer message: type: string data: type: object properties: firstName: type: string lastName: type: string emailId: type: string additionalProperties: true additionalProperties: true examples: success: summary: Sample success response value: status: 1 message: Successfully Created Registration data: firstName: Asha lastName: Kumar emailId: customer@example.com '400': description: >- Error response example. Request fields are from CustomerRegisterRequest; success wrapper is from the handler, with PII-safe example values. content: application/json: schema: type: object properties: status: type: integer message: type: string additionalProperties: true examples: error: summary: Sample error response value: status: 0 message: Please enter a valid OTP externalDocs: description: Open implementation source in GitHub url: >- https://github.com/spurtcommerce/spurtcommerce/blob/master/src/api/store/controllers/CustomerController.ts x-codeSamples: - lang: HTTP label: HTTP source: |- POST /api/customer/register HTTP/1.1 Host: Accept: application/json Content-Type: application/json { "firstName": "Asha", "lastName": "Kumar", "password": "", "emailId": "asha@example.com", "otp": 123456, "phoneNumber": "9876543210" } - lang: bash label: cURL source: |- curl --request POST \ 'https:///api/customer/register' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data-raw '{ "firstName": "Asha", "lastName": "Kumar", "password": "", "emailId": "asha@example.com", "otp": 123456, "phoneNumber": "9876543210" }' - lang: JavaScript label: JavaScript (fetch) source: >- const API_BASE_URL = 'https://'; const url = new URL("/api/customer/register", API_BASE_URL); const headers = { "Accept": "application/json", "Content-Type": "application/json" }; const body = { "firstName": "Asha", "lastName": "Kumar", "password": "", "emailId": "asha@example.com", "otp": 123456, "phoneNumber": "9876543210" }; const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) }); const result = await response.json(); console.log(response.status, result); - lang: JavaScript label: Node.js (Axios) source: >- import axios from 'axios'; const API_BASE_URL = 'https://'; const url = `${API_BASE_URL}/api/customer/register`; const API_BASE_URL = 'https://'; const url = `${API_BASE_URL}/api/customer/register`; const headers = { "Accept": "application/json", "Content-Type": "application/json" }; const data = { "firstName": "Asha", "lastName": "Kumar", "password": "", "emailId": "asha@example.com", "otp": 123456, "phoneNumber": "9876543210" }; const response = await axios.request({ method: "POST", url, headers, data }); console.log(response.status, response.data); - lang: Python label: Python (requests) source: >- import requests url = 'https:///api/customer/register' headers = {'Accept': 'application/json', 'Content-Type': 'application/json'} payload = {'firstName': 'Asha', 'lastName': 'Kumar', 'password': '', 'emailId': 'asha@example.com', 'otp': 123456, 'phoneNumber': '9876543210'} response = requests.request('POST', url, headers=headers, params=None, json=payload) print(response.status_code) print(response.json()) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.