trial_allowance_exhausted error

trial_allowance_exhausted is returned with HTTP 402. Retryable: no. Sending the same request again returns the same error. Nothing is charged for this error.

What it means

The trial allowance is used up.

Most likely cause

The account is in its trial and has used all the credits the trial allows. Lookups are paused. Nothing is charged, and nothing starts the plan for you.

How to fix it

Nothing was charged. Start your plan from the billing page ("Start my plan now") to keep going; the plan is only charged when you do.

Example

The billing page calls this when you choose "Start my plan now". It ends the trial and charges the first month at once. With no running trial it returns HTTP 409.

curl -i -X POST https://YOUR_API_HOST/v1/me/billing/start-plan -H "Authorization: Bearer $FIREBASE_ID_TOKEN"

An error response is one JSON envelope. Branch on code, never on the message text. The message and fix of a real response can be more specific than the defaults shown here.

1{
2  "error": {
3    "code": "trial_allowance_exhausted",
4    "message": "The trial allowance is used up.",
5    "fix": "Nothing was charged. Start your plan from the billing page (\"Start my plan now\") to keep going; the plan is only charged when you do.",
6    "docs_url": "https://lookvalid.com/docs/errors/trial_allowance_exhausted",
7    "retryable": false,
8    "request_id": "req_3fK9pQ2xVb7LmN4sTz8WcA"
9  }
10}

See also

• All error codes with the response envelope.
• Credits and billing (the trial).
• Quote the request_id when you write to hello@lookvalid.com.