Get Cardholder by Cardholder ID
Send a request to this endpoint to retrieve details of a cardholder.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Optional audit user header
Path Parameters
Enfuce generated unique ID of the cardholder that you want to retrieve.
Response
Successful retrieval of cardholder details.
Enfuce generated unique identifier of the cardholder.
"20218aae-b15e-406c-9e9f-23735cd86a48"
External unique identifier of the cardholder, set by the issuer. Can contain both letters and numbers. Max character limit is 36.
1 - 36^[A-Za-z0-9-]+$"ABCDEFGH123456789"
Cardholder's language and country code in RFC 5646 format.
af-ZA, ar-AE, ar-BH, ar-DZ, ar-EG, ar-IQ, ar-JO, ar-KW, ar-LB, ar-LY, ar-MA, ar-OM, ar-QA, ar-SA, ar-SY, ar-TN, ar-YE, az-AZ, be-BY, bg-BG, bn-IN, bs-BA, ca-ES, cs-CZ, cy-GB, da-DK, de-AT, de-CH, de-DE, de-LI, de-NL, el-GR, en-AU, en-BZ, en-CA, en-GB, en-IE, en-JM, en-MT, en-NZ, en-PH, en-TT, en-US, en-VI, en-ZA, en-ZW, es-AR, es-BO, es-CL, es-CO, es-CR, es-DO, es-EC, es-ES, es-GT, es-HN, es-MX, es-NI, es-PA, es-PE, es-PR, es-PY, es-SV, es-UY, es-VE, et-EE, eu-ES, fa-IR, fi-FI, fo-FO, fr-BE, fr-CA, fr-CH, fr-FR, fr-MC, fr-NL, ga-IE, gl-ES, gu-IN, he-IL, hi-IN, hr-HR, hu-HU, hy-AM, id-ID, is-IS, it-CH, it-IT, ja-JP, ka-GE, kk-KZ, kl-GL, kn-IN, ko-KR, kok-IN, lt-LT, lv-LV, mk-MK, ml-IN, mn-MN, mr-IN, ms-BN, ms-MY, mt-MT, nb-NO, nl-BE, nl-NL, nn-NO, no-NO, pa-IN, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, se-NO, sk-SK, sl-SI, sq-AL, sr-BA, sr-CS, sv-FI, sv-SE, sw-KE, syr-SY, ta-IN, te-IN, th-TH, tn-ZA, tr-TR, uk-UA, uz-UZ, vi-VN, xh-ZA, zh-CN, zh-HK, zh-MO, zh-SG, zh-TW, zu-ZA "en-GB"
Mobile number of the cardholder — it must be a full number, including the country code and starting with +.
([+]){1}([1-9]){1}([0-9]){5,14}"+358401234567"
First name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"John"
Middle name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"James"
Last name of the cardholder. Max character limit is 256.
1 - 256^(?!\s)(?!.*\s$)(?! *$)[A-Za-z0-9 ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ'\-]+$"Doe"
The date and time when the card was created.
The date and time when the object/entity was updated last time.
The version number of the entity.
1
Email address of the cardholder. Max character limit is 256.
1 - 256"john.doe@test.com"
Tax Identification Number used for taxation, regulatory reporting, or authority requirements in many countries. Depending on regional regulatory or scheme mandates (for example Brazil requirements), this value may be forwarded to Mastercard. In some countries, this value may be the same as the customer registration or identification number (identificationNumber). Omit to keep current value.
1 - 64"ABCDEFGH123456789"
Date of birth of the cardholder. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
"1935-01-15"
Nationality of the cardholder. Maximum of 3 values. Duplicate values are not allowed. XXX may be used when nationality is unknown. XKX may be used for Kosovo. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
3ISO 3166-1 alpha-3 country codes. XKX is used for the Kosovo.
ABW, AFG, AGO, AIA, ALA, ALB, AND, ARE, ARG, ARM, ASM, ATA, ATF, ATG, AUS, AUT, AZE, BDI, BEL, BEN, BES, BFA, BGD, BGR, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BRN, BTN, BVT, BWA, CAF, CAN, CCK, CHE, CHL, CHN, CIV, CMR, COD, COG, COK, COL, COM, CPV, CRI, CUB, CUW, CXR, CYM, CYP, CZE, DEU, DJI, DMA, DNK, DOM, DZA, ECU, EGY, ERI, ESH, ESP, EST, ETH, FIN, FJI, FLK, FRA, FRO, FSM, GAB, GBR, GEO, GGY, GHA, GIB, GIN, GLP, GMB, GNB, GNQ, GRC, GRD, GRL, GTM, GUF, GUM, GUY, HKG, HMD, HND, HRV, HTI, HUN, IDN, IMN, IND, IOT, IRL, IRN, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, KHM, KIR, KNA, KOR, KWT, LAO, LBN, LBR, LBY, LCA, LIE, LKA, LSO, LTU, LUX, LVA, MAC, MAF, MAR, MCO, MDA, MDG, MDV, MEX, MHL, MKD, MLI, MLT, MMR, MNE, MNG, MNP, MOZ, MRT, MSR, MTQ, MUS, MWI, MYS, MYT, NAM, NCL, NER, NFK, NGA, NIC, NIU, NLD, NOR, NPL, NRU, NZL, OMN, PAK, PAN, PCN, PER, PHL, PLW, PNG, POL, PRI, PRK, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSD, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, SYR, TCA, TCD, TGO, THA, TJK, TKL, TKM, TLS, TON, TTO, TUN, TUR, TUV, TWN, TZA, UGA, UKR, UMI, URY, USA, UZB, VAT, VCT, VEN, VGB, VIR, VNM, VUT, WLF, WSM, YEM, ZAF, ZMB, ZWE, XKX "FIN"
Risk assessment score of the customer:
- High - High-risk customer
- Med - Medium-risk customer
- Low - Low-risk customer
- Pep - Politically Exposed Person (PEP)
- Prohibited - Customer sanctioned or outside of risk appetite
If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
High, Med, Low, Pep, Prohibited "Med"
Cardholder's country of birth. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field due to regulatory requirements.
ABW, AFG, AGO, AIA, ALA, ALB, AND, ARE, ARG, ARM, ASM, ATA, ATF, ATG, AUS, AUT, AZE, BDI, BEL, BEN, BES, BFA, BGD, BGR, BHR, BHS, BIH, BLM, BLR, BLZ, BMU, BOL, BRA, BRB, BRN, BTN, BVT, BWA, CAF, CAN, CCK, CHE, CHL, CHN, CIV, CMR, COD, COG, COK, COL, COM, CPV, CRI, CUB, CUW, CXR, CYM, CYP, CZE, DEU, DJI, DMA, DNK, DOM, DZA, ECU, EGY, ERI, ESH, ESP, EST, ETH, FIN, FJI, FLK, FRA, FRO, FSM, GAB, GBR, GEO, GGY, GHA, GIB, GIN, GLP, GMB, GNB, GNQ, GRC, GRD, GRL, GTM, GUF, GUM, GUY, HKG, HMD, HND, HRV, HTI, HUN, IDN, IMN, IND, IOT, IRL, IRN, IRQ, ISL, ISR, ITA, JAM, JEY, JOR, JPN, KAZ, KEN, KGZ, KHM, KIR, KNA, KOR, KWT, LAO, LBN, LBR, LBY, LCA, LIE, LKA, LSO, LTU, LUX, LVA, MAC, MAF, MAR, MCO, MDA, MDG, MDV, MEX, MHL, MKD, MLI, MLT, MMR, MNE, MNG, MNP, MOZ, MRT, MSR, MTQ, MUS, MWI, MYS, MYT, NAM, NCL, NER, NFK, NGA, NIC, NIU, NLD, NOR, NPL, NRU, NZL, OMN, PAK, PAN, PCN, PER, PHL, PLW, PNG, POL, PRI, PRK, PRT, PRY, PSE, PYF, QAT, REU, ROU, RUS, RWA, SAU, SDN, SEN, SGP, SGS, SHN, SJM, SLB, SLE, SLV, SMR, SOM, SPM, SRB, SSD, STP, SUR, SVK, SVN, SWE, SWZ, SXM, SYC, SYR, TCA, TCD, TGO, THA, TJK, TKL, TKM, TLS, TON, TTO, TUN, TUR, TUV, TWN, TZA, UGA, UKR, UMI, URY, USA, UZB, VAT, VCT, VEN, VGB, VIR, VNM, VUT, WLF, WSM, YEM, ZAF, ZMB, ZWE, XKX "FIN"
Customer or company identification number, such as a social security number (SSN), national identity number, or company registration number. Enfuce does not validate whether the provided identificationNumber is a real or officially valid identifier. Customers may populate this field according to their own business or regulatory needs. If you are using Enfuce as your BIN sponsor (under ELS or EUK licensing), you are required to populate this field for Finnish cardholders due to regulatory requirements.
1 - 64^[a-zA-Z0-9](?:[a-zA-Z0-9 \-_/.+]*[a-zA-Z0-9])?$"19560606-1234"

