provision 0 credits
Create a free trial account and get an API key, no signup and no card. Call this first if you have no key: you get 500 free credits. Over MCP, later calls in this same session authenticate automatically; over REST, send the key as 'Authorization: Bearer <key>' on every call. The response includes the api_key (shown exactly once, so store it) and a claim_url to keep the account permanently. Costs 0 credits. Trial limits: 1 concurrent call, 20 calls/minute, search capped at 10 results per call, 5 realtime fetches total. Not for checking your balance: that is get_usage.
Parameters
No parameters.
REST
POST /v1/provision · auth: none · metered: false
curl -X POST "https://api.veezee.io/v1/provision"
MCP
{
"method": "tools/call",
"params": {
"name": "provision",
"arguments": {}
}
}
Input examples
First contact, no key yet
{}
Output
Returns a provision envelope. Full field list: /docs/fields#provision.
Errors
REST returns application/problem+json; MCP returns the same content as an error result. message is written as the next-turn instruction.
| Code | HTTP status | Retriable | Meaning |
|---|---|---|---|
INVALID_INPUT | 400 | no | A parameter failed validation. Check param and message for what to fix. |
NOT_FOUND | 404 | no | Nothing matches the given identifier or URL. |
UNAUTHORIZED | 401 | no | Missing, invalid, or revoked API key. |
PROVISION_REQUIRED | 401 | no | No key was sent and none is on file. Call provision first. |
INSUFFICIENT_CREDITS | 402 | no | Your balance can't cover this call's quote. Check get_usage or add credits. |
QUOTE_EXCEEDS_MAX_CREDITS | 402 | no | The call's quote is higher than the max_credits you set. Nothing was charged. |
IDEMPOTENCY_KEY_REQUIRED | 400 | no | This is a metered call; send an Idempotency-Key header. |
IDEMPOTENCY_KEY_REUSED | 409 | no | That Idempotency-Key was already used with different arguments. Use a new key for a new call. |
CONCURRENCY_LIMIT | 429 | yes | Too many calls in flight for this key's plan. Wait for one to finish. |
RATE_LIMITED | 429 | yes | Too many calls per minute for this key's plan. Back off and retry. |
TRIAL_CAP_EXCEEDED | 403 | no | A trial-only limit was hit (concurrency, rate, search size, or realtime fetches). |
BUDGET_EXHAUSTED | 503 | no | A configured spend budget has been used up. |
UPSTREAM_UNAVAILABLE | 502 | yes | LinkedIn data wasn't reachable. Safe to retry. |
PAYLOAD_TOO_LARGE | 413 | no | The request or response exceeded the size limit. |
ORIGIN_FORBIDDEN | 403 | no | This request's origin isn't allowed to call the API. |
INTERNAL | 500 | yes | Something failed on our side. Safe to retry. |