---
title: "List Account Updater requests"
method: GET
path: "/account-updater"
tags: ["Account Updater"]
---

# List Account Updater requests

`GET /account-updater`

Retrieve a paginated list of Account Updater requests across your stored cards - both the manual requests you create through the [create endpoint](/reference/create-account-updater-request) and those raised by Acquired.com's automatic processes. Results are sorted by `created_datetime` descending.

If no date filter is supplied, results default to the last 30 days. Provide any of the date filters to query a different period.

> 📘 Older requests
>
> Some older Account Updater requests have limited information available: the outcome is shown as `unknown` with no `outcome_detail`, and the source of the request may also be unavailable.

## Query parameters

- `offset` integer
- `limit` integer
- `card_id` string, uuid
- `customer_id` string, uuid
- `company_id` string, uuid
- `merchant_id` integer
- `status` string
- `created_from` string, date-time
- `created_to` string, date-time
- `completed_from` string, date-time
- `completed_to` string, date-time

## Headers

- `Company-Id` string, uuid
- `Mid` string, uuid

## Response `200`

OK

- AccountUpdaterRequestListPaged
  - `meta` object
    - `count` integer — The number of records returned as part of the response.
    - `offset` integer — The starting record number.
    - `limit` integer — The maximum number of records that can be returned as part of the response.
    - `total` integer — The total number of records contained in the query response.
    - `links` object[]
      - `rel` 'self' | 'first' | 'last' | 'prev' | 'next'
      - `href` string — Link to the resource which should be appended to base URL.
      - `title` string — Description of the link.
  - `data` AccountUpdaterRequest[]
    - `id` string, uuid — Unique ID assigned by Acquired.com for the Account Updater request.
    - `card_id` string, uuid — The stored card the request relates to.
    - `customer_id` string, uuid — The customer the card belongs to.
    - `mid_id` string, uuid — The Mid the request was submitted under.
    - `initiated_by` 'manual' | 'decline' | 'retry_advice' | 'card_expiry', nullable — What created the request. `manual` indicates a manual request made through this API; the other values are set by Acquired.com's automatic Account Updater processes. May be `null` for some older requests, where the source was not recorded.
    - `status` 'pending' | 'submitted' | 'completed' | 'failed' — The lifecycle state of the request. - `pending` - created and waiting to be sent to the scheme. - `submitted` - sent to the scheme, awaiting a response. - `completed` - the scheme returned a result. - `failed` - the scheme could not process the request.
    - `outcome` 'card_updated' | 'card_expiry_updated' | 'no_change' | 'account_closed' | 'card_not_found' | 'provider_error' | 'unknown', nullable — The result of the request once it completes. `null` until the request reaches a terminal state. - `card_updated` - the card number (and usually expiry) changed. - `card_expiry_updated` - only the expiry date changed. - `no_change` - the card is still valid with no changes. - `account_closed` - the cardholder should be contacted (e.g. the account is closed). - `card_not_found` - the scheme did not recognise the card. - `provider_error` - the scheme could not process the request. - `unknown` - the result could not be determined. Shown for some older requests, for which the outcome and `outcome_detail` are not available.
    - `outcome_detail` object, nullable — The before/after card details. Populated only for the `card_updated` and `card_expiry_updated` outcomes; `null` for every other outcome and while the request is not yet complete. Full card numbers are never returned. The card BIN (`previous_bin` / `new_bin`) is included only when your account is permitted to receive card BIN data; otherwise those fields are omitted from the response.
      - `previous_bin` string — First 6 digits (BIN) of the card before the update. Only present when your account is permitted to receive card BIN data.
      - `previous_last4` string — Last 4 digits of the card before the update.
      - `previous_expiry_month` integer — Expiry month of the card before the update.
      - `previous_expiry_year` integer — Two-digit expiry year of the card before the update.
      - `new_bin` string, nullable — First 6 digits (BIN) of the updated card. `null` when only the expiry changed. Only present when your account is permitted to receive card BIN data.
      - `new_last4` string, nullable — Last 4 digits of the updated card. `null` when only the expiry changed.
      - `new_expiry_month` integer, nullable — Updated expiry month.
      - `new_expiry_year` integer, nullable — Updated two-digit expiry year.
    - `created_datetime` string, date-time — When the request was created.
    - `submitted_datetime` string, date-time, nullable — When the request was sent to the scheme. `null` while the request is still pending.
    - `completed_datetime` string, date-time, nullable — When the scheme response was received. `null` until the request is completed or failed.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/acquired/apis/acquired-api.md) · [All operations](https://skmtc.dev/acquired/apis/acquired-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/acquired/acquired-api/revisions/7ae178a046f2/schema)