Developers
Errors and rate limits
Every refusal has a stable code. Build on the code, not on the words.
Developer pages and contents
The shape of a refusal
JSON
{ "error": "A valid key is needed", "code": "api_key" }- code
- One of the codes below.
- error
- The same in English, for your logs.
- vars
- Sometimes: the values in the words, such as
{ "minutes": 12 }fortoo_many_codes.
An answer may carry other fields. Ignore them.
Codes
| Code | Status | English words | Where |
|---|---|---|---|
api_cookies | 400 | Call this API from a server, without cookies | Consent API |
api_key | 401, 403 | A valid key is needed | Consent API |
api_rate | 429 | Too many calls — slow down | Consent API |
api_person | 422 | Give the person's e-mail, mobile or customerId | Consent API |
notice_changed | 409 | The notice has changed — read the new one | Consent API |
page_not_open | 404 | This consent page is not open | Consent API |
invalid_input | 400 | Check what you entered | Consent API |
widget_origin | 403 | This website may not record consent here | Website widget |
too_many_answers | 429 | Too many answers — try again in a minute | Website widget |
unknown_visitor | 422 | Unknown visitor | Website widget |
contact_needed | 422 | Enter your e-mail address | Consent page |
contact_needed_mobile | 422 | Enter your e-mail address or mobile number | Consent page |
email_only | 422 | Use your e-mail address | Consent page |
too_many_codes | 429 | Too many codes — try again in {minutes} min. | Consent page |
code_format | 422 | Enter the six-digit code | Consent page |
code_expired | 422 | The code has run out — ask for a new one | Consent page |
code_wrong | 422 | That code is not right | Consent page |
session_ended | 401 | Your session ended — ask for a new code | Consent page |
request_kind | 422 | Choose what you are asking for | Consent page |
request_detail | 422 | Say what you are asking for | Consent page |
too_many_requests | 429 | You have five requests open — wait for an answer | Consent page |
age_needed | 422 | Say whether you are 18 or older | Children and guardians on the consent page |
guardian_needed | 403 | A parent or guardian gives this consent | Children and guardians on the consent page |
child_barred | 422 | Not given for a child: {purposes} | Children and guardians on the consent page |
guardian_kind | 422 | Choose who is giving consent | Children and guardians on the consent page |
no_parent_consent | 409 | This page does not take a parent's consent | Children and guardians on the consent page |
no_guardian_consent | 409 | This page does not take a guardian's consent | Children and guardians on the consent page |
guardian_own_email | 422 | The parent or guardian verifies their own e-mail | Children and guardians on the consent page |
guardian_adult | 422 | A parent or guardian must be an adult | Children and guardians on the consent page |
guardian_declaration | 422 | The parent or guardian makes the declaration | Children and guardians on the consent page |
guardian_relation | 422 | Say how you are related | Children and guardians on the consent page |
guardian_other | 409 | Another parent or guardian gives this person's consent | Children and guardians on the consent page |
signup_business_name | 400 | Enter the business name | Sign-up |
signup_owner_name | 400 | Enter your name | Sign-up |
signup_email | 400 | Enter a valid e-mail | Sign-up |
signup_mobile | 400 or 422 | Enter a 10-digit mobile number | Sign-up |
signup_terms | 400 | Accept the terms to go on | Sign-up |
signup_too_many | 429 | Too many tries — try again later | Sign-up |
signup_check | 403 | The security check did not finish — try again | Sign-up |
signup_ca_name | 400 | Enter your CA firm's name | Sign-up |
signup_ca_email | 400 | Enter a valid e-mail for your CA firm | Sign-up |
check_answers | 400 or 422 | Answer all 10 questions | Readiness check |
check_city | 400 | Enter your city | Readiness check |
check_consent | 400 | Tick the box to agree | Readiness check |
failed | 403 or 500 | Something went wrong — try again | Any call |
Rate limits
| What | Limit | Code |
|---|---|---|
| Consent API calls | 600 in any one minute per key | api_rate |
| Widget answers | 30 in any one minute per address, per workspace | too_many_answers |
| Consent page codes | 5 an hour per person, 30 an hour per address | too_many_codes |
| Wrong codes | 5 tries per code | code_expired |
| Open requests | 5 per person | too_many_requests |
After a 429, wait and try again. too_many_codes says how many minutes in vars.minutes.