Get a vendor's current standing

GET

/vendors/{vendorId}/standing

curl --request GET \
  --url https://theoria.hypertheory-labs.com/clerk-records/purchasing/vendors/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/standing

• Classroom cluster. Village services are routed as /{department}/{system}. Confirm the environment is up in Contractor Resources before relying on it.
• Local development.

Reports the vendor’s standing as of now, with the date it took effect and the authority it derives from.

This endpoint reports standing. It does not decide whether a given purchase or dispatch may proceed — that determination belongs to the department committing the funds, which is the only party that knows what it is about to commit them to.

Parameters

Path Parameters

vendorId

required

string format: uuid

Responses

200

The vendor’s current standing.

Media type application/json

object

vendorId

required

string format: uuid

status

required

• approved — may be used for new purchases.
• suspended — may not be used for new purchases. Work already dispatched is not affected by the suspension itself.
• debarred — may not be used. Statutory, and not waivable by the village.

string

Allowed values: approved suspended debarred

effectiveDate

required

The date this standing took effect. May be earlier than the date it was recorded here.

string format: date

expiresOn

Null where the standing does not lapse on its own.

string | null format: date

authority

required

Where the standing came from. state-debarment-list entries originate outside the village and are not revisable here.

string

Allowed values: clerk-review village-ordinance state-debarment-list

reason

required

Narrative reason for the current standing, as recorded by the Clerk’s office.

string

reviewedOn

required

string format: date

Example

{
  "status": "approved",
  "authority": "clerk-review"
}

404

No such vendor, or the vendor is registered but no standing has been established.

Media type application/problem+json

RFC 9457 problem details.

object

type

string format: uri

title

string

status

integer

detail

string

instance

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}