---
title: "List of attempts"
method: GET
path: "/attempts"
tags: ["Attempts"]
---

# List of attempts

`GET /attempts`

Returns a paginated list of all attempts for a certain connection.

## Query parameters

- `connection_id` string, required — the `id` of the connection whose attempts are to be fetched

## Response `200`

OK

- AttemptsResponse
  - `data` SimplifiedAttempt[]
    - `api_mode` 'app' | 'service' — the API mode of the customer that queried the API.
    - `api_version` string — the API version in which the attempt was created
    - `automatic_fetch` boolean — whether the connection related to the attempt can be automatically fetched
    - `daily_refresh` boolean — latest assigned value for `daily_refresh` in connection
    - `categorize` boolean — whether attempt is categorized
    - `created_at` string, date-time — when the attempt was made
    - `custom_fields` object — the custom fields that had been sent when creating connection/connect\_session/oauth\_provider
    - `device_type` 'desktop' | 'tablet' | 'mobile' — the type of the device that created the attempt.
    - `remote_ip` string — the IP of the device that created the attempt
    - `exclude_accounts` string[] — the `ids` of accounts that do not need to be refreshed
    - `user_present` boolean — whether the request was initiated by the end-user of your application
    - `customer_last_logged_at` string, date-time — the datetime when user was last active in your application
    - `fail_at` string, date-time — when the attempt failed to finish
    - `fail_error_class` string — class of error that triggered the fail for attempt
    - `fail_message` string — message that describes the error class
    - `fetch_scopes` string[] — fetching mode.
    - `finished` boolean — whether the connection had finished fetching
    - `finished_recent` boolean — whether the connection had finished data for recent range
    - `from_date` string, date — date from which the data had been fetched
    - `id` string — `id` of the attempt
    - `interactive` boolean — whether the connection related to the attempt is interactive
    - `locale` string — the language of the Connect widget and of the returned error message(s) in the <a href='http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes' target="_blank">ISO 639-1</a> format. Possible values are: `bg`, `cz`, `de`, `en`, `es-MX`, `es`, `fi`, `fr`, `he`, `hr`, `hu`, `it`, `nl`, `pl`, `pt-BR`, `pt`, `ro`, `ru`, `si`, `sk`, `sv`, `tr`, `uk`, `zh-HK`(Traditional), `zh`(Simplified). Defaults to `en`.
    - `partial` boolean — whether the connection was partially fetched
    - `store_credentials` boolean — whether the credentials were stored on our side
    - `success_at` string, date-time — when the attempt succeeded and finished
    - `to_date` string, date-time — date until which the data has been fetched
    - `updated_at` string, date-time — when last attempt update occurred
    - `show_consent_confirmation` boolean — whether any consent was given for this connection
    - `include_natures` string[] — the natures of the accounts that need to be fetched
    - `last_stage` Stage
      - `created_at` string, date-time, required — when the stage was created
      - `id` string, required — the `id` of the stage
      - `interactive_fields_names` string[], nullable — the interactive fields that are currently required by the provider. Appears only for the interactive connections
      - `interactive_html` string, nullable — HTML code that shows the current interactive state of the connection. Appears only for the interactive connections
      - `name` 'start' | 'connect' | 'interactive' | 'fetch_holder_info' | 'fetch_accounts' | 'fetch_recent' | 'fetch_full' | 'disconnect' | 'finish', required — the name of the stage.
      - `updated_at` string, date-time, required — when the stage was last updated

---

[API](https://skmtc.net/saltedge/apis/salt-edge-account-information-api.md) · [All operations](https://skmtc.net/saltedge/apis/salt-edge-account-information-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/saltedge/salt-edge-account-information-api/versions/f18f4f36d0b3/schema)