Skip to content

Get a Trust Center access request

GET
/trust-center/access-requests/{id}
curl --request GET \
--url https://api.vendorica.com/v1/trust-center/access-requests/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

One access request from the calling key’s organization — the read an integration makes before acting on a trustcenter.access_requested webhook, and after a 409 to learn what a request now says. Carries everything the list does, plus requestedResources (the restricted documents the visitor asked for by name, resolved to titles; title: null marks one deleted since — a request, never a grant), decidedByApiClientName (the name of the key that decided, while that key exists) and ndaSignedAt. A request in another organization is a 404, not a 403.

id
required
string format: uuid

Success

Media typeapplication/json
object
success
required
boolean
data
required
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
decidedByApiClientId
required
string | null format: uuid
decidedAt
required
string | null format: date-time
decidedVia
required
string | null
Allowed values: app api access_rule
decisionReference
required
string | null
autoRuleId
required
string | null format: uuid
visitorTokenId
required
string | null format: uuid
requestCountryCode
required
string | null
requestCity
required
string | null
requestedResourceIds
required
Array<string>
createdAt
required
string format: date-time
decidedByApiClientName
required
string | null
ndaSignedAt
required
string | null format: date-time
requestedResources
required
Array<object>
object
id
required
string format: uuid
title
required
string | null
isPublished
required
boolean
isRestricted
required
boolean
timestamp
required
string format: date-time
requestId
string
message
string
Example
{
"success": true,
"data": {
"id": "91d12039-c735-4ce1-8b98-57c652d22666",
"organizationId": "5f553e64-7931-4a92-897f-32432a3c25c5",
"visitorEmail": "string",
"visitorName": "string",
"companyName": "string",
"reason": "string",
"rejectionReason": "string",
"status": "string",
"decidedByUserId": "95671e45-7854-49c5-8347-42b26f2e0482",
"decidedByApiClientId": "b11da301-d4a7-4db9-8ddd-4bceed5e4efe",
"decidedAt": "2026-08-19T09:41:12.004Z",
"decidedVia": "app",
"decisionReference": "string",
"autoRuleId": "18dab1ca-e845-4dd8-80fc-3fc1d218631f",
"visitorTokenId": "6d354ba8-94e6-4c9e-833f-0b273f3e8819",
"requestCountryCode": "string",
"requestCity": "string",
"requestedResourceIds": [
"40a78bbc-85c0-4c1a-87cc-db5b867d568d"
],
"createdAt": "2026-08-19T09:41:12.004Z",
"decidedByApiClientName": "string",
"ndaSignedAt": "2026-08-19T09:41:12.004Z",
"requestedResources": [
{
"id": "8397ee34-5e2b-4f02-8042-6e93bf9417b5",
"title": "string",
"isPublished": true,
"isRestricted": true
}
]
},
"timestamp": "2026-08-19T09:41:12.004Z",
"requestId": "req_01J5X8ZC3K4T7Q9M2W6B0N1V4H",
"message": "string"
}

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"
}

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"
}

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"
}

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"
}

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"
}