---
title: "List e-invoice business lifecycle status updates"
method: GET
path: "/v1/e-compliance/lifecycle/status-updates"
tags: ["E-Reporting"]
---

# List e-invoice business lifecycle status updates

`GET /v1/e-compliance/lifecycle/status-updates`

Lists e-invoice business lifecycle status update audit records, optionally filtered by document, status, and requested action.

## Query parameters

- `documentId` string
- `status` string
- `userRequestedAction` string
- `page` integer
- `pageSize` integer

## 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

- GetEInvoiceLifecycleStatusUpdatesResponse
  - `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
  - `page` integer — Current page number (1-based).
  - `pageSize` integer — Number of results per page.
  - `total` integer — Total number of matching records across all pages.

## Other responses

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

---

[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)