> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getplu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get User

> Retrieve details of a specific user

Returns user details including KYC status, program type, and contact information.

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer sk_staging_your_api_key`
</ParamField>

<ParamField path="serviceId" type="string" required>
  The user's service ID or email address.
</ParamField>

<RequestExample>
  ```bash cURL (by service ID) theme={null}
  curl https://services-staging.getplu.com/api/v1/partner/card/users/acme-user-abc123 \
    -H "Authorization: Bearer sk_staging_your_api_key"
  ```

  ```bash cURL (by email) theme={null}
  curl https://services-staging.getplu.com/api/v1/partner/card/users/jane@example.com \
    -H "Authorization: Bearer sk_staging_your_api_key"
  ```

  ```javascript JavaScript theme={null}
  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',
      },
    }
  );
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "status": "success",
    "message": "success",
    "data": {
      "serviceId": "acme-user-abc123",
      "email": "jane@example.com",
      "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"
    }
  }
  ```

  ```json 404 theme={null}
  {
    "status": "error",
    "message": "USER_NOT_FOUND",
    "data": {
      "error": "User not found"
    }
  }
  ```
</ResponseExample>

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