Retrieve consumer wallet instruments
Header Parameters
The IP using which the actor is making the request
The unique id of the device using which the actor is making the request
The user agent of the device using which the actor is making the request
The actor on behalf of whom the API request is being performed
Query Parameters
Email address of the user whose instruments are being retrieved. One of email, user_id, or mobile + mobile_country_code is required.
Hash id of the user whose instruments are being retrieved. One of email, user_id, or mobile + mobile_country_code is required.
Mobile country code of the user. Must be supplied together with mobile.
Mobile number of the user. Must be supplied together with mobile_country_code.
Optional filter to return only cards of the given card type code.
Optional filter to return only the card matching this card hash id.
Optional filter to return only the card matching this proxy number.
Path Parameters
Unique identifier for your program, issued by MatchMove during onboarding. All requests must use the program_code assigned to your integration. Using a program_code that does not belong to your integration will result in an authorization error.
Response
Consumer instruments retrieved successfully.
Response Attributes
Wallet identifier.
Account identification number for the wallet.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Cards linked to this wallet.
Show child attributes
Bad Request
The response code field indicates which specific rule was violated.
Possible error codes:
email_mobile_user_id_required- Parameteremailoruser_idormobile_country_codeandmobileis missingresource_user_wallet_fund_mobile_insufficient_dependency- Bothmobile_country_codeandmobilemust be specifieduser_not_found- User not found or does not exist
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Unauthorized Request
The response code field indicates which specific rule was violated.
Possible error codes:
invalid_token- Access denied due to invalid token on header
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Forbidden
The response code field indicates which specific rule was violated.
Possible error codes:
access_denied- Access is denied for this resource
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Found
The response code field indicates which specific rule was violated.
Possible error codes:
user_wallet_not_found- The wallet cannot be found
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Method Not Allowed
The response code field indicates which specific rule was violated.
Possible error codes:
method_not_allowed- The HTTP method is not allowed here
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Internal Server Error
The response code field indicates which specific rule was violated.
Possible error codes:
internal_error- An internal gateway error occurred
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Not Implemented
The response code field indicates which specific rule was violated.
Possible error codes:
not_implemented- This operation is not implemented
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Bad Gateway
The response code field indicates which specific rule was violated.
Possible error codes:
bad_gateway- Bad gateway error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Service Unavailable
The response code field indicates which specific rule was violated.
Possible error codes:
service_unavailable- Service is temporarily unavailable
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp
Gateway Timeout
The response code field indicates which specific rule was violated.
Possible error codes:
gateway_timeout- Gateway timeout error.
Response Attributes
Unique hash-id for the error message
Error response status code
Error response code
Error response title
Error response detail
Source defines the multiple error messages
Show child attributes
Response timestamp