Create Vendor

post

https://sandbox.portal.block.aero/api/v2/approved-organization/vendor

Creates an approved vendor within your organization. A facility can hold one vendor approval at a time, so a second one for the same facility is rejected.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

An object containing information to create the approved vendor.

orgId

string

required

length ≥ 1

Unique identifier of the organization to approve as a vendor. Format: ORG-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Use POST /organization/search to retrieve organizations.

facilityId

string

required

length ≥ 1

Unique identifier of the facility to approve as a vendor. Format: FCT-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Use POST /facility/search to retrieve facilities.

approvalStatus

string | null

enum

Approval status of the vendor. Supported values: Approved, Pending, Probation, RevokedApprovalPeriodExpired, RevokedPoorVendorPerformance, RevokedOtherReason.

Allowed:

validFrom

date-time | null

Date the vendor approval takes effect. Format: YYYY-MM-DD.

validTo

date-time | null

Date the vendor approval expires. Format: YYYY-MM-DD.

auditLastDone

date-time | null

Date the most recent vendor audit was completed. Format: YYYY-MM-DD.

auditNextDue

date-time | null

Date the next vendor audit is due. Format: YYYY-MM-DD.

auditType

string | null

enum

Type of the most recent vendor audit. Supported values: Onsite, Remote.

Allowed:

remarks

string | null

Free-text remarks about the vendor.

reasonRemarks

string | null

Free-text reason recorded against the current approval status.

identifiers

array of objects | null

Identifiers your organization uses to reference this vendor in your own systems.

identifiers

addresses

array of objects | null

Billing and shipping addresses of this vendor.

addresses

contacts

array of objects | null

Billing and shipping contacts of this vendor.

contacts

Headers

content-type

string

enum

Defaults to application/json-patch+json

Generated from available request content types

Allowed:

Response

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK