Bulk Seller Detailed

get

Generate a presigned S3 URL for uploading JSON files containing multiple seller-detailed search requests. Returns an upload_link and operation_id for tracking file processing status.

File Format Requirements

Uploaded files must be in JSON format and contain an array of objects. Each object represents a seller-detailed search request.

JSON Structure:

[
    {
        "name": "Acme Corporation",
        "legal_entity_name": "Acme Corporation Inc.",
        "address_line_1": "123 Main Street",
        "city": "New York",
        "state": "NY",
        "zip5": "10001",
        "ein": "12-3456789",
        "email": "[email protected]",
        "phone": "555-123-4567",
        "detailed_info": true
    },
    {
        "name": "Another Business",
        "address_line_1": "456 Oak Avenue",
        "city": "Los Angeles",
        "state": "CA",
        "zip5": "90210"
    }
]

Required fields (at least one per object):

  • name OR legal_entity_name (at least one must be provided)

  • address_line_1

  • city

  • state

  • zip5

Optional fields:

  • ein

  • email

  • phone

  • alt_phone

  • domain_name

  • detailed_info (boolean)

Response

Returns an operation_id that can be used to check processing status and retrieve results. Results will be available as a downloadable JSONL file once processing is complete.

Authorizations
AuthorizationstringRequired
Header parameters
LenderIdstringRequired

Lender ID provided by Verdata

Responses
get
/bulk-seller-detailed
GET /external/api/v1/bulk-seller-detailed HTTP/1.1
Host: api.myverdata.com
Authorization: YOUR_API_KEY
LenderId: text
Accept: */*
200

Bulk Seller Detailed Upload Response

No content

get

Check the status of a bulk seller-detailed operation by operation_id. Returns the current status, processing progress, and download URL when complete.

Authorizations
AuthorizationstringRequired
Path parameters
operation_idanyRequired
Header parameters
LenderIdstringRequired

Lender ID provided by Verdata

Responses
get
/bulk-seller-detailed/{operation_id}
GET /external/api/v1/bulk-seller-detailed/{operation_id} HTTP/1.1
Host: api.myverdata.com
Authorization: YOUR_API_KEY
LenderId: text
Accept: */*
200

Bulk Seller Detailed Status Response

No content

Last updated