---
title: "List services"
method: GET
path: "/rest/catalog/services"
tags: ["Catalog"]
---

# List services

`GET /rest/catalog/services`

List all available services of the provider catalog.

## Query parameters

- `q` string — finX ID of service.

## Parameters

- `#/paths/~1catalog/get/parameters/0` — unresolved $ref
- `#/paths/~1catalog/get/parameters/1` — unresolved $ref

## Response `200`

List of services.

- object[]
  - `access_methods` object[] — List of access methods available for this catalog item.
    - `id` AccessMethodId, required — unresolved $ref
    - `in_psd2_scope` boolean, required — Indicates whether payment accounts falling into the scope of the PSD2 are accessed via this method.
    - `type` 'API' | 'FINTS' | 'SCRAPING' | 'COMBINED', required — Type of the access method. Describes the interface used to access the financial provider. * `API`: access via PSD2-compliant API (e.g. Berlin Group) * `FINTS`: access via FinTS protocol (Germany only) * `SCRAPING`: access via screen scraping * `COMBINED`: combination of `API` and `SCRAPING` (Spain only)
    - `supported_account_types` Items[], required — unresolved $ref
    - `configurable_consent` boolean, required — Indicates whether consent configuration may be provided
    - `requires_account_identifiers` boolean, required — Indicates whether account identifiers have to be provided to connect this financial source.
    - `customer_authentication_flows` string[], required
    - `advice` string, required — Any advice useful to instruct the user on what data to provide. The language can be selected by sending an appropriate `Accept-Language` header with the request.
    - `credentials` object[], required
      - `type` 'TEXT' | 'EMAIL' | 'SECRET' | 'DATE' | 'CHOICE' — Specifies the type of control to render or validation rules to apply. This loosely relates to the types [defined for HTML](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#input_types) `<input>`-elements. By default, a `TEXT` type is assumed, which is rendered as a single-line text field. The `SECRET` type is similar to a `TEXT` type, but the field's value is usually obscured. `EMAIL` fields should apply validation parameters to make sure that the entered text is a valid email address. The `DATE` type should render a control for entering a date (year, month, and day, with no time). The `CHOICE` type field is intended for selecting a value from a predefined list of items. These items are provided in the `choices` property and usually rendered as a dropdown menu.
      - `key` string — Used as reference for this input field when the entered data is submitted to the finX API.
      - `label` string — Suggested display label. The language can be selected by sending an appropriate `Accept-Language` header with the request.
      - `min_length` integer — Minimum length entered text.
      - `max_length` integer — Maximum length of entered text.
      - `is_secret` boolean — Indicates whether the data entered in the input field is to be considered secret and should be masked. Superseded by the `type` property set to `SECRET`.
      - `is_optional` boolean — Indicates whether the input field has to be filled out.
      - `choices` object[] — Specifies the list of possible values for fields of type `CHOICE`.
        - `label` string — Display text describing the selectable item.
        - `value` string — Value to be sent to the API if the user selected this item.
    - `credential_type` 'UNKNOWN' | 'BASIC' | 'CONSENT' | 'OAUTH', required
  - `id` string, UUID, required — finX ID of financial service provider.
  - `name` string, required — Name of the financial service provider.
  - `icon` Icon, required — unresolved $ref
  - `is_supported` boolean, required — Indicates if access to financial source is supported by the finX API.
  - `country` Schema, required — unresolved $ref
  - `supports_instant_payments` boolean, required — Indicates if the instant payment type is supported.
  - `supports_payment_without_debtor` boolean, required — Indicates if the payment can be initiated without setting the debtor explicitly.

## Other responses

- `401` — unresolved $ref

---

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