---
title: "List network totals"
method: GET
path: "/v1/reports/settlement/network_totals"
tags: ["Settlement Report"]
---

# List network totals

`GET /v1/reports/settlement/network_totals`

List network total records with optional filters. Not available in sandbox.

## Query parameters

- `report_date` string, date
- `report_date_begin` string, date
- `report_date_end` string, date
- `network` 'AMEX' | 'VISA' | 'MASTERCARD' | 'MAESTRO' | 'INTERLINK'
- `institution_id` string
- `settlement_institution_id` string
- `begin` string, date-time
- `end` string, date-time
- `page_size` integer
- `starting_after` string, uuid
- `ending_before` string, uuid

## Response `200`

OK

- NetworkTotalsList
  - `data` NetworkTotal[], required
    - `token` string, uuid, required — Globally unique identifier.
    - `network` 'AMEX' | 'VISA' | 'MASTERCARD' | 'MAESTRO' | 'INTERLINK', required — Card network where the transaction took place. AMEX, VISA, MASTERCARD, MAESTRO, or INTERLINK.
    - `institution_id` string, required — The institution that activity occurred on. For Mastercard: ICA (Interbank Card Association). For Maestro: institution ID. For Visa: lowest level SRE (Settlement Reporting Entity).
    - `settlement_institution_id` string, required — The institution responsible for settlement. For Mastercard: same as `institution_id`. For Maestro: billing ICA. For Visa: Funds Transfer SRE (FTSRE).
    - `settlement_service` string, required — Settlement service.
    - `report_date` string, date, required — Date that the network total record applies to. YYYY-MM-DD format.
    - `cycle` integer — The clearing cycle that the network total record applies to. Mastercard only.
    - `currency` string, required — 3-character alphabetic ISO 4217 code.
    - `is_complete` boolean, required — Indicates that all settlement records related to this Network Total are available in the details endpoint.
    - `amounts` object, required
      - `gross_settlement` integer, required — Total settlement amount excluding interchange, in currency's smallest unit.
      - `interchange_fees` integer, required — Interchange amount, in currency's smallest unit.
      - `visa_charges` integer — Charges specific to Visa/Interlink, in currency's smallest unit.
      - `net_settlement` integer, required — `gross_settlement` net of `interchange_fees` and `visa_charges` (if applicable), in currency's smallest unit.
    - `created` string, date-time, required — RFC 3339 timestamp for when the record was created. UTC time zone.
    - `updated` string, date-time, required — RFC 3339 timestamp for when the record was last updated. UTC time zone.
  - `has_more` boolean, required — Indicates whether there are more network total records to be retrieved.

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `422` — Unprocessable entity.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)