Get Card Tokens

post

https://api-{corename}.{env}.gpsrv.com/intserv/4.0/getCardTokens

Use the Get Card Tokens endpoint to retrieve information on tokens associated with a card. To use this endpoint, the MTLCM product parameter must be set. This endpoint is currently valid only for Mastercard.

🚧
Notice
The token-management endpoints are available by special arrangement only. Enabling this feature requires additional setup and costs. Contact Galileo for details.

Status codes

See Global Response Statuses for status codes that are common across endpoints.

Form Data

apiLogin

string

required

Web service username, as provided by Galileo.
Pattern: Max 50 characters
Example: "AbC123-9999"

apiTransKey

string

required

Web service password, as provided by Galileo.
Pattern: Max 15 characters
Example: "4sb62fh6w4h7w34g"

providerId

int32

required

Galileo-issued provider identifier.
Pattern: Max 10 digits
Example: 9999

transactionId

string

required

1 to 60

A unique provider-generated ID to identify this API call. A UUID is preferred.
Pattern: 60 characters or less
Example: "9845dk-39fdk3fj3-4483483478"

accountNo

string

required

≤ 18

The PRN, PAN or CAD of the account. For card-specific endpoints such as this one, the CAD is preferred. Do not use the PRN if more than one card has ever been associated with this account.
Pattern: PAN, PRN, or CAD
Example: "999103447228"

tokenUniqueReference

string | null

A unique 48-character reference assigned to a token and used to identify the token for the duration of its lifetime.
Pattern: 48-char alphanumeric
Example: "DWSPMC00000000010906a349d9ca4eb1a4d53e3c90a11d9c"

includeDeviceTokensOnly

boolean

Defaults to false

Specifies whether to receive only the tokens tied to the cardholder device:

true — MDES returns only the device-based tokens
false — MDES returns all tokens mapped to the PAN (server, device, and COF).

Pattern: Boolean
Example: true

excludeDeletedIndicator

boolean

Defaults to true

Specifies whether to exclude deleted tokens from the search results. Valid values:

true — Exclude deleted tokens from the search results.
false — Include deleted tokens in the search results.

Pattern: true or false
Example: true

Headers

response-content-type

string

enum

Defaults to json

Use this header instead of the standard accept header to specify the response format.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/xml

Status codes

default