> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vanta.com/llms.txt
> Use this file to discover all available pages before exploring further.

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



## OpenAPI

````yaml /reference/webhooks.json post /v1.information-request.status-changed
openapi: 3.0.3
info:
  title: Vanta Webhook Events
  version: 1.0.0
  description: >-
    Reference for the events Vanta delivers to your registered webhook
    endpoints. Each operation documents a single event type, its payload schema,
    and an example body.


    These operations describe **events Vanta sends to you** — they are not
    endpoints you call. The documented schema is the event `payload`. Every
    delivery also includes signature headers and is wrapped in a delivery
    envelope. See the [Webhooks guide](/docs/webhooks) for setup, signature
    verification, and retries.
servers:
  - url: https://your-endpoint.example.com
    description: >-
      Your webhook endpoint. Vanta sends a POST request with the event payload
      as the body.
security: []
tags:
  - name: Questionnaire
    description: Questionnaire automation events.
  - name: Trust Center
    description: Trust Center access request events.
  - name: Vendor
    description: Vendor risk management events.
  - name: Information Request
    description: Audit information request (IRL) events.
  - name: Evidence
    description: Audit evidence events.
  - name: Control
    description: Audit control comment events.
paths:
  /v1.information-request.status-changed:
    post:
      tags:
        - Information Request
      summary: Information request status changed
      description: >-
        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.
      operationId: v1.information-request.status-changed
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - informationRequest
              properties:
                informationRequest:
                  type: object
                  required:
                    - id
                    - auditId
                    - oldStatus
                    - newStatus
                  properties:
                    id:
                      type: string
                      description: The unique identifier of the information request.
                    auditId:
                      type: string
                      description: >-
                        The unique identifier of the audit the information
                        request belongs to.
                    oldStatus:
                      type: string
                      description: >-
                        The status the information request was in before the
                        change.
                      enum:
                        - NEEDS_EVIDENCE
                        - READY_FOR_AUDIT
                        - AUDITOR_APPROVED
                        - AUDITOR_FLAGGED
                    newStatus:
                      type: string
                      description: >-
                        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.
                      enum:
                        - NEEDS_EVIDENCE
                        - READY_FOR_AUDIT
                        - AUDITOR_APPROVED
                        - AUDITOR_FLAGGED
            example:
              informationRequest:
                id: 507f1f77bcf86cd799439011
                auditId: 5f8d0f3b9d3f2a1b4c5d6e7f
                oldStatus: NEEDS_EVIDENCE
                newStatus: READY_FOR_AUDIT
      responses:
        '200':
          description: Return any 2xx status within 15 seconds to acknowledge receipt.

````