Authentication

All API requests (except GET /v1/health) require a bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Getting an API key

1. Go to app.vendorval.com and sign in.
2. Navigate to API Keys in the sidebar.
3. Click Create API key, enter a name, and click Create.
4. Copy the key immediately — it's only shown once.

Key format

Live keys are prefixed vv_live_. Test keys are prefixed vv_test_ and only work against sandbox data.

Example request

curl https://api.vendorval.com/v1/entities/lookup \
  -X POST \
  -H "Authorization: Bearer vv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"identifiers": [{"type": "uei", "value": "ABCD12345678"}]}'

Errors

Status	Meaning
401	Missing or invalid API key
403	Key exists but lacks permission for this resource
429	Rate limit exceeded — back off and retry

Rate limits

Rate limits are enforced per API key. Your plan's limit is shown in the Dashboard.

Plan	Limit
Starter	100 req/min
Growth	500 req/min
Enterprise	Custom