Query a Connected Account

Retrieves the details of a connected account by its WorldFirst-assigned ID. Returns the full account information including registration status, legal entity details, and audit results.
Request Parameters
idstring
required
WorldFirst-assigned unique merchant identifier. Obtain this from the Create a Connected Account response or the Webhook notification.
Response Parameters
resultResult
See Result.
idstring
WorldFirst-assigned unique merchant identifier (Account ID).
referenceAccountIdstring
Integrator-side merchant identifier.
statusstring
Account registration status. See AccountStatus.
registrationRegionstring
Registration country/region. ISO 3166-1 alpha-2 code. See Data Types.
registrationLegalNamestring
Registered legal entity name.
legalEntityInfoLegalEntityInfo
Legal entity information submitted during registration. May be null for SDK-registered accounts pending KYC submission.
Show child parametersShow child parameters
contactContact
Contact information.
Show child parametersShow child parameters
agreementsAgreements
Agreement records.
Show child parametersShow child parameters
reasonCodestring
Audit reason code. Returned when status is REJECT. Inspect this field to determine what supplementary materials are required.
auditDetailsarray
Audit rejection details. Returned when status is REJECT. Maximum 50 items.
Show child parametersShow child parameters
createdAtdatetime
Account creation timestamp. ISO 8601 extended format. See Data Types.
updatedAtdatetime
Account last update timestamp. ISO 8601 extended format.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
Definition
POST /api/open/v1/accounts/query
Request
{
"id": "2088000000000001"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "2088000000000001",
"referenceAccountId": "PARTNER_MERCHANT_001",
"registrationRegion": "GB",
"registrationLegalName": "Example Trading Ltd.",
"contact": {
  "contactEmail": "info@example-trading.com",
  "contactPhone": "+442071234567"
},
"agreements": {
  "agreedToTermsAndConditions": true,
  "agreedToDataUsage": true
},
"status": "SUCCESS",
"createdAt": "2026-04-12T10:00:00+08:00",
"updatedAt": "2026-04-13T15:30:00+08:00"
}