Marqeta.DiVA (marqeta v1.0.0)

Copy Markdown View Source

The DiVA (Data and Insights Visualization API) provides high-performance, read-only access to aggregated, denormalised reporting views over all Core API and Credit API data.

Use DiVA for bulk reporting and analytics. For real-time single-record lookups, use the corresponding Core API modules.

Common Query Parameters

All DiVA list endpoints support:

ParameterDescription
start_dateISO 8601 date string, e.g. "2024-01-01"
end_dateISO 8601 date string
countRecords per page (max 1000)
start_indexPagination offset
sort_byField to sort by
sort_order"ASC" or "DESC"
fieldsComma-separated field selection

Examples

# One page
{:ok, page} = Marqeta.DiVA.Authorizations.list(%{
  start_date: "2024-01-01",
  end_date:   "2024-01-31",
  count:      500
})

# Stream all
Marqeta.DiVA.Settlements.stream(%{start_date: "2024-01-01"})
|> Enum.count()

# Data dictionary for a view
{:ok, dict} = Marqeta.DiVA.DataDictionary.get("authorizations")