--- title: "List Card Management Actions [EXPERIMENTAL]" method: GET path: "/cardManagement/actions" tags: ["Card Management"] --- # List Card Management Actions \[EXPERIMENTAL\] `GET /cardManagement/actions` ## Request - Base URL: `https://eu-west-1.api.silverflow.com/v1` - URL: `https://eu-west-1.api.silverflow.com/v1/cardManagement/actions` - Auth: one of: - HTTP basic - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Allows you to list and paginate through all the card management actions that have been created, with optional filtering. Permissions: `cardManagement:Get`, `cardManagement:All` ## Query parameters - `query` union - InitialRequestByDatesQuery - `from` string, date-time: Inclusive lower bound of the creation time range (ISO date-time). - `to` string, date-time: Inclusive upper bound of the creation time range (ISO date-time). - `sortOrder` 'asc' | 'desc': The order in which to return actions by creation time. - `limit` integer: The maximum number of actions to return. - InitialRequestByTransactionReferenceQuery - `transactionReference` string, required: Filter by the transaction reference. - `sortOrder` 'asc' | 'desc': The order in which to return actions by creation time. - `limit` integer: The maximum number of actions to return. - OffsetTokenQuery - `offsetToken` string, required: Offset token used to fetch the next page of results. ## Response `200` OK - ListCardManagementActionsResponse - `offsetToken` string: If returned then there are more items available which you can retrieve by making another request to this endpoint. It is valid for 24 hours from when it is returned. - `actions` GetCardManagementActionResponse[], required - union - GetPinChangeResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'pin_change', required - `result` 'approved' | 'declined' | 'reversed', required - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `authorizationIsoFields` AuthorizationIsoFields, required: The values from the ISO8583 response message received from the network. - `responseCode` string, required: Contents of field 39 - `responseCodeDescription` string, required: The description of the `responseCode` - `authorizationCode` string: Contents of field 38 - `networkCode` string, required: Contents of field 63, subfield 1 - `systemTraceAuditNumber` string, required: Contents of field 11 - `retrievalReferenceNumber` string, required: Contents of field 37 - `networkSpecificFields` union, required - VisaNetworkFields: Visa specific ISO8583 raw values - … - MastercardNetworkFields: Mastercard specific ISO8583 raw values - … - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `lastModified` string, iso-8601-date-time: The date and time this object was last modified - `version` integer, required: The version of this object - GetPinUnblockResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'pin_unblock', required - `result` 'approved' | 'declined', required: The result of the authorization. - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `authorizationIsoFields` AuthorizationIsoFields, required: The values from the ISO8583 response message received from the network. - `responseCode` string, required: Contents of field 39 - `responseCodeDescription` string, required: The description of the `responseCode` - `authorizationCode` string: Contents of field 38 - `networkCode` string, required: Contents of field 63, subfield 1 - `systemTraceAuditNumber` string, required: Contents of field 11 - `retrievalReferenceNumber` string, required: Contents of field 37 - `networkSpecificFields` union, required - VisaNetworkFields: Visa specific ISO8583 raw values - … - MastercardNetworkFields: Mastercard specific ISO8583 raw values - … - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `version` integer, required: The version of this object - GetBalanceInquiryResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'balance_inquiry', required - `result` 'approved' | 'declined', required: The result of the authorization. - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `authorizationIsoFields` AuthorizationIsoFields, required: The values from the ISO8583 response message received from the network. - `responseCode` string, required: Contents of field 39 - `responseCodeDescription` string, required: The description of the `responseCode` - `authorizationCode` string: Contents of field 38 - `networkCode` string, required: Contents of field 63, subfield 1 - `systemTraceAuditNumber` string, required: Contents of field 11 - `retrievalReferenceNumber` string, required: Contents of field 37 - `networkSpecificFields` union, required - VisaNetworkFields: Visa specific ISO8583 raw values - … - MastercardNetworkFields: Mastercard specific ISO8583 raw values - … - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `version` integer, required: The version of this object - ReversePinChangeResponse - `key` string, required: Uniquely identifies a card-management action. - `reversedActionKey` string, required: Uniquely identifies a card-management action. - `type` 'pin_change_reversal', required - `result` 'approved' | 'declined', required: The result of the authorization. - `authorizationIsoFields` AuthorizationIsoFields, required: The values from the ISO8583 response message received from the network. - `responseCode` string, required: Contents of field 39 - `responseCodeDescription` string, required: The description of the `responseCode` - `authorizationCode` string: Contents of field 38 - `networkCode` string, required: Contents of field 63, subfield 1 - `systemTraceAuditNumber` string, required: Contents of field 11 - `retrievalReferenceNumber` string, required: Contents of field 37 - `networkSpecificFields` union, required - VisaNetworkFields: Visa specific ISO8583 raw values - … - MastercardNetworkFields: Mastercard specific ISO8583 raw values - … - `created` string, iso-8601-date-time, required: The date and time this object was created - `version` integer, required: The version of this object ## Other responses - `400`: Bad Request - `401`: Unauthorized - `403`: Forbidden - `429`: Too Many Requests - `500`: Internal Server Error --- [API](https://skmtc.dev/silverflow/apis/silverflow-api.md) - [All operations](https://skmtc.dev/silverflow/apis/silverflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverflow/apis/silverflow-api/revisions/43ecbe4fd6ea?raw)