Create a new information request

post

https://api.vanta.com/v1/audits/{auditId}/information-requests

Creates a new information request for an audit during audit setup or as requirements evolve.

After creating all information requests, use POST /audits/{auditId}/share-information-request-list to make them visible to the customer organization. Until shared, requests remain in draft state visible only to auditors.

New requests are created in an initial state indicating evidence is needed. The status progresses through the workflow: initial state → awaiting review → approved or flagged.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

auditId

string

required

Body Params

uniqueId

string

required

External unique ID to prevent duplicate requests across audit systems. Must be unique within the audit. Used for idempotency.

title

string

required

Short, descriptive title summarizing what is being requested. Must be at least 1 character.

requestType

string

enum

required

Scope of evidence required.

Allowed:

description

string | null

Detailed description explaining what evidence is needed. Helps the customer understand what to submit. Optional.

frameworkCodes

array of strings

required

Framework codes this request addresses. An empty array if no framework codes are associated.

frameworkCodes*

cadence

string | null

enum

Frequency cadence for the information request, indicating how often it recurs.

Allowed:

dueDate

date-time | null

Deadline for fulfilling this request. Null or omitted if no deadline. Format: ISO 8601 UTC timestamp.

evidenceCaptureDate

date-time | null

Start date of the audit period. Evidence before this date may not be accepted. Null or omitted if not restricted. Format: ISO 8601 UTC timestamp.

Response

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Information request created