Skip to main content
POST
/
csv-enrichment
Create CSV Enrichment Job
curl --request POST \
  --url https://www.trysignalbase.com/api/v2/csv-enrichment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fileName": "target-accounts.csv",
  "wait": true,
  "timeout": 30,
  "companies": [
    {
      "company_name": "Mollie",
      "website_url": "mollie.com",
      "external_id": "acct_123"
    }
  ]
}
'
{
  "success": true,
  "data": {
    "jobId": "7f4b7a34-8d65-4cc3-8ab0-3477f8a967a6",
    "detectedMapping": {
      "companyName": "company_name",
      "websiteUrl": "website_url",
      "linkedinUrl": "linkedin_url"
    }
  },
  "meta": {
    "endpoint": "csv.enrichment",
    "creditsUsed": 1,
    "creditsRemaining": 999
  }
}

Authorizations

​
Authorization
string
header
required

Signalbase API key. Include as Bearer token in the Authorization header.

Body

application/json
​
companies
object[]
required

Companies to enrich. Maximum 1,000 companies per request.

Required array length: 1 - 1000 elements
​
fileName
string

Optional label stored on the enrichment job. Defaults to api-companies.json.

Maximum string length: 500
Example:

"target-accounts.csv"

​
wait
boolean
default:false

If true, wait up to timeout seconds and return completed results inline when available.

​
timeout
integer
default:30

Maximum wait time in seconds when wait=true.

Required range: 1 <= x <= 30

Response

Enrichment job accepted. If wait=true and processing completed, data also includes status, summary, and results.

​
success
boolean
required
​
data
object
required
​
meta
object
required