---
title: "Retrieve an account by RFID"
method: GET
path: "/api/v2/accounts/rfid/{rfid}"
tags: ["Member RFIDs", "Member Account"]
---

# Retrieve an account by RFID

`GET /api/v2/accounts/rfid/{rfid}`

Retrieve an account using RFID.

## Path parameters

- `rfid` string, required

## Query parameters

- `tagFormat` 'HITAG1' | 'MIFARE' | 'LEGIC'

## Response `200`

Ok

- MemberAccountDTO
  - `accountId` string — The EGYM account ID for the Gym Member.
  - `email` string, required — The Member email address. It should be unique within the gym chain.
  - `firstName` string, required — The Member first name.
  - `lastName` string, required — The Member last name.
  - `dateOfBirth` string, date — The Member date of birth. format: yyyy-MM-dd
  - `gender` 'MALE' | 'FEMALE' | 'NON_BINARY', required — The Member gender. Please note that NON_BINARY is not correctly supported yet, we send it as FEMALE for the usage of the machines.
  - `contact` ContactDTO
    - `phone` string — The Member telephone number.
    - `street` string — Street name in member's address.
    - `streetNumber` string — Street number in member's address.
    - `zipCode` string — Zip Code in member's address.
    - `city` string — City in member's address.
    - `state` string — State in member's address.
    - `country` string — Country of the member's address in ISO 3166-1 alpha-2.
  - `membership` MembershipDTO, required
    - `membershipId` string, required — Member ID in the gym software. It must be unique for exactly one member in the gym chain.
    - `agreementNumber` string — The agreement number is the number of the membership between the member and the gym chain.
    - `membershipType` 'BASIC' | 'PREMIUM' | 'PROSPECT' | 'CORPORATE_FITNESS', required — Type of the member's membership to determine available features.
    - `membershipSubType` string — Extension of membershipStatus for further customization for this user. One membershipStatus can have multiple membershipSubType.
    - `endOfContract` string, date — Date when the member's contract ends. For gyms with automatic contract renewal, send the date when the contract would run out, if cancelled. Update the field when the contract was renewed (manually and automatically renewals). format: yyyy-MM-dd. Must be on or after startOfContract if provided.
    - `startOfContract` string, date, required — The date when the membership started. format: yyyy-MM-dd
    - `referringMemberId` string — MembershipId of the member who referred this member.
    - `barcode` string — Member's barcode to check-in in the gym. Can be visualised on the Branded Member App and used for lookup to verify membership.
    - `verificationTAN` string — Mandatory when creating new membership of type 'CORPORATE_FITNESS' or when updating membership to 'CORPORATE_FITNESS'. Member's verification TAN. Can be visualised on the Qualitrain Member App and used for Qualitrain Membership verification.
    - `corporateFitness` CorporateFitnessDTO
      - `startTimestamp` string — The date (in ISO format) when the corporate fitness (Qualitrain/Wellpass) membership will start, in case that is in the future. This field will not be returned in case of an active or past corporate fitness membership.
      - `endTimestamp` string — The date (in ISO format) when the corporate fitness (Qualitrain/Wellpass) membership ends. This field is only returned in case there is a defined end timestamp for the corporate fitness membership.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/egym/apis/mms-api-v2.md) · [All operations](https://skmtc.net/egym/apis/mms-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/egym/mms-api-v2/versions/07d571d34bd8/schema)