Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Register Guest

Developing

POST

{store_url}/api/v1/auth/register/guest

Creates a guest customer account without requiring the customer to complete the standard registration and verification process. This endpoint can be used during guest checkout to associate customer information with the current session.

Request

Body Params application/jsonRequired

Example

{
    "name": "Guest",
    "email": "guest@example.com",
    "mobile_number": "501234567",
    "country_code": "+966",
    "override_required_shipping": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{store_url}/api/v1/auth/register/guest' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Guest",
    "email": "guest@example.com",
    "mobile_number": "501234567",
    "country_code": "+966",
    "override_required_shipping": true
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "login_type": "signup",
    "status": "registration_needed",
    "channel": "sms",
    "mobile_number": "501234567",
    "country_code": "+966",
    "email": "guest@example.com",
    "mobile": "+966501234567",
    "email_exists": false,
    "sent_at": "2026-06-21T10:30:00Z",
    "cart_session_id": "cart_session_8f7c2a91",
    "is_active_abandoned_cart_merged": true,
    "customer_id": 12345,
    "has_addresses": false,
    "property1": {},
    "property2": {}
}

🟠422

Modified at 2026-06-21 11:00:53

List Products