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.

CodeHTTP statusRetriableMeaning
INVALID_INPUT400noA parameter failed validation. Check param and message for what to fix.
NOT_FOUND404noNothing matches the given identifier or URL.
UNAUTHORIZED401noMissing, invalid, or revoked API key.
PROVISION_REQUIRED401noNo key was sent and none is on file. Call provision first.
INSUFFICIENT_CREDITS402noYour balance can't cover this call's quote. Check get_usage or add credits.
QUOTE_EXCEEDS_MAX_CREDITS402noThe call's quote is higher than the max_credits you set. Nothing was charged.
IDEMPOTENCY_KEY_REQUIRED400noThis is a metered call; send an Idempotency-Key header.
IDEMPOTENCY_KEY_REUSED409noThat Idempotency-Key was already used with different arguments. Use a new key for a new call.
CONCURRENCY_LIMIT429yesToo many calls in flight for this key's plan. Wait for one to finish.
RATE_LIMITED429yesToo many calls per minute for this key's plan. Back off and retry.
TRIAL_CAP_EXCEEDED403noA trial-only limit was hit (concurrency, rate, search size, or realtime fetches).
BUDGET_EXHAUSTED503noA configured spend budget has been used up.
UPSTREAM_UNAVAILABLE502yesLinkedIn data wasn't reachable. Safe to retry.
PAYLOAD_TOO_LARGE413noThe request or response exceeded the size limit.
ORIGIN_FORBIDDEN403noThis request's origin isn't allowed to call the API.
INTERNAL500yesSomething failed on our side. Safe to retry.