Marqeta

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