List material vendor accounts
List up to 50 active accounts attached to one represented-Company material vendor.
GET/v1/vendors/{vendor_skey}/accounts
Request schema: None
Success schema: VendorAccountCollectionResponseV1
Documented HTTP statuses: 200, 400, 401, 403, 404, 409, 429, 503
Contract: vendor-directory-v1.openapi.json
Authorization
Current Enterprise authority, direct-Company caller context, and represented-Company vendor membership are required. Unknown and other-Company vendors are concealed identically.
Request guidance
Send the opaque vendor_skey returned by GET /v1/vendors in the path. Do not send org_id, a status selector, a page size, or a cursor.
Parameters
| Name | In | Type | Presence | Constraints | Description |
|---|---|---|---|---|---|
vendor_skey | path | string | Required | minLength 1; maxLength 255 | The stable opaque vendor identity returned by GET /v1/vendors. |
Request body
This operation has no JSON request body.
Idempotency and recovery
No idempotency key is used because this operation is read-only.
Response guidance
Only active accounts are returned; a vendor with no active accounts returns an empty accounts array. account_number is an authorized nullable field. The collection is limited to 50 accounts with no paging and fails instead of being truncated.
Synthetic success example: Active vendor accounts
{
"contract_version": "v1",
"evaluated_at": "2026-11-04T14:00:00Z",
"vendor_skey": "vendor-syn-001",
"accounts": [
{
"vendor_account_skey": "vendor-account-syn-001",
"account_number": "123456",
"name": "Main Purchasing Account"
}
],
"account_count": 1
}