---
updatedAt: 2026-07-10T20:07:17.000Z
agentTools:
  projectIndex: https://apidocs.ceretax.net/llms.txt
---

# Update transaction status

Updates the status of a transaction. 

CereTax supports the following transaction statuses:

**Active** - The transaction has been created in CereTax, but the details of the transaction have not been finalized. When the details of the transaction are finalized, the status should be updated to Posted. 

**Posted** - The transaction has been created in CereTax and the details of this transaction have been finalized. 

**Pending**  - This transaction has been created in CereTax, but it contains one or more line item issues that must be resolved before the transaction can be reprocessed and set to Active. 

**Suspended** - The transaction is suspended in CereTax. Transactions that should not be in CereTax or do not match your business application should be set to Suspended. 

**Quote** - The transaction was created in CereTax, but only for the purpose of estimating tax. Quote transactions are temporary and cannot be updated.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "x-stoplight": {
    "id": "dayb3ify8s0x6"
  },
  "info": {
    "title": "Transaction API",
    "description": "CereTax API Documentation for creating and updating telco, sale, and purchase transactions.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://calc.cert.ceretax.net",
      "description": "CERT"
    },
    {
      "description": "Production",
      "url": "https://calc.prod.ceretax.net"
    }
  ],
  "paths": {
    "/status": {
      "post": {
        "summary": "Update transaction status",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/statusUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Status Update Succeeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/statusUpdateResponseSuccess"
                }
              }
            }
          },
          "404": {
            "description": "Status Update Failed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/statusUpdateResponseFail"
                }
              }
            }
          }
        },
        "security": [
          {
            "api_key": []
          }
        ],
        "operationId": "post-status",
        "description": "Updates the status of a transaction. \n\nCereTax supports the following transaction statuses:\n\n**Active** - The transaction has been created in CereTax, but the details of the transaction have not been finalized. When the details of the transaction are finalized, the status should be updated to Posted. \n\n**Posted** - The transaction has been created in CereTax and the details of this transaction have been finalized. \n\n**Pending**  - This transaction has been created in CereTax, but it contains one or more line item issues that must be resolved before the transaction can be reprocessed and set to Active. \n\n**Suspended** - The transaction is suspended in CereTax. Transactions that should not be in CereTax or do not match your business application should be set to Suspended. \n\n**Quote** - The transaction was created in CereTax, but only for the purpose of estimating tax. Quote transactions are temporary and cannot be updated.\n",
        "tags": [
          "Update transactions"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "statusUpdate": {
        "title": "statusUpdateModel",
        "type": "object",
        "properties": {
          "ksuid": {
            "type": "string",
            "description": "The ksuid of the transaction you want to update.",
            "example": "2Cll3MIHrp2pNZ4gIpsgwfSoTNI"
          },
          "systemTraceAuditNumber": {
            "type": "string",
            "description": "The systemTraceAuditNumber of the transaction you want to update. This only needs to be included in the transaction update request if you use the systemTraceAuditNumber when creating transactions.",
            "example": "2Cll3MIHrp2pNZ4gIpsgwfSoTNI"
          },
          "transactionStatus": {
            "type": "string",
            "description": "The status you want to set the transaction to.",
            "example": "Suspended",
            "enum": [
              "Active",
              "Posted",
              "Suspended"
            ]
          }
        },
        "required": [
          "ksuid",
          "transactionStatus"
        ]
      },
      "statusUpdateResponseSuccess": {
        "title": "statusUpdateResponseModel",
        "type": "object",
        "properties": {
          "ksuid": {
            "type": "string",
            "description": "The ksuid of the transaction you updated.",
            "example": "2Cll3MIHrp2pNZ4gIpsgwfSoTNI"
          },
          "message": {
            "type": "string",
            "description": "Response message indicating the status update was successful.",
            "example": "Transaction Updated"
          }
        }
      },
      "statusUpdateResponseFail": {
        "title": "statusUpdateResponseModel",
        "type": "object",
        "properties": {
          "ksuid": {
            "type": "string",
            "description": "The ksuid of the transaction you tried to update",
            "example": "2Cll3MIHrp2pNZ4gIpsgwfSoTNI"
          },
          "message": {
            "type": "string",
            "description": "Response message indicating why the status update failed.",
            "example": "transaction is already set to the requested status"
          }
        }
      }
    },
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```