List rule decisions
/rule-decisionscurl -X GET https://api.tst.au.apgpay.dev/rule-decisions \
-H "Authorization: Bearer $API_KEY"Return a page of the decisions made for one target in one area, latest first, each with the fields it read and what each rule did.
Permissions
rules:queryRequires the `query` action on `rules` for the supplied runtime context
Query parameters
pageinteger (int32)Offset pagination: 1-based page number. Mutually exclusive with the cursor parameters.
startingAfterstringCursor pagination, moving forward: the id of the last item on the current page. Mutually exclusive with page.
endingBeforestringCursor pagination, moving backward: the id of the first item on the current page. Mutually exclusive with page.
limitinteger (int32)Maximum items per page.
columnsarray of RdecColumnColumns to include, in order, when asking for text/csv. Omit for all of them. Sending it with application/json is a 400.
domainstringThe area whose decisions are listed, as ruleAreaId names it.
targetIdstringThe target the decisions were made for, as a contextual id or as the 24 hexadecimal characters of its id without the prefix.
Responses
The response is a tagged shape: type is always "RdecPageAttributes". Switch on it; subtypes can be added, and a client that already reads it will not break.
typetype = "RdecPageAttributes"typeenumrequiredRdecViewAttributesruleDecisionIdRdecIdrequiredIdentifier of a rule decision.
Example rdec_9f2Kd8QpLzXw
domainstringrequiredThe area whose ruleset was evaluated.
typeThe tenant that owns a rule policy or a named list: the platform, or an enterprise, a marketplace or a merchant.
enterpriseIdEntIdrequiredIdentifier of an enterprise.
Example ent_9f2Kd8QpLzXw
The tenant that owns a rule policy or a named list: the platform, or an enterprise, a marketplace or a merchant.
marketplaceIdMktpIdrequiredIdentifier of a marketplace.
Example mktp_9f2Kd8QpLzXw
The tenant that owns a rule policy or a named list: the platform, or an enterprise, a marketplace or a merchant.
merchantIdMchtIdrequiredIdentifier of a merchant.
Example mcht_9f2Kd8QpLzXw
The platform, which no enterprise, marketplace or merchant bounds.
The platform, which no enterprise, marketplace or merchant bounds.
snapshotVersioninteger (int32)requiredThe version of the ruleset the target was evaluated against.
Example 1250
targetIdstringrequiredWhat was evaluated, by its id without the prefix, as 24 hexadecimal characters.
targetVersioninteger (int64)requiredThe version of the target that was evaluated.
Example 1250
matchedRuleIdsarray of RpolIdExample rpol_9f2Kd8QpLzXw
shadowRuleIdsarray of RpolIdThe shadow rules that matched.
Example rpol_9f2Kd8QpLzXw
typeenumrequiredRdecListAttributesnamedListIdNlstIdrequiredIdentifier of a named list.
Example nlst_9f2Kd8QpLzXw
versioninteger (int32)requiredExample 1250
outcomeRdecOutcomerequiredNoMatchMatchedShadowOnlyFailedUnknowndecidedAtstring (date-time)requiredExample 2026-08-19T04:21:07Z
typeenumrequiredRdecInputAttributesfieldstringrequiredsensitivityRareaSensitivityrequiredPlainPersonalCardCredentialUnknowntypeA field the evaluation found no value for.
A field the evaluation found no value for.
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
An amount in minor current units of a given currency.
typeenumrequiredIsoCurrencyAmountminorCurrencyUnitsinteger (int64)requiredThe amount in minor currency units (e.g. cents for AUD).
Example 1250
currencyIsoCurrencyrequiredThe currency of the given amount as a 3 letter ISO code.
AFNDZDARSAMDAWGAUDAZNBSDBHDTHB+156 moreShow fewer
PAB, BBD, BYR, BZD, BMD, VEF, BOB, BRL, BND, BGN, BIF, CAD, CVE, KYD, XOF, XAF, XPF, CLP, COP, KMF, CDF, BAM, NIO, CRC, HRK, CUP, CZK, GMD, DKK, MKD, DJF, STD, DOP, VND, XCD, EGP, SVC, ETB, EUR, FKP, FJD, HUF, GHS, GIP, HTG, PYG, GNF, GYD, HKD, UAH, ISK, INR, IRR, IQD, JMD, JOD, KES, PGK, LAK, KWD, MWK, AOA, MMK, GEL, LBP, ALL, HNL, SLL, LRD, LYD, SZL, LSL, MGA, MYR, MUR, MXN, MXV, MDL, MAD, MZN, BOV, NGN, ERN, NAD, NPR, ANG, ILS, TWD, NZD, BTN, KPW, NOK, PEN, MRU, PKR, MOP, TOP, CUC, UYU, PHP, GBP, BWP, QAR, GTQ, ZAR, OMR, KHR, RON, MVR, IDR, RUB, RWF, SHP, SAR, RSD, SCR, SGD, SBD, KGS, SOS, TJS, SSP, LKR, SDG, SRD, SEK, CHF, SYP, BDT, WST, TZS, KZT, TTD, MNT, TND, TRY, TMT, AED, UGX, COU, CLF, UYI, USD, USN, USS, UZS, VUV, CHE, CHW, KRW, YER, JPY, CNY, ZMW, ZWL, PLN
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
flagbooleanrequiredExample true
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
momentstring (date-time)requiredExample 2026-08-19T04:21:07Z
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
numbernumberrequiredExample 12.5
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
percentnumberrequiredExample 12.5
A list, a range or a window, as the engine shows it.
shownstringrequiredA value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
textstringrequiredA value that is sensitive, so the record does not hold it.
A value that is sensitive, so the record does not hold it.
typeenumrequiredRdecResultAttributesrulePolicyIdRpolIdrequiredIdentifier of a rule policy.
Example rpol_9f2Kd8QpLzXw
ruleVersioninteger (int32)requiredThe version of the policy the rule was evaluated at.
Example 1250
templateIdstringrequiredtemplateVersioninteger (int32)requiredThe version of the template the rule was evaluated by.
Example 1250
modeRpolModerequiredShadowEnforcingUnknownmatchedbooleanrequiredExample true
actionstringThe action the rule fired. Absent for a rule that fired none.
typeenumrequiredRdecArgumentAttributesargumentstringrequiredsensitivityRareaSensitivityrequiredPlainPersonalCardCredentialUnknowntypeA field the evaluation found no value for.
A field the evaluation found no value for.
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
An amount in minor current units of a given currency.
typeenumrequiredIsoCurrencyAmountminorCurrencyUnitsinteger (int64)requiredThe amount in minor currency units (e.g. cents for AUD).
Example 1250
currencyIsoCurrencyrequiredThe currency of the given amount as a 3 letter ISO code.
AFNDZDARSAMDAWGAUDAZNBSDBHDTHB+156 moreShow fewer
PAB, BBD, BYR, BZD, BMD, VEF, BOB, BRL, BND, BGN, BIF, CAD, CVE, KYD, XOF, XAF, XPF, CLP, COP, KMF, CDF, BAM, NIO, CRC, HRK, CUP, CZK, GMD, DKK, MKD, DJF, STD, DOP, VND, XCD, EGP, SVC, ETB, EUR, FKP, FJD, HUF, GHS, GIP, HTG, PYG, GNF, GYD, HKD, UAH, ISK, INR, IRR, IQD, JMD, JOD, KES, PGK, LAK, KWD, MWK, AOA, MMK, GEL, LBP, ALL, HNL, SLL, LRD, LYD, SZL, LSL, MGA, MYR, MUR, MXN, MXV, MDL, MAD, MZN, BOV, NGN, ERN, NAD, NPR, ANG, ILS, TWD, NZD, BTN, KPW, NOK, PEN, MRU, PKR, MOP, TOP, CUC, UYU, PHP, GBP, BWP, QAR, GTQ, ZAR, OMR, KHR, RON, MVR, IDR, RUB, RWF, SHP, SAR, RSD, SCR, SGD, SBD, KGS, SOS, TJS, SSP, LKR, SDG, SRD, SEK, CHF, SYP, BDT, WST, TZS, KZT, TTD, MNT, TND, TRY, TMT, AED, UGX, COU, CLF, UYI, USD, USN, USS, UZS, VUV, CHE, CHW, KRW, YER, JPY, CNY, ZMW, ZWL, PLN
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
flagbooleanrequiredExample true
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
momentstring (date-time)requiredExample 2026-08-19T04:21:07Z
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
numbernumberrequiredExample 12.5
A value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
percentnumberrequiredExample 12.5
A list, a range or a window, as the engine shows it.
shownstringrequiredA value a decision's record holds. A value the area marks sensitive is withheld, its name and kind kept and its value never.
textstringrequiredA value that is sensitive, so the record does not hold it.
A value that is sensitive, so the record does not hold it.
hasMorebooleanrequiredWhether further items exist after this page.
Example true
nextStartingAfterstringId to pass as startingAfter to fetch the next page. Present in cursor mode only.
totalCountinteger (int64)Total items matching the query.
Example 42
pageinteger (int32)The 1-based page returned. Present in offset mode only.
Example 1250
totalPagesinteger (int32)Total pages available. Present in offset mode only.
Example 1250
{
"type": "RdecPageAttributes",
"data": [
{
"type": "RdecViewAttributes",
"ruleDecisionId": "rdec_9f2Kd8QpLzXw",
"domain": "string",
"owner": {
"type": "RpolOwnerEnterprise",
"enterpriseId": "ent_9f2Kd8QpLzXw"
},
"snapshotVersion": 1250,
"targetId": "string",
"targetVersion": 1250,
"matchedRuleIds": [
"rpol_9f2Kd8QpLzXw"
],
"shadowRuleIds": [
"rpol_9f2Kd8QpLzXw"
],
"namedLists": [
{
"type": "RdecListAttributes",
"namedListId": "nlst_9f2Kd8QpLzXw",
"version": 1250
}
],
"outcome": "NoMatch",
"decidedAt": "2026-08-19T04:21:07Z",
"inputs": [
{
"type": "RdecInputAttributes",
"field": "string",
"sensitivity": "Plain",
"value": {
"type": "RdecValueAbsent"
}
}
],
"results": [
{
"type": "RdecResultAttributes",
"rulePolicyId": "rpol_9f2Kd8QpLzXw",
"ruleVersion": 1250,
"templateId": "string",
"templateVersion": 1250,
"mode": "Shadow",
"matched": true,
"action": "string",
"arguments": [
{
"type": "RdecArgumentAttributes",
"argument": "string",
"sensitivity": "Plain",
"value": {
"type": "RdecValueAbsent"
}
}
]
}
]
}
],
"hasMore": true,
"nextStartingAfter": "string",
"totalCount": 42,
"page": 1250,
"totalPages": 1250
}Error responses
statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}statusCodeinteger (int32)requiredHTTP status code for this error
errorCodestringrequiredAn APG Pay code providing a brief explanation of the underlying error. Use this if you wish to provide custom behaviour based on the error type.
messagestringrequiredHuman readable description of the error
tracerstringAn unique identifier for the request. Provide this to the support team if you wish to query a particular error.
detailstringOptional additional details for the error.
errorTypeDescriptionstringA description of the category of errors for the given statusCode.
metadataobjectOptional key value list of metadata
{
"statusCode": 100,
"errorCode": "string",
"message": "string",
"tracer": "string",
"detail": "string",
"errorTypeDescription": "string"
}