---
title: "List the daily authorisation summaries"
method: GET
path: "/authorisations/authorisation-summaries"
tags: ["Endpoints"]
---

# List the daily authorisation summaries

`GET /authorisations/authorisation-summaries`

Return a list of all authorisation summaries for the days within the given date range, restricted by your allianceCode,
partnerCode or merchant ID (as appropriate).

## Query parameters

- `createdAfter` string, date
- `createdBefore` string, date
- `limit` integer — Number of elements to be returned in a single query. Can be used for page/offset or cursor based pagination
- `offset` integer — Starting point to start retrieving the elements from. It is "0" based i.e. value "0" signifies the first page. This can be used with "limit". Can be used for page/offset based pagination.

## Headers

- `Partner-Code` string
- `Merchant-Id` string

## Response `200`

OK

- AuthorisationSummary — A daily summary for authorisations for a given merchant. Shows aggregate statistics for approved, declined, and reversed authorisations.
  - `combined` object
    - `approved` integer — The total number of authorisations that were in the `APPROVED` state across all results within this summary.
    - `declined` integer — The total number of authorisations that were in the `DECLINED` state across all results within this summary.
    - `reversed` integer — The total number of authorisations that were reversed across all results within this summary.
    - `merchant` object — A merchant is the business entity that the transaction was performed at.
      - `id` string — External merchant id provided by client (if merchant ids have been pre allocated) or generated by our systems during merchant boarding.
      - `allianceCode` string, nullable — An alliance is typically an organization holding an acquiring licence issued by card schemes (like VISA, MasterCard etc). This code is assigned by us.
      - `partnerCode` string, nullable — Partners are typically companies (such as Payment Facilitators, Independent Software Vendors, Independent Sale Organisations) who can contract merchants for card acceptance but they don't hold an acquiring licence so must always be authorized by an Alliance.
  - `daily` object[]
    - `day` string, date — The day of records that the summarised data includes, for example `2022-02-15` would mean that the entry includes all authorisations created on the 15th February 2022.
    - `approved` integer — The number of authorisations that were in the `APPROVED` state for that day.
    - `declined` integer — The number of authorisations that were in the `DECLINED` state for that day.
    - `reversed` integer — The number of authorisations that were reversed for that day.
    - `_links` object — HAL-style links to other related resources within our APIs
      - `authorisations` object
        - `href` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal server error

---

[API](https://skmtc.net/fiserv/apis/acquirer-profile-in-design.md) · [All operations](https://skmtc.net/fiserv/apis/acquirer-profile-in-design/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiserv/acquirer-profile-in-design/revisions/dd7ef6ce81a1/schema)