Marqeta cards API
The cards API from Marqeta — 11 operation(s) for cards.
Marqeta cards API is one of 81 APIs that Marqeta publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Cards. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 15 operations across 11 paths, and defines 122 schemas. It is described by OpenAPI 3.0.3, at version 3.0.39.
Requests are made against a single base URL, /v3.
15 operations
11 paths
122 schemas
10 GET3 POST2 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Marqeta cards API declares
1 security scheme
for authenticating requests.
It accepts HTTP basic authentication (mqAppAndAccessToken).
By default, every request must be authenticated.
Paths & Operations 15
Across 11 paths, the API surfaces 15 operations — 10 GET, 3 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.
cards 15
GET
/cards
Lists cards by the last 4 digits
POST
/cards
Creates a card
GET
/cards/barcode/{barcode}
Returns a card's metadata
POST
/cards/getbypan
Returns user and card tokens for the specified PAN
GET
/cards/user/{token}
Lists all cards for a specific user
GET
/cards/{token}
Returns a specific card
PUT
/cards/{token}
Updates a specific card
GET
/cards/{token}/showpan
Returns a specific card - PAN visible
GET
/cards/{token}/stoporders
Lists all stop orders for a card
POST
/cards/{token}/stoporders
Creates a stop order for a card transaction
GET
/cards/{token}/stoporders/{stop_order_token}
Retrieves a specific stop order
PUT
/cards/{token}/stoporders/{stop_order_token}
Updates a stop order by token
GET
/cards/{token}/transactions
Returns transactions for a specific card
GET
/views/cards/{time_agg}
Retrieve card state and history data
GET
/views/cards/detail
Retrieve detailed card information
Schemas 122
The contract defines 122 schemas that model the data the API accepts and returns. The most detailed are transaction_model (119 properties), user_card_holder_response (40 properties), card_response (32 properties), transaction_card_acceptor (29 properties). Each schema is shown below with its type and property counts.
transaction_metadata
object
Contains merchant-provided metadata related to the transaction, including details about lodging- and transit-related purchases. May be returned if the request…
13 properties
cardholder_verification
object
2 properties
transaction_card_acceptor
object
Contains information about the merchant.
29 properties
CardFulfillmentResponse
object
Determines physical characteristics of a card and shipment information.
3 properties
1 required
account_owner_model
object
Information about the owner of an account participating in an account funding or original credit transaction.
5 properties
fleet_data
object
Contains details about fleet program transactions.
2 properties
gpa_response
object
Contains information about a GPA order, including fees, funding sources, and addresses. See for more information.
19 properties
10 required
transaction_device
object
Contains information about the device used in the transaction to enhance the risk decisioning process. Use this data to improve fraud prevention and dispute re…
4 properties
card_response
object
Contains information about the card used in the transaction.
32 properties
14 required
airline
object
Contains information about airline-related transactions.
3 properties
funding_source_model
object
Contains funding source information for the transaction, including the funding type and time.
6 properties
6 required
images
object
Specifies personalized images that appear on the card.
4 properties
card_security_code_verification
object
Contains information about a verification check performed on the card's security code.
2 properties
2 required
network_fraud_view
object
Contains network-provided information about fraud determinations.
9 properties
CardsDetailResponse
object
Detailed card records response.
2 properties
cardholder_metadata
object
Contains customer-provided information about the cardholder that performed the transaction.
1 property
BillPayResponse
object
10 properties
triggered_rule
object
Provides a list of rules triggered by a fraud event, along with the information on tags and rule characteristics.
5 properties
pan_response
object
4 properties
4 required
risk_assessment
object
Contains the digital wallet provider's risk assessment for provisioning the digital wallet token.
2 properties
DepositDepositResponse
object
Contains information about a direct deposit.
19 properties
images_card
object
Specifies personalized images that appear on the card.
2 properties
account_balance
object
7 properties
store_response_model
object
24 properties
8 required
fee
object
Contains details about the fee.
8 properties
6 required
fraud_view
object
Contains one or more fraud determinations by the card network that apply to either the transaction or the cardholder's account.
3 properties
installment_data
object
Contains the installment plan identifier used by the Visa Transaction Matching Service for Issuers.
1 property
fulfillment_address_request
object
11 properties
merchant_response_model
object
18 properties
3 required
gpa
object
Defines the type of order.
2 properties
2 required
stop_order_request
object
5 properties
2 required
gateway_response
object
Contains information from the gateway in response to a funding request.
2 properties
1 required
terminal_model
object
Contains information about the point of sale, including details on how the card was presented. Returned if provided by the card network, and the request uses T…
8 properties
ShippingInformationResponse
object
Specifies shipping details for the order. This object is returned if it exists in the resource.
4 properties
chargeback_response
object
Contains the chargeback object associated with this transaction if a chargeback has been initiated.
13 properties
9 required
jit_address_verification
object
Contains address verification data used to make JIT Funding decisions.
3 properties
ATCInformationModel
object
3 properties
text_value
object
1 property
response
object
Response codes and memos for account name verification, address verification, card security verification, and transactions.
3 properties
1 required
fee_detail
object
Contains details about a fee.
6 properties
3 required
network_fee_model
object
Contains card network fees assessed against the cardholder.
4 properties
program_reserve_transaction_response
object
11 properties
2 required
ImagesCarrier
object
Specifies personalized images that appear on the card carrier.
2 properties
address_verification
object
Contains address verification information.
4 properties
auto_reload_association
object
Specifies the scope of the auto reload. Input no more than one field. If no value is supplied, the auto reload applies at the program level.
4 properties
network_account_intelligence_score
object
Account intelligence score information, as provided by the Mastercard network.
3 properties
preceding_transaction
object
Returned for authorization.clearing transaction types following a financial advice. Contains information about the preceding transaction.
2 properties
digital_wallet_token
object
Contains information about the digital wallet that funded the transaction. Returned for all transactions funded by a digital wallet or related to digital walle…
15 properties
pos
object
Contains information about the point of sale, including details on how the card was presented. Returned if provided by the card network, and the request uses T…
22 properties
card_request
object
15 properties
2 required
DivaResponseMeta
object
Metadata included in DiVA API paginated responses.
4 properties
account
object
Contains information related to the cardholder and provided by the digital wallet provider.
3 properties
FulfillmentAddressResponse
object
Specifies a fulfillment shipping or return address.
11 properties
peer_transfer_response
object
Contains information about an intra-account transfer, including sender and recipient tokens, transfer amount, and currency code.
10 properties
4 required
real_time_fee_group
object
Contains information about a real-time fee group.
6 properties
3 required
IdentificationResponseModel
object
Contains identifications associated with the cardholder.
4 properties
card_update_request
object
5 properties
1 required
StopOrderListResponse
object
5 properties
CardListResponse
object
5 properties
stop_order_response
object
15 properties
12 required
token_service_provider
object
Contains information held and provided by the token service provider (card network).
12 properties
1 required
card_personalization
object
Specifies personalized attributes to be added to the card.
4 properties
1 required
user_card_holder_response
object
Contains information about a cardholder.
40 properties
2 required
program_transfer_response
object
Contains information about a program transfer, which moves funds from an account holder's GPA to a program funding source.
12 properties
4 required
jit_account_name_verification
object
Contains account name verification data used to make JIT Funding decisions from one of the following objects: The gateway object, which contains account name v…
3 properties
business_metadata
object
Contains customer-provided information about the business that funded the transaction.
1 property
funding
object
Contains funding information for the transaction, including funding amount, type, and time.
4 properties
1 required
activation_actions
object
Defines actions to execute when the card is activated. The fields in this object are mutually exclusive.
2 properties
auto_reload_model
object
Contains information about an auto reload. See for more information. Returned if an auto reload was executed.
7 properties
2 required
pan_request
object
3 properties
1 required
program
object
Information about the program on the Marqeta platform.
3 properties
3 required
StrongCustomerAuthenticationModel
object
Strong Customer Authentication information for contactless transactions
2 properties
ErrorResponse
object
Standard error response returned by the Marqeta DiVA API.
2 properties
gpa_returns
object
Contains information about a GPA unload order.
14 properties
9 required
transit
object
Contains merchant-provided, transit-related metadata related to the transaction.
2 properties
settlement_data
object
Contains information from the card network about currency conversion at the time of settlement, including the original currency of the transaction, the amount…
3 properties
shipping
object
4 properties
account_funding
object
Contains details about account funding transactions. Account funding transactions move money into a cardholder's general purpose account (GPA).
16 properties
fee_transfer_response
object
Contains information about a fee charge, including the amount, currency code, and user or business token.
6 properties
5 required
jit_program_response
object
Contains the gateway's information about the JIT Funding transaction.
3 properties
1 required
CurrencyBalance
object
6 properties
available
object
Specifies the available balances of the velocity controls associated with a user. This object is not returned if the velocity control window is TRANSACTION, be…
3 properties
2 required
address_verification_source
object
Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Mar…
2 properties
order_scope
object
Defines the balance threshold and reload amounts.
1 property
currency_conversion
object
Contains information about currency conversion.
1 property
cardholder_authentication_data
object
Contains authentication data for 3D Secure and digital wallet token transactions: electroniccommerceindicator – The level of verification performed. verificati…
12 properties
Authentication
object
Contains the cardholder's email address and password information.
4 properties
images_carrier_return_window
object
Specifies a custom image to display in the return address window of the card carrier envelope.
1 property
flex
object
Contains information about a Flexible Credential transaction.
5 properties
gateway_log_model
object
Contains information from the JIT Funding gateway in response to a funding request.
6 properties
3 required
stop_order_update_request
object
5 properties
1 required
address_verification_model
object
Contains address verification data consisting of address data entered by the cardholder, address data held by the Marqeta platform, and an assertion by the Mar…
3 properties
text
object
Specifies personalized text that appears on the card.
3 properties
1 required
expiration_offset
object
2 properties
network_metadata
object
Contains network-related metadata for the transaction, including details about the card program and the card product. Returned if provided by the card network
10 properties
device
object
Contains information related to the device being provisioned.
8 properties
cardholder_balance
object
Returns general purpose account (GPA) balances for a user or business.
9 properties
7 required
payment_facilitator_model
object
Information about the payment facilitator of an account funding or original credit transaction.
5 properties
CardholderAddressResponse
object
Contains information about the billing address of the funding source.
17 properties
11 required
digital_commerce_authentication_program
object
11 properties
carrier
object
Specifies attributes of the card carrier.
6 properties
transaction_model
object
Transactions are represented by the transaction object. The Marqeta platform creates a separate transaction object for each transaction message received from t…
119 properties
5 required
account_name_verification_source
object
Contains account name verification data used to make JIT Funding decisions.
5 properties
tag
object
2 properties
wallet_provider_profile
object
Contains information held and provided by the digital wallet provider.
6 properties
avs_information
object
Contains address verification information.
3 properties
TransactionModelListResponse
object
5 properties
digital_service_provider
object
12 properties
digital_wallet_token_metadata
object
Contains additional information about the digital wallet token.
2 properties
account_name_verification_model
object
Contains name verification data: the full name entered by the cardholder, name data held by the Marqeta platform, and an assertion by the Marqeta platform as t…
4 properties
issuer_fraud_view
object
Contains one or more fraud determinations by the card network that apply to either the transaction or the cardholder's account.
7 properties
riskcontrol_tags
object
The RiskControl tags that were triggered by the transaction.
3 properties
images_signature
object
Specifies an image of the cardholder's signature.
1 property
jit_funding_api
object
Contains information about the JIT Funding load event, in which funds are loaded into an account. This object is returned if your program uses JIT Funding.
16 properties
4 required
network
object
Contains information from the card network about currency conversion, including the original currency of the transaction, the amount of the transaction in the…
5 properties
CashloadsResponseModel
object
1 property
DisputeModel
object
Contains information about a disputed transaction.
2 properties
ani_information
object
Contains account name verification data used to make JIT Funding decisions.
4 properties
acquirer
object
Contains information about the merchant's financial institution.
12 properties
CardsResponse
object
Card data response.
2 properties
original_credit
object
Contains information about an original credit transaction (OCT), which enables the cardholder to receive funds on the specified card from an external source vi…
17 properties
CardFulfillmentRequest
object
3 properties
1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Marqeta 12
Other APIs Marqeta publishes across the network.
Marqeta Webhooks
Marqeta Risk Controller / Real-Time Decisioning
Marqeta accepted countries API
Marqeta Account API
Marqeta Account Bundle Transitions API
Marqeta Account Cards API
Marqeta Account Documents API
Marqeta account holder groups API
Marqeta Account Refunds API
Marqeta Account Rewards API
Marqeta Account Signup Bonus API
Marqeta Account Transitions API
#Cards
Where this information came from
This is an independent, third-party profile of Marqeta cards API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.