Data Store Protocol

NEX Protocols > Data Store (115)

The following games have additional methods in the datastore protocol:

• Miitopia 3DS
• Pokemon Bank
• Pokemon X / Y
• Splatoon 2
• Super Mario Maker
• Super Mario Maker 2
• Super Mario Odyssey
• Super Smash Bros. 4
• Super Smash Bros. Ultimate

This remainder of this page describes the methods that are not specific to any game.

Method ID	Method Name
1	PrepareGetObjectV1
2	PreparePostObjectV1
3	CompletePostObjectV1
4	DeleteObject
5	DeleteObjects
6	ChangeMetaV1
7	ChangeMetasV1
8	GetMeta
9	GetMetas
10	PrepareUpdateObject
11	CompleteUpdateObject
12	SearchObject
13	GetNotificationUrl
14	GetNewArrivedNotificationsV1
15	RateObject
16	GetRating
17	GetRatings
18	ResetRating
19	ResetRatings
20	GetSpecificMetaV1
21	PostMetaBinary
22	TouchObject
23	GetRatingWithLog
24	PreparePostObject
25	PrepareGetObject
26	CompletePostObject
27	GetNewArrivedNotifications
28	GetSpecificMeta
29	GetPersistenceInfo
30	GetPersistenceInfos
31	PerpetuateObject
32	UnperpetuateObject
33	PrepareGetObjectOrMetaBinary
34	GetPasswordInfo
35	GetPasswordInfos
36	GetMetasMultipleParam
37	CompletePostObjects
38	ChangeMeta
39	ChangeMetas
40	RateObjects
41	PostMetaBinaryWithDataId
42	PostMetaBinariesWithDataId
43	RateObjectWithPosting
44	RateObjectsWithPosting
45	GetObjectInfos
46	SearchObjectLight

(1) PrepareGetObjectV1

Request

Type	Name
DataStorePrepareGetParamV1	param

Response

Type	Name
DataStoreReqGetInfoV1	pReqGetInfo

(2) PreparePostObjectV1

Request

Type	Name
DataStorePreparePostParamV1	param

Response

Type	Name
DataStoreReqPostInfoV1	pReqPostInfo

(3) CompletePostObjectV1

Request

Type	Name
DataStoreCompletePostParamV1	param

Response

This method does not return anything.

(4) DeleteObject

Request

Type	Name
DataStoreDeleteParam	param

Response

This method does not return anything.

(5) DeleteObjects

Request

Type	Name
List<DataStoreDeleteParam>	params
Bool	transactional

Response

Type	Name
List<Result>	pResults

(6) ChangeMetaV1

Request

Type	Name
DataStoreChangeMetaParamV1	param

Response

This method does not return anything.

(7) ChangeMetasV1

Request

Type	Name
List<Uint64>	dataIds
List<DataStoreChangeMetaParamV1>	params
Bool	transactional

Response

Type	Name
List<Result>	pResults

(8) GetMeta

Request

Type	Name
DataStoreGetMetaParam	param

Response

Type	Name
DataStoreMetaInfo	pMetaInfo

(9) GetMetas

Request

Type	Name
List<Uint64>	dataIds
DataStoreGetMetaParam	param

Response

Type	Name
List<DataStoreMetaInfo>	pMetaInfo
List<Result>	pResults

(10) PrepareUpdateObject

Request

Type	Name
DataStorePrepareUpdateParam	param

Response

Type	Name
DataStoreReqUpdateInfo	pReqUpdateInfo

(11) CompleteUpdateObject

Request

Type	Name
DataStoreCompleteUpdateParam	param

Response

This method does not return anything.

(12) SearchObject

Request

Type	Name
DataStoreSearchParam	param

Response

Type	Name
DataStoreSearchResult	pSearchResult

(13) GetNotificationUrl

Request

Type	Name
DataStoreGetNotificationUrlParam	param

Response

Type	Name
DataStoreReqGetNotificationUrlInfo	info

(14) GetNewArrivedNotificationsV1

Request

Type	Name
DataStoreGetNewArrivedNotificationsParam	param

Response

Type	Name
List<DataStoreNotificationV1>	pResult
Bool	pHasNext

(15) RateObject

Request

Type	Name
DataStoreRatingTarget	target
DataStoreRateObjectParam	param
Bool	fetchRatings

Response

Type	Name
DataStoreRatingInfo	pRating

(16) GetRating

Request

Type	Name
DataStoreRatingTarget	target
Uint64	accessPassword

Response

Type	Name
DataStoreRatingInfo	pRating

(17) GetRatings

Request

Type	Name
List<Uint64>	dataIds
Uint64	accessPassword

Response

Type	Name
List<List<DataStoreRatingInfoWithSlot>>	pRatings
List<Result>	pResults

(18) ResetRating

Request

Type	Name
DataStoreRatingTarget	target
Uint64	updatePassword

Response

This method does not return anything.

(19) ResetRatings

Request

Type	Name
List<Uint64>	dataIds
Bool	transactional

Response

Type	Name
List<Result>	pResults

(20) GetSpecificMetaV1

Request

Type	Name
DataStoreGetSpecificMetaParamV1	param

Response

Type	Name
List<DataStoreSpecificMetaInfoV1>	pMetaInfos

(21) PostMetaBinary

Request

Type	Name
DataStorePreparePostParam	param

Response

Type	Name
Uint64	dataId

(22) TouchObject

Request

Type	Name
DataStoreTouchObjectParam	param

Response

This method does not return anything.

(23) GetRatingWithLog

Request

Type	Name
DataStoreRatingTarget	target
Uint64	accessPassword

Response

Type	Name
DataStoreRatingInfo	pRating
DataStoreRatingLog	pRatingLog

(24) PreparePostObject

Request

Type	Name
DataStorePreparePostParam	param

Response

Type	Name
DataStoreReqPostInfo	pReqPostInfo

(25) PrepareGetObject

Request

Type	Name
DataStorePrepareGetParam	param

Response

Type	Name
DataStoreReqGetInfo	pReqGetInfo

(26) CompletePostObject

Request

Type	Name
DataStoreCompletePostParam	param

Response

This method does not return anything.

(27) GetNewArrivedNotifications

Request

Type	Name
DataStoreGetNewArrivedNotificationsParam	param

Response

Type	Name
List<DataStoreNotification>	pResult
Bool	pHasNext

(28) GetSpecificMeta

Request

Type	Name
DataStoreGetSpecificMetaParam	param

Response

Type	Name
List<DataStoreSpecificMetaInfo>	pMetaInfos

(29) GetPersistenceInfo

Request

Type	Name
PID	ownerId
Uint16	persistenceSlotId

Response

Type	Name
DataStorePersistenceInfo	pPersistenceInfo

(30) GetPersistenceInfos

Request

Type	Name
PID	ownerId
List<Uint16>	persistenceSlotIds

Response

Type	Name
List<DataStorePersistenceInfo>	pPersistenceInfo
List<Result>	pResults

(31) PerpetuateObject

Request

Type	Name
Uint16	persistenceSlotId
Uint64	dataId
Bool	deleteLastObject

Response

This method does not return anything.

(32) UnperpetuateObject

Request

Type	Name
Uint16	persistenceSlotId
Bool	deleteLastObject

Response

This method does not return anything.

(33) PrepareGetObjectOrMetaBinary

Request

Type	Name
DataStorePrepareGetParam	param

Response

Type	Name
DataStoreReqGetInfo	pReqGetInfo
DataStoreReqGetAdditionalMeta	pReqGetAdditionalMeta

(34) GetPasswordInfo

Request

Type	Name
Uint64	dataId

Response

Type	Name
DataStorePasswordInfo	pPasswordInfo

(35) GetPasswordInfos

Request

Type	Name
List<Uint64>	dataIds

Response

Type	Name
List<DataStorePasswordInfo>	pPasswordInfos
List<Result>	pResults

(36) GetMetasMultipleParam

Request

Type	Name
List<DataStoreGetMetaParam>	params

Response

Type	Name
List<DataStoreMetaInfo>	pMetaInfo
List<Result>	pResults

(37) CompletePostObjects

Request

Type	Name
List<Uint64>	dataIds

Response

This method does not return anything.

(38) ChangeMeta

Request

Type	Name
DataStoreChangeMetaParam	param

Response

This method does not return anything.

(39) ChangeMetas

Request

Type	Name
List<Uint64>	dataIds
List<DataStoreChangeMetaParam>	params
Bool	transactional

Response

Type	Name
List<Result>	pResults

(40) RateObjects

Request

Type	Name
List<DataStoreRatingTarget>	targets
List<DataStoreRateObjectParam>	params
Bool	transactional
Bool	fetchRatings

Response

Type	Name
List<DataStoreRatingInfo>	pRatings
List<Result>	pResults

(41) PostMetaBinaryWithDataId

Request

Type	Name
Uint64	dataId
DataStorePreparePostParam	param

Response

This method does not return anything.

(42) PostMetaBinariesWithDataId

Request

Type	Name
List<Uint64>	dataIds
List<DataStorePreparePostParam>	params
Bool	transactional

Response

Type	Name
List<Result>	pResults

(43) RateObjectWithPosting

Request

Type	Name
DataStoreRatingTarget	target
DataStoreRateObjectParam	rateParam
DataStorePreparePostParam	postParam
Bool	fetchRatings

Response

Type	Name
DataStoreRatingInfo	pRating

(44) RateObjectsWithPosting

Request

Type	Name
List<DataStoreRatingTarget>	targets
List<DataStoreRateObjectParam>	rateParams
List<DataStorePreparePostParam>	postParams
Bool	transactional
Bool	fetchRatings

Response

Type	Name
List<DataStoreRatingInfo>	pRatings
List<Result>	pResults

(45) GetObjectInfos

Request

Type	Name
List<Uint64>	dataIds

Response

Type	Name
List<DataStoreReqGetInfo>	pInfos
List<Result>	pResults

(46) SearchObjectLight

Request

Type	Name
DataStoreSearchParam	param

Response

Type	Name
DataStoreSearchResult	pSearchResult

Types

DataStorePrepareGetParamV1 (Structure)

Type	Name
Uint32	dataId
Uint32	lockId

DataStorePrepareGetParam (Structure)

Type	Name
Uint64	dataId
Uint32	lockId
DataStorePersistenceTarget	persistenceTarget
Uint64	accessPassword
List<String>	extraData

DataStoreReqGetInfoV1 (Structure)

Type	Name
String	url
List<DataStoreKeyValue>	requestHeaders
Uint32	size
Buffer	rootCaCert

DataStoreReqGetInfo (Structure)

Type	Name
String	url
List<DataStoreKeyValue>	requestHeaders
Uint32	size
Buffer	rootCaCert
Uint64	dataId

DataStoreReqGetAdditionalMeta (Structure)

Type	Name
PID	ownerId
Uint16	dataType
Uint16	version
qBuffer	metaBinary

DataStorePreparePostParamV1 (Structure)

Type	Name
Uint32	size
String	name
Uint16	dataType
qBuffer	metaBinary
DataStorePermission	permission
DataStorePermission	delPermission
Uint32	flag
Uint16	period
Uint32	referDataId
List<String>	tags
List<DataStoreRatingInitParamWithSlot>	ratingInitParams

DataStorePreparePostParam (Structure)

Type	Name
Uint32	size
String	name
Uint16	dataType
qBuffer	metaBinary
DataStorePermission	permission
DataStorePermission	delPermission
Uint32	flag
Uint16	period
Uint32	referDataId
List<String>	tags
List<DataStoreRatingInitParamWithSlot>	ratingInitParams
DataStorePersistenceInitParam	persistenceInitParam
List<String>	extraData

DataStoreReqPostInfoV1 (Structure)

Type	Name
Uint32	dataId
String	url
List<DataStoreKeyValue>	requestHeaders
List<DataStoreKeyValue>	formFields
Buffer	rootCaCert

DataStoreReqPostInfo (Structure)

Type	Name
Uint64	dataId
String	url
List<DataStoreKeyValue>	requestHeaders
List<DataStoreKeyValue>	formFields
Buffer	rootCaCert

DataStoreCompletePostParamV1 (Structure)

Type	Name
Uint32	dataId
Bool	isSuccess

DataStoreCompletePostParam (Structure)

Type	Name
Uint64	dataId
Bool	isSuccess

DataStoreDeleteParam (Structure)

Type	Name
Uint64	dataId
Uint64	updatePassword

DataStoreChangeMetaParamV1 (Structure)

Type	Name
Uint64	dataId
Uint32	modifiesFlag
String	name
DataStorePermission	permission
DataStorePermission	delPermission
Uint16	period
qBuffer	metaBinary
List<String>	tags
Uint64	updatePassword

DataStoreChangeMetaParam (Structure)

Type	Name
Uint64	dataId
Uint32	modifiesFlag
String	name
DataStorePermission	permission
DataStorePermission	delPermission
Uint16	period
qBuffer	metaBinary
List<String>	tags
Uint64	updatePassword
Uint32	referredCnt
Uint16	dataType
Uint8	status
DataStoreChangeMetaCompareParam	compareParam
DataStorePersistenceTarget	persistenceTarget

DataStoreGetMetaParam (Structure)

Type	Name
Uint64	dataId
DataStorePersistenceTarget	persistenceTarget
Uint8	resultOption
Uint64	accessPassword

Result option flags:

Flag	Field
0x4	metaBinary

DataStoreRatingInfo (Structure)

Type	Name
Sint64	totalValue
Uint32	count
Sint64	initialValue

DataStoreRatingInfoWithSlot (Structure)

Type	Name
Sint8	slot
DataStoreRatingInfo	rating

DataStoreMetaInfo (Structure)

Type	Name
Uint64	dataId
PID	ownerId
Uint32	size
String	name
Uint16	dataType
qBuffer	metaBinary
DataStorePermission	permission
DataStorePermission	delPermission
DateTime	createdTime
DateTime	updatedTime
Uint16	period
Uint8	status
Uint32	referredCnt
Uint32	referDataId
Uint32	flag
DateTime	referredTime
DateTime	expireTime
List<String>	tags
List<DataStoreRatingInfoWithSlot>	ratings

DataStorePrepareUpdateParam (Structure)

Type	Name
Uint64	dataId
Uint32	size
Uint64	updatePassword
List<String>	extraData

DataStoreReqUpdateInfo (Structure)

Type	Name
Uint32	version
String	url
List<DataStoreKeyValue>	requestHeaders
List<DataStoreKeyValue>	formFields
Buffer	rootCaCert

DataStoreCompleteUpdateParam (Structure)

Type	Name
Uint64	dataId
Uint32	version
Bool	isSuccess

DataStoreSearchParam (Structure)

Type	Name
Uint8	searchTarget
List<PID>	ownerIds
Uint8	ownerType
List<Uint64>	destinationIds
Uint16	dataType
DateTime	createdAfter
DateTime	createdBefore
DateTime	updatedAfter
DateTime	updatedBefore
Uint32	referDataId
List<String>	tags
Uint8	resultOrderColumn
Uint8	resultOrder
ResultRange	resultRange
Uint8	resultOption
Uint32	minimalRatingFrequency
Bool	useCache

Only present on Switch:

Type	Name
Bool	totalCountEnabled
List<Uint16>	dataTypes

DataStoreSearchResult (Structure)

Type	Name
Uint32	totalCount
List<DataStoreMetaInfo>	result
Uint8	totalCountType

DataStoreGetNotificationUrlParam (Structure)

Type	Name
String	previousUrl

DataStoreReqGetNotificationUrlInfo (Structure)

Type	Name
String	url
String	key
String	query
Buffer	rootCaCert

DataStoreGetNewArrivedNotificationsParam (Structure)

Type	Name
Uint64	lastNotificationId
Uint16	limit

DataStoreNotificationV1 (Structure)

Type	Name
Uint64	notificationId
Uint32	dataId

DataStoreNotification (Structure)

Type	Name
Uint64	notificationId
Uint64	dataId

DataStoreRateObjectParam (Structure)

Type	Name
Sint32	ratingValue
Uint64	accessPassword

DataStoreRatingTarget (Structure)

Type	Name
Uint64	dataId
Sint8	slot

DataStoreGetSpecificMetaParamV1 (Structure)

Type	Name
List<Uint32>	dataIds

DataStoreGetSpecificMetaParam (Structure)

Type	Name
List<Uint64>	dataIds

DataStoreSpecificMetaInfoV1 (Structure)

Type	Name
Uint32	dataId
PID	ownerId
Uint32	size
Uint16	dataType
Uint16	version

DataStoreSpecificMetaInfo (Structure)

Type	Name
Uint64	dataId
PID	ownerId
Uint32	size
Uint16	dataType
Uint32	version

DataStoreTouchObjectParam (Structure)

Type	Name
Uint64	dataId
Uint32	lockId
Uint64	accessPassword

DataStoreRatingLog (Structure)

Type	Name
Bool	isRated
PID	pid
Sint32	ratingValue
DateTime	lockExpirationTime

DataStorePersistenceInfo (Structure)

Type	Name
PID	ownerId
Uint16	persistenceSlotId
Uint64	dataId

DataStorePasswordInfo (Structure)

Type	Name
Uint64	dataId
Uint64	accessPassword
Uint64	updatePassword

DataStorePersistenceTarget (Structure)

Type	Name
PID	ownerId
Uint16	persistenceSlotId

DataStoreKeyValue (Structure)

Type	Name
String	key
String	value

DataStorePermission (Structure)

Type	Name
Uint8	permission
List<PID>	recipientIds

DataStoreRatingInitParamWithSlot (Structure)

Type	Name
Sint8	slot
DataStoreRatingInitParam	param

DataStorePersistenceInitParam (Structure)

Type	Name
Uint16	persistenceSlotId
Bool	deleteLastObject

DataStoreChangeMetaCompareParam (Structure)

Type	Name
Uint32	comparisonFlag
String	name
DataStorePermission	permission
DataStorePermission	delPermission
Uint16	period
qBuffer	metaBinary
List<String>	tags
Uint32	referredCnt
Uint16	dataType
Uint8	status

DataStoreRatingInitParam (Structure)

Type	Name
Uint8	flag
Uint8	internalFlag
Uint8	lockType
Sint64	initialValue
Sint32	rangeMin
Sint32	rangeMax
Sint8	periodHour
Sint16	periodDuration