---
title: "Information request status changed"
method: POST
path: "/v1.information-request.status-changed"
tags: ["Information Request"]
---

# Information request status changed

`POST /v1.information-request.status-changed`

Fires when an information request's approval status changes. This is a status-change event.

**Ready-to-review signal:** a `newStatus` of `READY_FOR_AUDIT` means the customer has submitted the information request and it is ready for the auditor to review.

**When it fires:** once per information request, each time its status changes between the values below. Not every status transition emits an event.

**Status values:**
- `NEEDS_EVIDENCE` — the request still needs work from the customer; it is not yet ready for the auditor.
- `READY_FOR_AUDIT` — the customer has submitted the request and it is ready for the auditor to review.
- `AUDITOR_APPROVED` — the auditor reviewed the request and approved it.
- `AUDITOR_FLAGGED` — the auditor flagged the request for the customer to address.

A typical lifecycle is `NEEDS_EVIDENCE → READY_FOR_AUDIT → AUDITOR_APPROVED` (or `→ AUDITOR_FLAGGED`). A request can also move from `READY_FOR_AUDIT` back to `NEEDS_EVIDENCE` when the customer takes it back to continue working on it.

## Request body

- object
  - `informationRequest` object, required
    - `id` string, required — The unique identifier of the information request.
    - `auditId` string, required — The unique identifier of the audit the information request belongs to.
    - `oldStatus` 'NEEDS_EVIDENCE' | 'READY_FOR_AUDIT' | 'AUDITOR_APPROVED' | 'AUDITOR_FLAGGED', required — The status the information request was in before the change.
    - `newStatus` 'NEEDS_EVIDENCE' | 'READY_FOR_AUDIT' | 'AUDITOR_APPROVED' | 'AUDITOR_FLAGGED', required — The status the information request is in after the change. A value of `READY_FOR_AUDIT` means the customer has submitted the request and it is ready for the auditor to review.

## Response `200`

Return any 2xx status within 15 seconds to acknowledge receipt.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)