bulk

https://www.tincomply.com/api/v1/bulk

This endpoint returns a list of bulk uploads.

Supported parameters: page, count, search, direction

bulk/upload

https://www.tincomply.com/api/v1/bulk/upload

This endpoint uploads a file for bulk processing using multipart/form-data.

Supported parameters: file and requestedServices(optional).

Using requestedServices(optional)

The requestedServices parameter allows you to specify which validations to perform. It accepts a list of the following values:

• irs-tin-name-matching – IRS TIN and name validation.
• company-name-lookup-by-ein – Retrieve a company name using its EIN.
• company-ein-lookup-by-name – Find an EIN using a company name.
• address-validation – Verify and standardize an address.
• fatca-giin – Validate a FATCA GIIN.
• legal-entity-identifier – Validate an LEI.
• list-sanctions – Screen against global sanctions lists.
• company-details-lookup-by-name-address – Retrieve company details using name and address.

Sample Response

{ "id": "cwWX8sZHNEyZZVflHztsbgO4" }

bulk/details

https://www.tincomply.com/api/v1/bulk/details

This endpoint returns the details of a bulk file that was uploaded.

Supported parameters: id

Sample Response

{
  "details": {
    "filename": "my-bulk-file.csv",
    "totalRows": 100000,
    "state": 2,
    "completedOn": "2025-03-28T22:01:49"
  }
}

Possible Values for state

bulk/download

https://www.tincomply.com/api/v1/bulk/download

This endpoint downloads the results of a completed bulk upload.

Supported parameters: id