Skip to main content
POST
/
api
/
auth
/
login
Login (Create Session)
curl --request POST \
  --url https://sandbox.finhub.cloud/api/auth/login \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-For: <x-forwarded-for>' \
  --header 'X-Forwarded-From: <x-forwarded-from>' \
  --header 'X-Tenant-ID: <x-tenant-id>' \
  --header 'deviceId: <deviceid>' \
  --header 'platform: <platform>' \
  --data '
{
  "email": "cards_test@fincard-test.finhub.cloud",
  "password": "Cards@Test2025!",
  "tenantId": "tenant_fincard_test"
}
'
{
  "code": 200,
  "data": {
    "token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
    "refreshToken": "dGhpcyBpcyBhIHJlZnJlc2ggdG9rZW4...",
    "expiresAt": "2025-01-15T12:00:00Z",
    "userId": "87b3af37-4ac1-402b-a0ea-53cfdc695e02",
    "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Headers

X-Tenant-ID
string
required

Tenant identifier

Example:

"tenant_fincard_test"

X-Forwarded-For
string
required

Client IP address

Example:

"192.168.0.1"

X-Forwarded-From
string
required

Client application identifier

Example:

"playground"

platform
string
required

Client platform

Example:

"web"

deviceId
string
required

Device identifier

Example:

"e2e-test-device"

User-Agent
string
Example:

"Mozilla/5.0"

Body

application/json
email
string
required

User email address

Example:

"cards_test@fincard-test.finhub.cloud"

password
string
required

User password

Example:

"Cards@Test2025!"

tenantId
string
required

Tenant identifier (must match X-Tenant-ID header)

Example:

"tenant_fincard_test"

Response

Session created — JWT token returned

code
integer
Example:

200

data
object