Check Profile

{
  "mobileNumber": "9876543210",
  "userConsentId": "consent-uuid-12345"
}

{
  "mobileNumber": "9876543210",
  "userConsentId": "consent-uuid-12345",
  "aaId": ["onemoney", "finvu"]
}

{
  "ver": "1.0.0",
  "timestamp": "2025-11-25T10:30:00.000Z",
  "txnid": "550e8400-e29b-41d4-a716-446655440000",
  "data": [
    {
      "aaId": "onemoney",
      "registrationStatus": true,
      "hasLinkedAccounts": true,
      "status": "success"
    },
    {
      "aaId": "finvu",
      "registrationStatus": false,
      "hasLinkedAccounts": false,
      "status": "success"
    },
    {
      "aaId": "anumati",
      "registrationStatus": null,
      "hasLinkedAccounts": null,
      "status": "timeout"
    }
  ]
}

{
  "ver": "1.0.0",
  "status": "error",
  "error": {
    "code": "PROFILE_CHECK_FAILED",
    "message": "Failed to check profile existence",
    "details": "No active AAs found with profile API enabled"
  }
}

const profileResults = response.data;

// Find AAs where user is registered with linked accounts
const readyAAs = profileResults.filter(
  aa => aa.status === 'success' &&
       aa.registrationStatus === true &&
       aa.hasLinkedAccounts === true
);

// Find AAs where user is registered but needs to link accounts
const needsLinkingAAs = profileResults.filter(
  aa => aa.status === 'success' &&
       aa.registrationStatus === true &&
       aa.hasLinkedAccounts === false
);

// Find AAs where user needs to register
const needsRegistrationAAs = profileResults.filter(
  aa => aa.status === 'success' &&
       aa.registrationStatus === false
);

if (readyAAs.length > 0) {
  // Recommend these AAs for fastest onboarding
  showRecommendedAAs(readyAAs);
} else if (needsLinkingAAs.length > 0) {
  // User can use these AAs but needs to link accounts
  showLinkingFlow(needsLinkingAAs);
} else {
  // User needs to register with an AA
  showRegistrationFlow(needsRegistrationAAs);
}

async function validateUserReadiness(mobileNumber, preferredAA) {
  const response = await checkProfile({
    mobileNumber,
    userConsentId: generateUUID(),
    aaId: [preferredAA]
  });

  const aaResult = response.data[0];

  if (aaResult.status !== 'success') {
    throw new Error(`Unable to verify profile: ${aaResult.status}`);
  }

  if (!aaResult.registrationStatus) {
    return { ready: false, reason: 'NOT_REGISTERED' };
  }

  if (!aaResult.hasLinkedAccounts) {
    return { ready: false, reason: 'NO_LINKED_ACCOUNTS' };
  }

  return { ready: true };
}