APIPay Out endpointsVendor

Get vendor

View as MarkdownOpen in Claude
Retrieves a vendor's details, including enrichment status and payment acceptance info when available.

Authentication

requestTokenstring
API Key authentication via header

Path parameters

idVendorintegerRequired
Vendor ID.

Response

Success
additionalDatamap from strings to optional maps from strings to any

Custom dictionary of key:value pairs. You can use this field to store any data related to the object or for your system. If you are using custom identifiers, pass those in this object. Max length for a value is 100 characters. Example usage:

1{
2  "additionalData": {
3    "key1": "value1",
4    "key2": "value2",
5    "key3": "value3"
6  }
7}
Address1string
The address.
Address2string
Additional line for the address.
BillingDataobject
Citystring
The city.
Contactsobject
Countrystring
CreatedDatedatetime
Timestamp of when record was created, in UTC.
customerVendorAccountstring
customField1string
customField2string
EINstring

Business EIN or tax ID. This value is masked in API responses, for example XXXX6789.

Emailstringformat: "email"<=320 characters
Email address.
EnrollmentStatusstring
Enrollment status of vendor in payables program.
externalPaypointIDstring

A custom identifier for the paypoint, if applicable. Like entrypoint is the Payabli identifier for the merchant, externalPaypointId is a custom field you can use to include the merchant’s ID from your own systems.

InternalReferenceIdlong
Internal identifier for global vendor account.
LastUpdateddatetime
Timestamp of when record was last updated, in UTC.
LocationCodestring
Mccstring

Business Merchant Category Code (MCC). This resource lists MCC codes.

Name1string
Name2string
ParentOrgNamestring
The name of the parent organization.
ParentOrgIdlong
The ID of the org's parent organization.
payeeName1string
Alternative name used to receive paper check.
payeeName2string
Alternative name used to receive paper check.
PaymentMethodstring

The vendor’s preferred payment method. Can be one of:

  • "managed" - Managed payment method
  • "vcard" - Virtual card payment method
  • "check" - Check payment method
  • "ach" - ACH payment method
PaypointDbanamestring
The alternate or common name that this business is doing business under usually referred to as a DBA name.
PaypointEntrynamestring<=50 characters
The entrypoint identifier.
PaypointLegalnamestring
Business legal name.
Phonestring
remitAddress1string

Remittance street address. Used for mailing paper checks. Required if any remittance address field is provided. Allowed characters are letters, numbers, spaces, and `. ,

remitAddress2string
Remittance address additional line, such as a suite or unit number. Used for mailing paper checks. Always optional.
remitCitystring
Remittance address city. Used for mailing paper checks. Required if any remittance address field is provided.
remitCountrystring

Remittance address country. Used for mailing paper checks. Must be US or CA. Defaults to US if not provided.

RemitEmailstringformat: "email"
Remittance email address. Used for sending virtual cards and other information about payouts.
remitStatestring
Remittance address state or province. Used for mailing paper checks. Required if any remittance address field is provided. Must be a valid US state or Canadian province abbreviation.
remitZipstring

Remittance address ZIP or postal code. Used for mailing paper checks. Required if any remittance address field is provided. For US addresses, use five digits or ZIP+4 format.

Statestring
The state or province.
StoredMethodslist of objects
Summaryobject
VendorIdinteger
Payabli identifier for vendor record.
VendorNumberstring
Custom number identifying the vendor. Must be unique in paypoint. Can't be blank.
VendorStatusinteger

Vendor’s status. Allowed values:

  • 0 Inactive

  • 1 Active

  • -99 Deleted

Zipstring
ZIP code for address.
PaymentPortalUrlstring
URL for the vendor's online payment portal, if known. Populated by the vendor enrichment pipeline.
CardAcceptedstring

Whether the vendor accepts card payments. Values are yes, no, or unable to determine. Populated by the vendor enrichment pipeline.

AchAcceptedstring

Whether the vendor accepts ACH payments. Values are yes, no, or unable to determine. Populated by the vendor enrichment pipeline.

EnrichmentStatusstring

Current enrichment state of the vendor. Values are not_enriched, partially_enriched, fully_enriched, or fallback_applied.

EnrichedBystring

Which enrichment method resolved the vendor’s payment acceptance info. Values are invoice_scan, web_search, vendor_network, or manual.

EnrichedAtdatetime

When the vendor was last enriched (UTC).

EnrichmentIdstring
Identifier for the enrichment request that last updated this vendor.