Sign in

v1

latestOpenAPI 3.0.32026-07-248079274.0 KB
Account Updater

List Account Updater requests

Retrieve a paginated list of Account Updater requests across your stored cards - both the manual requests you create through the create endpoint 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.

get/account-updater

Query parameters

offsetinteger

The record to start the response on.

limitinteger

A limit on the scope of values returned in the response.

card_idstring uuid

Filter to a single card.

customer_idstring uuid

Filter results to cards stored against a specific customer_id.

company_idstring uuid

Optional. Filter results to a single company you have access to. Results are always limited to the companies your credentials can access; when set, company_id narrows them further to the specified company. This filter is applied in addition to — not instead of — the Company-Id header scope, and you must have permission for the company supplied.

merchant_idinteger

Filter to a single merchant, by its numeric merchant ID.

statusstring

Filter by status. Comma-separate multiple values, e.g. completed,failed. Allowed values: pending, submitted, completed, failed.

created_fromstring date-time

Return requests created at or after this ISO 8601 datetime.

created_tostring date-time

Return requests created at or before this ISO 8601 datetime.

completed_fromstring date-time

Return requests completed at or after this ISO 8601 datetime.

completed_tostring date-time

Return requests completed at or before this ISO 8601 datetime.

Headers

Company-Idstring uuid

Unique ID assigned by Acquired.com for your company.

Midstring uuid

Unique ID assigned by Acquired.com connecting to a specific acquiring bank.

Response

OK

Example response

{
  "meta": {
    "links": [
      {
        "rel": "first",
        "href": "/v1/path?offset=0",
        "title": "first page"
      }
    ]
  },
  "data": [
    {
      "id": "0190f9bd-2c4f-7000-9000-aabbccddeeff",
      "card_id": "a7e3fde5-5b83-44f4-9915-782bc7121717",
      "customer_id": "b1d4e0f2-7c3a-4e5b-9f6d-1a2b3c4d5e6f",
      "mid_id": "c2e5f1a3-8d4b-4f6c-a07e-2b3c4d5e6f70",
      "initiated_by": "manual",
      "status": "completed",
      "outcome": "card_updated",
      "outcome_detail": {
        "previous_bin": "492181",
        "previous_last4": "1234",
        "previous_expiry_month": 1,
        "previous_expiry_year": 26,
        "new_bin": "550000",
        "new_last4": "5678",
        "new_expiry_month": 4,
        "new_expiry_year": 31
      },
      "created_datetime": "2026-06-20T10:00:00Z",
      "submitted_datetime": "2026-06-20T10:05:00Z",
      "completed_datetime": "2026-06-21T02:45:00Z"
    }
  ]
}