Login

POST

/v1/auth/login

curl --request POST \
  --url https://api.parasta.io/v1/auth/login \
  --header 'Content-Type: application/json' \
  --header 'X-Device-Id: example' \
  --data '{ "passToken": "example", "method": "pin", "credential": { "pin": "example", "passkeyResponse": {} } }'

• 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.

Parameters

Header Parameters

X-Device-Id

required

string

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

Request Body ^required

Media type application/json

object

passToken

Required for first login on a new device.

string

method

required

string

Allowed values: pin passkey

credential

required

object

pin

Hashed PIN value

string

passkeyResponse

object

key

additional properties

any

Responses

200

OK

Media type application/json

object

accessToken

required

string

refreshToken

required

string

expiresIn

required

integer

user

required

object

id

string

name

string

status

string

Allowed values: active suspended

sessionReplaced

Whether the prior session was forcibly terminated.

boolean

Example

{
  "user": {
    "status": "active"
  }
}

401

Authentication failed / unregistered device

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": {}
}

403

Account suspended

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": {}
}

423

Account locked

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": {}
}