Query Account Information

Retrieves basic account information for your own account or for an account that has authorized you, including registration details, legal entity data, account status, and WorldFirst receiving accounts.
Response Parameters
resultResult
API call result. See Result.
idstring
WorldFirst-assigned unique account identifier. Store this value for support, reconciliation, and subsequent account-specific operations.
registrationRegionstring
Country or region where the account is registered, expressed as an ISO 3166-1 alpha-2 code. See Data Types.
registrationLegalNamestring
Official legal name used to register the account. Use this value when reconciling the account holder with compliance or business records.
legalEntityInfoLegalEntityInfo
Legal entity, business profile, and related-party information held for the account. This value may be absent while the information is unavailable.
Show child parametersShow child parameters
contactContact
Email and phone details recorded for the account. At least one contact method is normally supplied during onboarding.
Show child parametersShow child parameters
statusstring
Current account onboarding or review status. See AccountStatus; when the value is REJECTED, inspect reasonCode before deciding the next action.
createdAtdatetime
Date and time when the account was created, expressed in ISO 8601 extended format. See Data Types.
updatedAtdatetime
Date and time when the account information was last updated, expressed in ISO 8601 extended format. Use it to detect whether a stored account record may need refreshing. See Data Types.
reasonCodestring
Reason code explaining why the account was rejected. This value is returned when status is REJECTED; use it to determine the required remediation or supporting information.
receivingAccountReceivingAccount
Receiving account assigned to the account holder. Where supported, it can also receive funds from other WorldFirst accounts. Use it to identify the available receiving account type, account number, and supported currencies.
Show child parametersShow child parameters
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccess.N/A
PARAM_ILLEGALFIllegal parameter. Refer to the API documentation to verify the request header and parameters, then retry.Verify the `Authorization` and `Content-Type` headers, check any `account-id` or `access-token` header, and send an empty JSON object as the body.
ACCOUNT_NOT_EXISTFThe specified account does not exist. Verify the id and retry.Verify that the authenticated account or the account selected by `account-id` exists, then retry. Do not add an account ID to the request body.
ACCESS_DENIEDFYou do not have permission to query this account. You can only query your own account information.Query the authenticated account, or confirm that the platform or OAuth authorization permits access to the selected connected account.
Definition
POST /api/open/v1/accounts/query
Request
{}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "2088000000000001",
"registrationRegion": "GB",
"registrationLegalName": "Example UK Ltd.",
"legalEntityInfo": {
  "legalEntityType": "COMPANY",
  "company": {
    "legalName": "Example UK Ltd.",
    "registrationType": "CERTIFICATE_OF_INCORPORATION_UK",
    "registrationNo": "12345678",
    "registrationAddress": {
      "region": "GB",
      "address1": "100 Parliament Street",
      "city": "London",
      "zipCode": "SW1A 2BQ"
    }
  }
},
"contact": {
  "contactEmail": "info@example.co.uk",
  "contactPhone": "+442**1234567"
},
"status": "SUCCESS",
"receivingAccount": {
  "accountNumber": "WF-281025*****3905027312606",
  "accountType": "RECEIVE_ACCOUNT",
  "currencyList": [
    "HKD",
    "AED",
    "CHF",
    "EUR",
    "USD",
    "CAD",
    "CNY",
    "AUD",
    "SGD",
    "JPY",
    "PLN",
    "GBP",
    "SEK",
    "NZD",
    "TRY"
  ]
},
"createdAt": "2026-08-08T10:00:00+08:00",
"updatedAt": "2026-08-09T15:30:00+08:00"
}