Skip to content
Vendorica Developer Docs

List Trust Center access requests

GET
/trust-center/access-requests
curl --request GET \
  --url 'https://api.vendorica.com/v1/trust-center/access-requests?page=1&limit=100&status=pending' \
  --header 'Authorization: Bearer <token>'

Requests for gated Trust Center documents, newest first, offset-paginated. Filter by status (pending | approved | rejected | auto_approved) — auto_approved is a standing rule deciding on the organization’s behalf, and is a different fact from a person approving, which is why it is its own value rather than an approved row with a flag. Every identifying field on a request is SELF-ASSERTED by an anonymous submitter: the name, the address and the employer are all typed in by whoever filled the form, and only the observed country/city are not. Treat the row as a claim, which is what the reviewer in the app is doing.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
page
integer
default: 1 >= 1 <= 10000
limit
integer
default: 100 >= 1 <= 500
status
string
Allowed values: pending approved rejected auto_approved

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
success
required
boolean
data
required
Array<object>
object
id
required
string format: uuid
organizationId
required
string format: uuid
visitorEmail
required
string
visitorName
required
string | null
companyName
required
string | null
reason
required
string | null
rejectionReason
required
string | null
status
required
string
decidedByUserId
required
string | null format: uuid
decidedAt
required
string | null format: date-time
autoRuleId
required
string | null format: uuid
visitorTokenId
required
string | null format: uuid
requestCountryCode
required
string | null
requestCity
required
string | null
createdAt
required
string format: date-time
key
additional properties
timestamp
required
string format: date-time
requestId
string
message
string
pagination
object
page
required
integer
limit
required
integer
total
required
integer
totalPages
required
integer
Example
{
  "success": true,
  "data": [
    {
      "id": "10aac583-bdd4-4a13-862c-77308bffa6dc",
      "organizationId": "7a89f8a2-8732-43e0-8753-3e59f50b2c67",
      "visitorEmail": "string",
      "visitorName": "string",
      "companyName": "string",
      "reason": "string",
      "rejectionReason": "string",
      "status": "string",
      "decidedByUserId": "26aceadb-bb35-439b-8d89-b8485bcd1fa4",
      "decidedAt": "2026-08-19T09:41:12.004Z",
      "autoRuleId": "af7df374-b946-42c2-8a9b-15d3a9236175",
      "visitorTokenId": "469e236e-96f1-4304-8596-0405ac284d93",
      "requestCountryCode": "string",
      "requestCity": "string",
      "createdAt": "2026-08-19T09:41:12.004Z"
    }
  ],
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H",
  "message": "string",
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1
  }
}

400

Section titled “400”

Validation error

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
  "success": false,
  "error": "Bad request",
  "code": "BAD_REQUEST",
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
  "success": false,
  "error": "Unauthorized",
  "code": "UNAUTHORIZED",
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

403

Section titled “403”

Forbidden — missing scope

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
  "success": false,
  "error": "Forbidden",
  "code": "FORBIDDEN",
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

404

Section titled “404”

Not found

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
  "success": false,
  "error": "Resource not found",
  "code": "NOT_FOUND",
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
code
required
string
details
timestamp
required
string format: date-time
requestId
string
Example
{
  "success": false,
  "error": "Too many requests",
  "code": "TOO_MANY_REQUESTS",
  "timestamp": "2026-08-19T09:41:12.004Z",
  "requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H"
}