Find customer requests by search terms and filters

Get customer request list

Securitybearer
Request
query Parameters
page
number >= 1
Default: 1

Which page of data are you requesting

limit
number [ 1 .. 50 ]
Default: 20

How many items are you requesting

q
string

Filter data by searching for framework names

userIds
Array of numbers

User Ids of customer request owners

Example: userIds=1
isOwned
boolean

Filter owned requests

Example: isOwned=true
framework
required
string

Auditor framework ID

Example: framework=123e4567-e89b-12d3-a456-426614174000
status
string or null

Customer request status

Enum: "OUTSTANDING" "IN_REVIEW" "ACCEPTED"
Example: status=OUTSTANDING
onlyWithNewMessages
boolean

Filter data only if request has new messages

Responses
200
400

Malformed data and/or validation errors

401

Invalid Authorization

402

Response Code 402

You must pay to activate this feature

403

You are not allowed to perform this action

404

Record Not Found

500

Internal server error

default

Response Code: 412

You must accept the Drata terms and conditions to use the API

get/customer-request
Request samples 
Response samples 
application/json
{
  • "totalUnreadMessages": 12,
  • "requests": {
    • "data": [
      • { }
      ],
    • "page": 1,
    • "limit": 10,
    • "total": 100
    }
}