Query a Store

Retrieve the current details of a linked store and its associated receiving or global accounts by store ID. This endpoint applies to marketplace sellers with stores linked to their WorldFirst account. Use the store status and supported features in the response to determine which collection methods are currently available.
Request Parameters
idstring
required
WorldFirst-assigned unique identifier of the store to retrieve. Use an id returned by List Stores and verify that it belongs to the target account.
Response Parameters
resultResult
API call result. See Result.
idstring
WorldFirst-assigned unique identifier for the store. Use this value to correlate the response with stored marketplace records.
storeNamestring
Display name of the store. Present this value when users need to identify the connected storefront.
marketplaceNamestring
Display name of the marketplace where the store operates. Use it to distinguish connections across commerce platforms.
authorizedStatusstring
Current authorization state of the store connection. Check this value before relying on account data.

Valid Values:

AUTHORIZED — The store has granted an active authorization.
NEVER_AUTHORIZED — The store has never completed authorization.
accountsarray
Receiving and global accounts associated with the store. Inspect each StoreAccount independently because capabilities and lifecycle states can differ.
Show child parametersShow child parameters
createdAtdatetime
Time the store record was created, following the ISO 8601 extended format. Use it for audit records and chronological sorting.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFOne or more parameters are invalid, such as a non-numeric input or an invalid date.Check that `id` is a non-empty store identifier returned by List Stores.
PROCESS_FAILFA general business failure occurred. Do not retry.Do not retry automatically. Review the request context and contact WorldFirst support if the issue persists.
STORE_NOT_EXISTFThe store does not exist. Verify the store ID and retry.Verify `id`, confirm the store belongs to the target account, and retry with the correct identifier.
CONTRACT_CHECK_FAILFContract check failed. Verify that the API contract is active for this partner.Confirm that the partner's API contract is active and includes store information access.
USER_NOT_EXISTFThe user does not exist. Verify the access token or account ID and retry.Verify that the authenticated account exists and that any delegated account identifier is correct.
ACCESS_DENIEDFAccess is denied. Verify the authorization scope or account permission.Confirm that the API key can read this store for the target account.
Definition
POST /api/open/v1/stores/query
Request
{
"id": "STR_2026****"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"id": "STR_2026****",
"storeName": "My **** Store",
"marketplaceName": "Amazon US",
"authorizedStatus": "AUTHORIZED",
"accounts": [
  {
    "accountNumber": "8484****",
    "businessType": "RECEIVE_ACCOUNT",
    "status": "ACTIVE",
    "createdAt": "2026-08-08T10:30:00+08:00"
  },
  {
    "accountNumber": "GA20****",
    "swiftCode": "CMFG****",
    "accountType": "CHECKING",
    "businessType": "GLOBAL_ACCOUNT",
    "status": "ACTIVE",
    "institution": {
      "bankName": "Example **** Bank",
      "bankRegion": "US",
      "iban": "IVAJ****"
    },
    "supportedFeatures": [
      {
        "type": "RECEIVING",
        "currency": "USD",
        "paymentType": "LOCAL",
        "paymentNetwork": "ACH",
        "routingCodes": [
          {
            "type": "ACH",
            "value": "0210****"
          },
          {
            "type": "FEDWIRE",
            "value": "0210****"
          }
        ]
      }
    ],
    "createdAt": "2026-08-08T10:30:00+08:00"
  }
],
"createdAt": "2026-08-08T10:30:00+08:00"
}