---
title: "Get User By ID"
method: GET
path: "/v2/issuers/{organizationId}/users/{userId}"
tags: ["users"]
---

# Get User By ID

`GET /v2/issuers/{organizationId}/users/{userId}`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/users/{userId}`
- Auth: HTTP bearer

Call this endpoint to fetch the details on a specified user.<br/>
<br/>
<b>Required scopes:</b>&nbsp;&nbsp;`user:read`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard
- `userId` string, required: The ID of the user as defined on the issuers system

## Response `200`

Response with status 200

- UsersUserResponseObject
  - `data` UsersUserRequestDataUnion, required
    - `type` 'user', required: Discriminator value: user
    - `id` string, required: The ID of the user as defined on the issuers system
    - `attributes` UsersUserRequestAttributes, required
      - `enrolledRewards` CommonsEnrolledRewardsType[], required: Rewards programs to enroll the user in. If an empty array is supplied, the user will not be enrolled in any programs.
      - `zipCode` string: Deprecated. Use `postalCodes` instead. Zipcode of user. Cannot be sent in the same request as `postalCodes`.
      - `email` string: Email address of user
      - `hashedEmail` string: Hashed email address of user (using SHA-256)
      - `phoneNumber` string: Deprecated. Use `phoneNumbers` instead. Phone number of user in E.164 format. Cannot be sent in the same request as `phoneNumbers`.
      - `birthYear` string: Birth year of user
      - `historicalTransactionsSent` boolean: Indicates whether historical transactions have been sent for this user
      - `phoneNumbers` UsersPhoneNumber[]: Phone numbers of the user, up to 10, each in E.164 format. Replaces the deprecated `phoneNumber`, which cannot be sent in the same request. `type` is optional. When it is omitted, the first untyped number becomes `MOBILE` if the list has no `MOBILE` number, and every other untyped number becomes `OTHER`. The same number may appear under different types, but not twice under the same type.
        - `number` string, required: Phone number in E.164 format
        - `type` 'MOBILE' | 'HOME' | 'WORK' | 'OTHER': Kind of phone number. - MOBILE: the user's own mobile number. The most valuable type to send. - HOME: a household-level number - WORK: the user's work number - OTHER: any other number belonging to the user
      - `postalCodes` UsersPostalCode[]: Postal codes of the user, up to 10, each 5 digits. Replaces the deprecated `zipCode`, which cannot be sent in the same request. When a user has both, `postalCodes` takes precedence. `type` is optional. When it is omitted, the first untyped code becomes `PHYSICAL` if the list has no `PHYSICAL` code, and every other untyped code becomes `OTHER`. The same code may appear under different types, but not twice under the same type.
        - `code` string, required: 5-digit postal code
        - `type` 'PHYSICAL' | 'BILLING' | 'OTHER': Kind of postal code. - PHYSICAL: the residential postal code where the user lives. The most valuable type to send. - BILLING: the billing postal code on the user's account - OTHER: any other postal code belonging to the user

## Other responses

- `401`: Error response with status 401
- `404`: Error response with status 404
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`
- **2026-10-19** `a664c5d23771`: 4 info
  - added the optional property `data/oneOf[subschema #1]/attributes/phoneNumbers` to the response with the `200` status
  - added the optional property `data/oneOf[subschema #1]/attributes/postalCodes` to the response with the `200` status
  - response property `data/oneOf[subschema #1]/attributes/phoneNumber` deprecated
  - response property `data/oneOf[subschema #1]/attributes/zipCode` deprecated

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/users/:userId/get.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)