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 } for too_many_codes.

An answer may carry other fields. Ignore them.

Codes

CodeStatusEnglish wordsWhere
api_cookies400Call this API from a server, without cookiesConsent API
api_key401, 403A valid key is neededConsent API
api_rate429Too many calls — slow downConsent API
api_person422Give the person's e-mail, mobile or customerIdConsent API
notice_changed409The notice has changed — read the new oneConsent API
page_not_open404This consent page is not openConsent API
invalid_input400Check what you enteredConsent API
widget_origin403This website may not record consent hereWebsite widget
too_many_answers429Too many answers — try again in a minuteWebsite widget
unknown_visitor422Unknown visitorWebsite widget
contact_needed422Enter your e-mail addressConsent page
contact_needed_mobile422Enter your e-mail address or mobile numberConsent page
email_only422Use your e-mail addressConsent page
too_many_codes429Too many codes — try again in {minutes} min.Consent page
code_format422Enter the six-digit codeConsent page
code_expired422The code has run out — ask for a new oneConsent page
code_wrong422That code is not rightConsent page
session_ended401Your session ended — ask for a new codeConsent page
request_kind422Choose what you are asking forConsent page
request_detail422Say what you are asking forConsent page
too_many_requests429You have five requests open — wait for an answerConsent page
age_needed422Say whether you are 18 or olderChildren and guardians on the consent page
guardian_needed403A parent or guardian gives this consentChildren and guardians on the consent page
child_barred422Not given for a child: {purposes}Children and guardians on the consent page
guardian_kind422Choose who is giving consentChildren and guardians on the consent page
no_parent_consent409This page does not take a parent's consentChildren and guardians on the consent page
no_guardian_consent409This page does not take a guardian's consentChildren and guardians on the consent page
guardian_own_email422The parent or guardian verifies their own e-mailChildren and guardians on the consent page
guardian_adult422A parent or guardian must be an adultChildren and guardians on the consent page
guardian_declaration422The parent or guardian makes the declarationChildren and guardians on the consent page
guardian_relation422Say how you are relatedChildren and guardians on the consent page
guardian_other409Another parent or guardian gives this person's consentChildren and guardians on the consent page
signup_business_name400Enter the business nameSign-up
signup_owner_name400Enter your nameSign-up
signup_email400Enter a valid e-mailSign-up
signup_mobile400 or 422Enter a 10-digit mobile numberSign-up
signup_terms400Accept the terms to go onSign-up
signup_too_many429Too many tries — try again laterSign-up
signup_check403The security check did not finish — try againSign-up
signup_ca_name400Enter your CA firm's nameSign-up
signup_ca_email400Enter a valid e-mail for your CA firmSign-up
check_answers400 or 422Answer all 10 questionsReadiness check
check_city400Enter your cityReadiness check
check_consent400Tick the box to agreeReadiness check
failed403 or 500Something went wrong — try againAny call

Rate limits

WhatLimitCode
Consent API calls600 in any one minute per keyapi_rate
Widget answers30 in any one minute per address, per workspacetoo_many_answers
Consent page codes5 an hour per person, 30 an hour per addresstoo_many_codes
Wrong codes5 tries per codecode_expired
Open requests5 per persontoo_many_requests

After a 429, wait and try again. too_many_codes says how many minutes in vars.minutes.

Errors and rate limits · DPDPGrid developers