---
title: "Retrieve an e-invoice business lifecycle status update by key"
method: GET
path: "/v1/e-compliance/lifecycle/status-updates/{key}"
tags: ["E-Reporting"]
---

# Retrieve an e-invoice business lifecycle status update by key

`GET /v1/e-compliance/lifecycle/status-updates/{key}`

Retrieves a single e-invoice business lifecycle status update audit record by its unique identifier.

## Path parameters

- `key` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Authorization` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Version` string
- `Zuora-Org-Ids` string

## Response `200`

OK

- GetEInvoiceLifecycleStatusUpdateResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.
  - `statusUpdates` EInvoiceLifecycleStatusUpdateRecord[] — List of e-invoice business lifecycle status updates matching the query criteria.
    - `id` string — Unique identifier of the status update record.
    - `sourceObjectId` string — Internal UUID of the source object (invoice, credit memo, debit memo, payment, or refund).
    - `sourceObjectNumber` string — Human-readable document number of the source object.
    - `sourceObjectType` 'INVOICE' | 'CREDIT_MEMO' | 'DEBIT_MEMO' | 'PAYMENT' | 'REFUND' | 'CREDIT_MEMO_APPLICATION' — Type of the source object.
    - `paymentId` string — ID of the parent payment (populated when sourceObjectType is PAYMENT).
    - `paymentNumber` string — Number of the parent payment (populated when sourceObjectType is PAYMENT).
    - `refundId` string — ID of the parent refund (populated when sourceObjectType is REFUND).
    - `refundNumber` string — Number of the parent refund (populated when sourceObjectType is REFUND).
    - `parentObjectId` string — Internal UUID of the parent object, when this record is anchored on a related object.
    - `parentObjectNumber` string — Human-readable number of the parent object.
    - `parentObjectType` string — Type of the parent object.
    - `serviceProviderId` string — Identifier of the e-invoicing service provider.
    - `serviceProviderType` string — Type of the e-invoicing service provider.
    - `sequenceId` string — Sequence identifier used to order related status update records.
    - `userRequestedAction` string — Action that triggered this status update record.
    - `userRequestStatus` string — Business status requested by the seller, when applicable.
    - `status` 'Scheduled' | 'Submitted' | 'UnderReconciliation' | 'Completed' | 'Failed' | 'Rejected' | 'RetrieveTimeout' | 'ChangeDetected' — Request lifecycle status of this status update record.
    - `reason` string — Reason associated with the current status.
    - `triggeredBy` string — Event or mechanism that triggered this status update record.
    - `einvoiceBusinessStatus` string — Business lifecycle status of the e-invoice as reported by the service provider.
    - `einvoiceBusinessStatusCode` string — Provider-specific code for the e-invoice business status.
    - `einvoiceBusinessStatusReason` string — Provider-specific reason for the e-invoice business status.
    - `businessReasonCode` string — Business reason code associated with this status update.
    - `transactionId` string — External transaction identifier returned by the service provider.
    - `taskExecutionId` string — ID of the async task execution processing this status update.
    - `snapshotFileId` string — ID of the snapshot file associated with this status update.
    - `errorCode` string — Error code if the status update failed.
    - `errorMessage` string — Error message if the status update failed.
    - `createdDate` string, date-time — Timestamp when the status update record was created.
    - `updatedDate` string, date-time

## Other responses

- `500` — Internal Server Error
- `4XX` — Invalid input

## Changes

- **2026-08-15** `702f3caf3985` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zuora/apis/api-reference/changes/v1/e-compliance/lifecycle/status-updates/:key/get.md)

---

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