---
title: "List expense checks"
method: GET
path: "/risk/v1/expense-checks"
tags: ["Risk.Expense Check"]
---

# List expense checks

`GET /risk/v1/expense-checks`

Lists expense checks.

## Query parameters

- `pageSize` integer
- `pageToken` string

## Response `200`

A successful response.

- V1ListExpenseChecksResponse
  - `expenseChecks` V1ExpenseCheckSummary[], required — List of instances.
    - `appId` string, required — The identifier of the app that has been created by the client in console and linked to the expense check product.
    - `createdTime` string, date-time, required — The creation time of the expense check.
    - `engineVersion` string, required — The version of the engine that generated the expense check.
    - `externalReference` string — An external reference given by the client when creating the expense check.
    - `id` string, required — The internal identifier of the expense check.
    - `identity` V1Identity
      - `name` string — The name of the end-user that is logging in to their bank.
      - `ssn` string — The end-user's social security number (depending on the availability of such from the underlying bank, cannot be assumed to be populated per default).
    - `userId` string, required — The internal identifier of the user linked to the request.
  - `nextPageToken` string — Pointer to the next page.
  - `prevPageToken` string — Pointer to the previous page.

## Other responses

- `400` — The request does not pass validation. This could for example be an invalid app id. Check the error message or the documentation of each field for more information.
- `401` — Wrong scopes associated with the access token.
- `403` — The resource does not belong to subject associated with the access token.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)