Request identity verification (PASS)

POST

/v1/auth/pass

curl --request POST \
  --url https://api.parasta.io/v1/auth/pass \
  --header 'Accept-Language: ko' \
  --header 'Content-Type: application/json' \
  --header 'X-Device-Id: example' \
  --data '{ "purpose": "register", "returnUrl": "https://example.com" }'

• API base URL (example — actual domain is finalized at deployment). All API paths start with `/v1/...`, so the actual endpoint takes the form `https://api.parasta.io/v1/...`.
• Relative.

Start an identity verification session. Mock in M1.

Parameters

Header Parameters

X-Device-Id

required

string

Device identifier generated as UUIDv4 on the client’s first launch.

Accept-Language

string

default: ko

Allowed values: ko en

Request Body ^required

Media type application/json

object

purpose

required

string

Allowed values: register login phone_change unlock

returnUrl

required

Universal Link / App Links (HTTPS).

string format: uri

Responses

200

OK

Media type application/json

object

passRequestId

required

string

redirectUrl

required

string format: uri

Example ^generated

{
  "passRequestId": "example",
  "redirectUrl": "https://example.com"
}

default

Error

Media type application/json

object

code

required

Error code prefixed with the service namespace (AUTH_, ACCOUNT_, WALLET_, DID_, ASSET_, TRANSFER_, EXCHANGE_).

string

message

required

string

details

object

key

additional properties

any

Example ^generated

{
  "code": "example",
  "message": "example",
  "details": {}
}