curl https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123 \
-H "Authorization: Bearer sk_staging_your_api_key"
curl https://services-staging.getplu.com/api/v1/partner/card/users/[email protected] \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "success",
"data": {
"serviceId": "acme-user-abc123",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Doe",
"status": "pending_kyc",
"program": "custodial",
"createdAt": "2025-01-15T10:30:00.000Z",
"verificationUrl": "https://withpersona.com/verify?inquiry-id=inq_abc123"
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
Users
Get User
Retrieve details of a specific user
GET
/
v1
/
partner
/
card
/
users
/
{serviceId}
curl https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123 \
-H "Authorization: Bearer sk_staging_your_api_key"
curl https://services-staging.getplu.com/api/v1/partner/card/users/[email protected] \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "success",
"data": {
"serviceId": "acme-user-abc123",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Doe",
"status": "pending_kyc",
"program": "custodial",
"createdAt": "2025-01-15T10:30:00.000Z",
"verificationUrl": "https://withpersona.com/verify?inquiry-id=inq_abc123"
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
Returns user details including KYC status, program type, and contact information.
string
required
Bearer token. Example:
Bearer sk_staging_your_api_keystring
required
The user’s service ID or email address.
curl https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123 \
-H "Authorization: Bearer sk_staging_your_api_key"
curl https://services-staging.getplu.com/api/v1/partner/card/users/[email protected] \
-H "Authorization: Bearer sk_staging_your_api_key"
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123',
{
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
},
}
);
{
"status": "success",
"message": "success",
"data": {
"serviceId": "acme-user-abc123",
"email": "[email protected]",
"firstName": "Jane",
"lastName": "Doe",
"status": "pending_kyc",
"program": "custodial",
"createdAt": "2025-01-15T10:30:00.000Z",
"verificationUrl": "https://withpersona.com/verify?inquiry-id=inq_abc123"
}
}
{
"status": "error",
"message": "USER_NOT_FOUND",
"data": {
"error": "User not found"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
serviceId | string | The user’s service ID |
email | string | User’s email address |
firstName | string | User’s first name |
lastName | string | User’s last name |
status | string | KYC status: pending, pending_kyc, approved, denied |
program | string | Card program: custodial or non_custodial |
createdAt | string | ISO 8601 timestamp of user creation |
verificationUrl | string | KYC verification link. Present when the user has initiated KYC. |
⌘I