Add new company account audit(s) to your supplier list

post

https://app-sandbox.trustpair.com/api/v1/company_account_audits/

This endpoint allows you to add one or more new company account audits to your supplier list.

Supports batch processing with multiple audits in a single request. Returns both successful entries and errors.

Supported entity types:

Legal persons (companies with tax registration numbers, DUNS, etc.)
Natural persons (individuals with personal identification)

Supported identifiers and account types:

Company registration/tax numbers
DUNS numbers
IBANs and other bank account formats

Required permissions:

company_account_audits_write

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

The company account audit payload(s)

supplier_id

string

Your own unique supplier ID

company_name

string | null

Required - if company country code is US

company_raw_address

string | null

company_country_code

string

required

company_registration

string | null

tax_number

string | null

duns

string | null

company_registrations

array of objects | null

Typed company registrations array. Use this instead of the flat keys (company_registration, tax_number, duns) to provide one or more typed registration identifiers per company. When provided, each entry overrides the matching flat key (company/registration/vat → tax_number, company/registration/duns → duns, any other type → company_registration).

Recommended type per country / region:

Country / Region	Recommended type	Notes
🇫🇷 France	`company/registration/siren`	SIRET also accepted (first 9 digits = SIREN)
🇨🇭 Switzerland	`company/registration/ide`	Format: CHE + 9 digits
🇩🇪 🇬🇧 🇮🇹 🇪🇸 🇧🇪 + rest of Europe	`company/registration/vat`	Include country prefix (e.g. DE, GB, IT)
🇪🇸 Spain	`company/registration/cif`	Alternative to VAT for Spanish companies
🇨🇳 China	`company/registration/uscc`	18-character code from business licence
🇧🇷 🇲🇽 🇺🇸 🇨🇦 + rest of world	`company/registration/duns`	9-digit DUNS from dnb.com
Any country (fallback)	`company/registration/other_national`	Use when no specific type applies

company_registrations

iban

string | null

Required - if the bank account is an IBAN. Will be preferred over bank_account_number if both are provided.

bank_account_country_code

string | null

bank_account_number

string | null

Required - if the bank account is not an IBAN. Will be ignored over iban if both are provided.

bank_account_bic

string | null

Required - if the bank account is not an IBAN and routing_number is missing. Will be preferred over routing_number if both are provided.

control_key

string | null

routing_number

string | null

Required - if the bank account is not an IBAN and bank_account_bic is missing. Will be ignored over bank_account_bic if both are provided.

contact_first_name

string | null

First name of the company contact person

contact_last_name

string | null

Last name of the company contact person

contact_department

string | null

enum

Department of the company contact person

Allowed:

contact_email

string | null

Email address of the company contact person

Headers

Accept-Language

string

enum

Specifies the preferred language for the response. Supported languages:

en - English
fr - French

If not provided, the default language will be used.

Allowed:

User-Agent

string

Connector name and version used to call API

Responses

200Successful response code

401Unauthorized response code

403Forbidden response code

422Unprocessable content response code