After sending an application, your website gets a response with a status code.
The responses
| Code | Meaning | What to do |
|---|---|---|
202 with a reference, for example "AM-7K3Q9X" |
Received. The applicant gets a confirmation email. | Show a thank-you page, optionally with the reference. |
202 with "reference": null |
Received but ignored (spam, or already 3 open applications for this address). | Show the same thank-you page. |
401 |
The key is missing, unknown or revoked. | Check the server configuration. |
413 |
The application is too large (more than 32 KB). | Send less data. |
415 |
The application is not JSON. | Send Content-Type: application/json. |
422 |
One or more fields are not correct. For each field there is a message in the language of locale. |
Show the messages next to the fields, for example company.kvk. |
429 |
Too many requests. | Try again later. |
502 |
The service is temporarily unavailable. | Try again later. |
An example of a 422:
{
"message": "…",
"errors": { "company.kvk": ["Een KvK-nummer heeft 8 cijfers."] }
}
Good to know
- The response is always "received" if the data is correct. This way, nobody can use your form to find out whether someone is already a customer.
- There is a limit per key and per visitor. According to the technical documentation, that is 200 applications per key per hour and 10 per visitor IP address per hour.