The Utilities APIs allow you to retrieve an array of valid values, field properties and validations applied for a specific market. This simplifies multimarket app development and helps to identify country-specific variations.

Note: The Developer Hub Sandbox is a test environment that allows you to make API calls that are the same in form and function to our production environments. It contains dummy test data so that you can prototype your application as if it were the real thing. When you’re finished testing, contact sales to request production access.

,

Note: Skip this step if you already created an app and have a pair of Client ID and Client Secret.

  1. Sign in to developer.citi.com
  2. Select My Applications tab.
  3. Click Register a New App
     

a. Fill out the required details

b. Upload an icon for your app (optional)

c. Click Submit

d. You will receive a pair of Client ID and Client Secret. Store this information securely. Use the Show button/checkbox to see your Client ID and Client Secret.

Note: Client secret is shown only once, so make sure you save this information. If in any case you lose your credential set, you can use the Regenerate button to get a new set of Client ID & Client Secret.

,

An access token is required to call all functional APIs. To retrieve your access token, visit your market’s Authorize guide.

,

GET /v1/utilities/metaData

Returns field properties and validations applied for a specific market

Parameters

Value

Authorization

Bearer <<Authorization Token>>

uuid

8120e2d6-0381-4e52-9d90-a5bf771ff243

Accept

application/json

Client_ID

e5245bed-daaf-4eac-867b-57a564604fda

apiUri

/v1/apac/onboarding/products/unsecured/applications

apiMethod

POST

,

GET /v1/apac/utilities/referenceData/{referenceCode}

Returns an array of valid values and descriptions for the specified field

Parameters

Value

referenceCode

phoneType

Authorization

Bearer <<Authorization Token>>

uuid

8120e2d6-0381-4e52-9d90-a5bf771ff243

Accept

application/json

Client_ID

e5245bed-daaf-4eac-867b-57a564604fda

,

GET /v1/apac/utilities/addresses/{postalCode}

Returns address parameters for the specified postal code. It can be used to either validate addresses or populate address fields

Parameters

Value

postalCode

520445

Authorization

Bearer <<Authorization Token>>

uuid

8120e2d6-0381-4e52-9d90-a5bf771ff243

Accept

application/json

Client_ID

e5245bed-daaf-4eac-867b-57a564604fda