{ "opencollection": "1.0.0", "info": { "name": "Marqeta DiVA API", "version": "2" }, "request": { "auth": { "type": "basic", "username": "{{username}}", "password": "{{password}}" } }, "items": [ { "info": { "name": "Views", "type": "folder" }, "items": [ { "info": { "name": "List available views", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views", "params": [ { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." } ] }, "docs": "Returns a list of all available view endpoints for the DiVA API. Each view provides access to a specific type of program data aggregated at a defined level. Use this endpoint to discover which datasets are available for your program." } ] }, { "info": { "name": "Program Balances", "type": "folder" }, "items": [ { "info": { "name": "Retrieve program funding balances", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/programbalances/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns program funding balance data aggregated over the specified time period. Use this endpoint for financial reconciliation to retrieve beginning bank balance, amount to send, and ending bank balance. Supports daily, weekly, and monthly aggregation levels. An example request for daily balances: /views/programbalances/day?program=my_program&fields=beginning_bank_balance,amount_to_send,ending_bank_balance" }, { "info": { "name": "Retrieve program settlement balances", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/programbalancessettlement/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns program settlement balance data aggregated over the specified time period. Settlement balances reflect funds settled between Marqeta and the card networks. Use this alongside the programbalances view for full financial reconciliation." }, { "info": { "name": "Retrieve activity balance data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/activitybalances/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns cardholder activity balance data aggregated over the specified time period. Provides a summary of GPA balance changes driven by card transactions, loads, and transfers for program financial reporting." } ] }, { "info": { "name": "Transactions", "type": "folder" }, "items": [ { "info": { "name": "Retrieve authorization transaction data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/authorizations/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns authorization transaction data aggregated over the specified time period. Includes approved and declined authorizations with response codes, merchant details, and transaction amounts. Use the detail aggregation level to retrieve individual authorization records." }, { "info": { "name": "Retrieve settlement transaction data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/settlements/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns settlement transaction data at a specified aggregation level. Settlement data reflects finalized transactions after card network clearing. Use this endpoint to reconcile cleared transactions against your financial records." } ] }, { "info": { "name": "Cards", "type": "folder" }, "items": [ { "info": { "name": "Retrieve card state and history data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/cards/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns card state and history data aggregated at card level or by time period. Use this endpoint to report on card issuance volume, card state distribution, and card activity across your program." }, { "info": { "name": "Retrieve detailed card information", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/cards/detail", "params": [ { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns detailed information for each card in your program, including the full card lifecycle history, current state, expiration, and associated user. Use this endpoint for granular card-level reporting and auditing." } ] }, { "info": { "name": "Users", "type": "folder" }, "items": [ { "info": { "name": "Retrieve user activity data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/users/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns cardholder (user) data aggregated over the specified time period. Includes registration counts, KYC status distributions, and account status summaries for program reporting." }, { "info": { "name": "Retrieve detailed user information", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/users/detail", "params": [ { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns detailed information for each cardholder in your program, including current account status, KYC verification status, associated cards, and GPA balance summary." } ] }, { "info": { "name": "Loads", "type": "folder" }, "items": [ { "info": { "name": "Retrieve funding load data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/loads/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns funding load transaction data at a specified aggregation level. When using the detail aggregation level, each row represents a single funding load transaction. Supports daily, weekly, monthly, and detail levels. Covers ACH loads, push-to-card loads, and program transfers." } ] }, { "info": { "name": "Chargebacks", "type": "folder" }, "items": [ { "info": { "name": "Retrieve chargeback data", "type": "http" }, "http": { "method": "GET", "url": "https://diva-api.marqeta.com/data/v2/views/chargebacks/:time_agg", "params": [ { "name": "time_agg", "value": "", "type": "path", "description": "Aggregation time level for the data. Use 'day' for daily rollups, 'week' for weekly rollups, 'month' for monthly rollups, or 'detail' for individual record-level data." }, { "name": "program", "value": "", "type": "query", "description": "The name of your Marqeta card program. This parameter is required for most DiVA API endpoints to scope the data to your program." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-delimited list of fields to include in the response. If not specified, all available fields are returned." }, { "name": "start_date", "value": "", "type": "query", "description": "Start date for filtering data (format YYYY-MM-DD). Returns records on or after this date." }, { "name": "end_date", "value": "", "type": "query", "description": "End date for filtering data (format YYYY-MM-DD). Returns records on or before this date." }, { "name": "format", "value": "", "type": "query", "description": "Response format. Use 'json' for JSON responses or 'csv' for comma-separated bulk file format. Defaults to json." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of records to return per request." }, { "name": "offset", "value": "", "type": "query", "description": "Zero-based offset for pagination." } ] }, "docs": "Returns chargeback data aggregated by transaction or time period. Includes dispute status, amounts, reason codes, and resolution details for tracking chargeback activity and financial exposure." } ] } ], "bundled": true }