Skip to content
Vendorica Developer Docs

List contracts

GET
/contracts
curl --request GET \
  --url https://api.vendorica.com/v1/contracts \
  --header 'Authorization: Bearer <token>'

Authorizations

Section titled “Authorizations”

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
vendorId
required
string format: uuid
title
required
string
contractType
required
string | null
contractTypeId
required
string | null format: uuid
startDate
required
string | null
endDate
required
string | null
value
required
string | null
currency
required
string | null
status
required
string | null
contractStatusId
required
string | null format: uuid
riskNotes
required
string | null
arrangementReference
required
string | null
isIntragroup
required
boolean
clientNoticePeriodDays
required
integer | null
vendorNoticePeriodDays
required
integer | null
terminationDate
required
string | null
signingDate
required
string | null
governingLaw
required
string | null
storesData
required
boolean | null
dataSensitivity
required
string | null
Allowed values: low medium high very_high
relianceLevel
required
string | null
Allowed values: none low medium high critical
dataLocationAtRest
required
Array<string> | null
dataProcessingLocation
required
Array<string> | null
outsourcingClassification
required
string | null
Allowed values: outsourcing non_outsourcing
outsourcingClassificationRationale
required
string | null
involvesPersonalData
required
boolean | null
nextRenewalDate
required
string | null
cloudServiceModel
required
string | null
Allowed values: iaas paas saas other
cloudDeploymentModel
required
string | null
Allowed values: public private hybrid community
lastAuditDate
required
string | null
nextAuditDate
required
string | null
alternativeProvidersIdentified
required
boolean | null
alternativeProvidersNotes
required
string | null
ebaArrangementType
required
string | null
Allowed values: eba_CO:x1 eba_CO:x2 eba_CO:x3
businessOwnerId
required
string | null format: uuid
approvalStatus
required
string
approvalInstanceId
required
string | null format: uuid
businessUnitIds
required
Array<string>
createdAt
required
string | null format: date-time
updatedAt
required
string | null format: date-time
statusPhase
required
string | null
Allowed values: draft pending in_force ended archived
vendor
required
object
id
required
string format: uuid
name
required
string
businessOwner
required
object
id
required
string format: uuid
firstName
required
string | null
lastName
required
string | null
email
required
string
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": "52323f18-7f19-45ee-81e2-44170a3129e9",
      "vendorId": "1348a75a-b35f-4f88-8a3c-97d19263044f",
      "title": "string",
      "contractType": "string",
      "contractTypeId": "7c98560e-2fcf-44e4-8a95-07a5a99b0273",
      "startDate": "string",
      "endDate": "string",
      "value": "string",
      "currency": "string",
      "status": "string",
      "contractStatusId": "732311ac-ee34-44ea-862b-2acb24f463dd",
      "riskNotes": "string",
      "arrangementReference": "string",
      "isIntragroup": true,
      "clientNoticePeriodDays": 1,
      "vendorNoticePeriodDays": 1,
      "terminationDate": "string",
      "signingDate": "string",
      "governingLaw": "string",
      "storesData": true,
      "dataSensitivity": "low",
      "relianceLevel": "none",
      "dataLocationAtRest": [
        "string"
      ],
      "dataProcessingLocation": [
        "string"
      ],
      "outsourcingClassification": "outsourcing",
      "outsourcingClassificationRationale": "string",
      "involvesPersonalData": true,
      "nextRenewalDate": "string",
      "cloudServiceModel": "iaas",
      "cloudDeploymentModel": "public",
      "lastAuditDate": "string",
      "nextAuditDate": "string",
      "alternativeProvidersIdentified": true,
      "alternativeProvidersNotes": "string",
      "ebaArrangementType": "eba_CO:x1",
      "businessOwnerId": "e6d96007-6d32-47df-81f4-bf54a4492af0",
      "approvalStatus": "string",
      "approvalInstanceId": "37eed670-7efb-4576-8b0c-472f7f5408b1",
      "businessUnitIds": [
        "fed72751-7fb2-47a9-80a2-b09eaa1c026e"
      ],
      "createdAt": "2026-08-19T09:41:12.004Z",
      "updatedAt": "2026-08-19T09:41:12.004Z",
      "statusPhase": "draft",
      "vendor": {
        "id": "e302ada8-0737-429e-8930-3d2769f03e19",
        "name": "string"
      },
      "businessOwner": {
        "id": "b60c8823-b6ba-4bf3-8745-8ad0f6798bbc",
        "firstName": "string",
        "lastName": "string",
        "email": "string"
      }
    }
  ],
  "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"
}