---
title: "Get Operation"
method: GET
path: "/data/v2/connector/operations/{operationId}"
tags: ["Data v2.Connector.Operations", "REGION.US", "MULTI_TENANT"]
---

# Get Operation

`GET /data/v2/connector/operations/{operationId}`

Retrieves the current status of an asynchronous operation initiated via the data v2 Connector for transaction data (ingest, update, or delete).

The request uses the `operationId` returned when the original data v2 Connector operation was initiated to fetch its latest state of this operation.

For guidance on how to work with Get Operation endpoint in your specific product context, refer to the documentation for the relevant Tink product you use with the data v2 Connector.

## Path parameters

- `operationId` string, required

## Response `200`

A successful response.

- TinkGoldenreceiverGetOperationResponse
  - `externalOperationId` string — Client-provided operation identifier. This is the `externalOperationId` sent in the Connector v2 Transactions ingestion request, if provided.
  - `id` string, required — Tink generated Connector operation identifier.
  - `users` TinkGoldenreceiverGetOperationResponseUserIngestionStatus[] — Available users.
    - `exceptions` TinkGoldenreceiverGetOperationResponseException[] — Aggregated errors for this particular user, if any occurred.
      - `externalAccountId` string — The external account identifier specified by the customer when ingesting the account.
      - `externalTransactionId` string — The external identifier of the transaction provided by the customer.
      - `fieldPath` string — The path of the field that failed validation or ingestion.
      - `reasons` TinkGoldenreceiverGetOperationResponseExceptionReason[] — Detailed error reason.
        - `errorType` 'OTHER' | 'VALUE_NOT_UNIQUE' | 'EXTERNAL_USER_ID_NOT_EXIST' | 'DUPLICATED_EXTERNAL_USER_ID' | 'EXTERNAL_ACCOUNTS_ID_NOT_EXIST' | 'DUPLICATED_EXTERNAL_ACCOUNTS_ID' | 'NO_TRANSACTIONS_FOR_ACCOUNT' | 'DUPLICATED_EXTERNAL_TRANSACTIONS_ID' | 'EXTERNAL_TRANSACTION_ID_ALREADY_EXIST' | 'EXTERNAL_TRANSACTION_ID_NOT_EXIST' | 'EXTERNAL_TRANSACTION_ID_WAS_DELETED' | 'TRANSACTION_AMOUNT_DECIMALS_WRONG' | 'TRANSACTION_AMOUNT_TOO_BIG' | 'MISSING_TRANSACTION_ORIGINAL_DESCRIPTION' | 'MISSING_TRANSACTION_AMOUNT' | 'ANY_TRANSACTION_DATE_NOT_PROVIDED' | 'TRANSACTION_DATES_WITH_INCORRECT_FORMAT' | 'MCC_WITH_INCORRECT_FORMAT' | 'COUNTRY_CODE_WITH_INCORRECT_FORMAT' | 'ANGULAR_DISTANCE_OUT_OF_RANGE' — - OTHER: Any other reason of an error. - VALUE_NOT_UNIQUE: Value is not unique. - EXTERNAL_USER_ID_NOT_EXIST: User with provided `externalUserId` is not created for this appId. The operation cannot attach accounts or transactions to an unknown app user. - DUPLICATED_EXTERNAL_USER_ID: The same `externalUserId` appears more than once in the request for this appId. Each `externalUserId` in the request must be unique. - EXTERNAL_ACCOUNTS_ID_NOT_EXIST: Provided `externalAccountId` is not found for the given `externalUserId` within this appId (user–account relation is missing). - DUPLICATED_EXTERNAL_ACCOUNTS_ID: The same `externalAccountId` is repeated for the same `externalUserId` in this appId. Each `externalAccountId` for given `externalUserId` must be unique. - NO_TRANSACTIONS_FOR_ACCOUNT: An `externalAccountId` for a user is provided with no transactions or an empty transactions[] array. At least one transaction is required when sending an account. - DUPLICATED_EXTERNAL_TRANSACTIONS_ID: Within a single account’s transactions[], two or more items share the same `externalTransactionId`. Each `externalTransactionId` for given `externalAccountId` must be unique. - EXTERNAL_TRANSACTION_ID_ALREADY_EXIST: Provided `externalTransactionId` already exists for this account from a prior ingest. - EXTERNAL_TRANSACTION_ID_NOT_EXIST: Provided `externalTransactionId` is not found for the given `externalAccountId` (account-transaction relation is missing). - EXTERNAL_TRANSACTION_ID_WAS_DELETED: Provided `externalTransactionId` matches a transaction previously deleted for this account (within this user/appId); the ID cannot be reused. - TRANSACTION_AMOUNT_DECIMALS_WRONG: Transaction amount is present but provided with more than 2 decimal places. - TRANSACTION_AMOUNT_TOO_BIG: Transaction amount exceeds the maximum allowed absolute value for a single transaction. - MISSING_TRANSACTION_ORIGINAL_DESCRIPTION: Transaction descriptions.original is missing or null. It is required for every transaction. - MISSING_TRANSACTION_AMOUNT: Transactions amount is missing or null; A numeric amount is required for every transaction. - ANY_TRANSACTION_DATE_NOT_PROVIDED: None of bookedDateTime, valueDateTime, or transactionDateTime is provided. At least one date is required. - TRANSACTION_DATES_WITH_INCORRECT_FORMAT: One or more of bookedDateTime, valueDateTime, transactionDateTime is not in ISO 8601 format with milliseconds precision and with UTC timezone (e.g., yyyy-MM-ddTHH:mm:ss.SSSZ) - MCC_WITH_INCORRECT_FORMAT: The merchantCategoryCode is not exactly 4 digits as required by the Merchant Category Code standard (ISO 18245). - COUNTRY_CODE_WITH_INCORRECT_FORMAT: The countryCode is not a valid ISO 3166-1 alpha-2 country code (two uppercase letters). - ANGULAR_DISTANCE_OUT_OF_RANGE: A single angular distance coordinate - latitude or longitude - is invalid: format. Latitude must be −90..90 and longitude must be −180..180; values must be decimal degrees with a dot as the decimal separator.
        - `fieldName` string — Name of the field associated with the error.
        - `message` string — Description of what went wrong.
    - `externalUserId` string — The external user identifier specified by the client.
    - `status` 'PROCESSING' | 'PROCESSED' | 'FAILED' — - PROCESSING: The ingestion is in progress. - PROCESSED: The ingestion finished successfully. - FAILED: The ingestion failed with one or more errors.

## Other responses

- `400` — The request does not pass validation. Check the error message or the documentation of each field for more information.
- `401` — Authorization token is missing, or not valid
- `403` — You are not allowed to access the requested resource
- `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)