Skip to main content
POST
/
marketplace
/
user
/
auth
cURL
curl --request POST \
  --url https://api.sandbox.external.bnznow.com/marketplace/user/auth \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-body-signature: <x-body-signature>' \
  --data '
{
  "unique_id": "<string>",
  "email": "<string>",
  "govt_id": "<string>",
  "user_type": "company",
  "name": "<string>"
}
'
{
  "redirect_url": "<string>",
  "registered_id": "<string>",
  "expires_in": 123
}

Headers

​
x-api-key
string
required

API key for authentication

​
x-body-signature
string
required

Signature of the request body signed with API secret (private key)

Body

application/json

User authentication details

​
unique_id
string
required

Unique identifier for the user in your system (user_id, company_id, etc)

​
email
string
required

Email address of the user

​
govt_id
string
required

Government ID (Aadhar, CIN)

​
user_type
enum<string>
required

Type of user

Available options:
company,
individual
​
name
string

User's full name

Response

Authentication redirect URL

​
redirect_url
string

URL to redirect the user for authentication

​
registered_id
string

Registered ID of the user on BNZ Green

​
expires_in
integer

Time in seconds until the redirect URL expires