Skip to content

Cardholder Profile

Request URL

POST /ibis/card/cardholder-profile

Description

Use this endpoint to retrieve the card holder profile for the specified card or vAccount. When using this endpoint with a vAccount only account, use the issued cFiAccountId as the value for the cFiCardId property.

Schema

Property table for schema 1 for ibis/card/cardholder-profile

Property Description Required Schema
cFiCardId The card ID in connectFi Yes {
  "type": "string",
  "pattern": "^[0-9a-zA-Z_]+$",
  "minLength": 1,
  "maxLength": 36,
  "description": "common-id"
}

Property table for schema 2 for ibis/card/cardholder-profile

Property Description Required Schema
reference An external alphanumeric reference ID for the entity in your system Yes {
  "type": "string",
  "pattern": "^[0-9a-zA-Z]+$",
  "minLength": 1,
  "maxLength": 32,
  "description": "common-reference"
}

Request Body

{
    "cFiCardId" : "icrd_575fma7wGFKTgSx537PMcO"
}

Snippet Examples

javascript

const axios = require('axios');
const data = {
    "cFiCardId" : "icrd_575fma7wGFKTgSx537PMcO"
};
const config = {
  method: 'POST',
  url: '${CONNECTFI_BASE_URL}/ibis/card/cardholder-profile',
  headers: {
    'Content-Type': "application/json",
    'x-connectfi-token': "A long random string token received from /auth/get-token request"
  },
  data
};

let result;
try {
  result = await axios.request(config);
  if (result.status === 200) {
    console.log(JSON.stringify(result.data));
  }
} catch (err) {
  console.log({
    errCode: err.code,
    responseStatus: err.response && err.response.status,
    data: err.response && JSON.stringify(err.response.data)
  });
}

cURL

curl --location "CONNECTFI_BASE_URL/ibis/card/cardholder-profile" --data "{\"cFiCardId\": \"icrd_575fma7wGFKTgSx537PMcO\"}" --header "Content-Type: application/json" --header "x-connectfi-token: A long random string token received from /auth/get-token request"

Successful Response Examples

200 SUCCESSFUL RESPONSE USING CFICARDID

HEADERS

Header Value
Content-Type application/json
x-connectfi-token A long random string token received from /auth/get-token request

REQUEST BODY

{
    "cFiCardId" : "icrd_1qaR2QEPXIRKr4jOyjQkTw"
}

RESPONSE BODY

{
    "code": "0",
    "data": {
        "cFiCardId": "icrd_1qaR2QEPXIRKr4jOyjQkTw",
        "cFiStatus": "Complete",
        "customerId": "cstap_7uvAC6nLftLGCq7yic3TfI",
        "cFiAggregatorId": "CLIENTID",
        "reference": "extIDCrd100",
        "memberNumber": "cstcp_2WZ7ariGgrtumtUlD452LM",
        "cardProgramId": "d_gpr_test",
        "programType": "debit",
        "boReferenceId": "110195634081158",
        "boCustomerId": "110000001956340811",
        "vAccountNumber": "1234567890123456",
        "abaRoutingNumber": "122244184",
        "dtsCreatedAt": "2023-11-01T18:05:04.208Z",
        "stakeholderId": "StakHolder",
        "status": {
            "code": "B",
            "description": "Open - All Transactions Allowed"
        },
        "transitionFlag": "N",
        "statusCode": "B",
        "firstName": "JOLEEN",
        "lastName": "KAPSCH",
        "address1": "5100 SWEETBRIAR LN",
        "address2": "Apt 1",
        "dob": "1970-01-01",
        "city": "TYLER",
        "stateCode": "TX",
        "postalCode": "75703",
        "country": "USA",
        "expDate": "2026-11-30",
        "cardType": "M",
        "cellNumber": "2128826862",
        "email": "brucey@gmail.com",
        "occupation": "Student",
        "cipCleared": "N",
        "pseudoDdaNumbers": [
            {
                "pseudoDdaNumber": "8100045988504135"
            }
        ],
        "cardDeliveryMode": "P",
        "cardNumber": "999999******4135",
        "fee": 0,
        "balance": 0,
        "lastDepositAmount": 0,
        "ledgerBalance": 0
    },
    "requestId": "e809083081af11ee9b7427220cc6c212"
}

200 SUCCESSFUL RESPONSE USING REFERENCE

HEADERS

Header Value
Content-Type application/json
x-connectfi-token A long random string token received from /auth/get-token request

REQUEST BODY

{
    "reference" : "extIDCrd100"
}

RESPONSE BODY

{
    "code": "0",
    "data": {
        "cFiCardId": "icrd_1qaR2QEPXIRKr4jOyjQkTw",
        "cFiStatus": "Complete",
        "customerId": "cstap_7uvAC6nLftLGCq7yic3TfI",
        "cFiAggregatorId": "CLIENTID",
        "reference": "extIDCrd100",
        "memberNumber": "cstcp_2WZ7ariGgrtumtUlD452LM",
        "cardProgramId": "d_gpr_test",
        "programType": "debit",
        "boReferenceId": "110195634081158",
        "boCustomerId": "110000001956340811",
        "vAccountNumber": "1234567890123456",
        "abaRoutingNumber": "122244184",
        "dtsCreatedAt": "2023-11-01T18:05:04.208Z",
        "stakeholderId": "StakHolder",
        "status": {
            "code": "B",
            "description": "Open - All Transactions Allowed"
        },
        "transitionFlag": "N",
        "statusCode": "B",
        "firstName": "JOLEEN",
        "lastName": "KAPSCH",
        "address1": "5100 SWEETBRIAR LN",
        "address2": "Apt 1",
        "dob": "1970-01-01",
        "city": "TYLER",
        "stateCode": "TX",
        "postalCode": "75703",
        "country": "USA",
        "expDate": "2026-11-30",
        "cardType": "M",
        "cellNumber": "2128826862",
        "email": "brucey@gmail.com",
        "occupation": "Student",
        "cipCleared": "N",
        "pseudoDdaNumbers": [
            {
                "pseudoDdaNumber": "8100045988504135"
            }
        ],
        "cardDeliveryMode": "P",
        "cardNumber": "999999******4135",
        "fee": 0,
        "balance": 10.5,
        "lastDepositDate": "2023-11-12",
        "lastDepositAmount": 5,
        "ledgerBalance": 21
    },
    "requestId": "51afdb0094a811eea89d7100487c0512"
}