List Stores

Retrieve stores associated with the authenticated account using cursor-based pagination. Use the returned cursors to move through subsequent or previous pages without constructing cursor values yourself.
Request Parameters
limitinteger
required
Maximum number of stores to return on one page. Provide a value from 1 to 50 to control the page size.
cursorstring
Opaque pagination token from nextCursor or prevCursor in a previous response. Omit this field for the first page, and reuse the token unchanged for later requests.
Response Parameters
resultResult
API call result. See Result.
itemsarray
Store summaries returned for the current page. The array contains up to 50 StoreInfo objects and is empty when no stores match.
Show child parametersShow child parameters
nextCursorstring
Opaque token for the next page. Returned only when another page is available; pass it unchanged as cursor in the next request.
prevCursorstring
Opaque token for the previous page. Returned only when a previous page is available; pass it unchanged as cursor to navigate backward.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFOne or more parameters are invalid, such as a non-numeric input or an invalid date.Check that `limit` is an integer from 1 to 50 and that `cursor`, when provided, is an unchanged token from a previous response.
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.
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.
USER_STATUS_ABNORMALFThe status of the user is abnormal. Contact WorldFirst support.Stop processing the request and contact WorldFirst support to resolve the account status.
ACCESS_DENIEDFAccess is denied. Verify the authorization scope or account permission.Confirm that the API key can read store information for the target account.
Definition
POST /api/open/v1/stores/list
Request
{
"limit": 20
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"items": [
  {
    "id": "STR_2026****",
    "storeName": "My **** Store",
    "marketplaceName": "Amazon US",
    "authorizedStatus": "AUTHORIZED",
    "createdAt": "2026-08-08T10:30:00+08:00"
  }
],
"nextCursor": "eyJpZCI6...****"
}