The EUTM Filing API will send an error message if anything goes wrong with your API calls. When an error occurs, it triggers the message. Every error message includes:
- an HTTP status code;
- the error type;
- a brief explanation of the error.
This documentation provides additional explanation of the possible errors and guidance on how to avoid them.
When you use any API, keep in mind that errors and exceptions (e.g., server connection problems or outages) are rare, but they do happen. To make sure that your integration is as reliable as it can be, you should always watch out for errors and exceptions.
If your API call returns an error, log the call in as much detail as you can. If you need to contact support, we recommend including the complete request you’re trying to make, the error code, and the response you’re receiving. This will mean they can help you as quickly as possible.
Problem format
We display API errors in human-readable messages in JSON format.
{
"type": "/problems/application-not-editable",
"title": "Application not editable",
"detail": "Only applications with status 'DRAFT' can be modified. Current status is 'PAID'",
"status": 400
}
Problem Glossary
This is a list of the known possible issues with the EUTM Filing API.
| Type | Description |
|---|---|
| General | |
| application-representation-text-contains-invalid-character | If representation text contains invalid characters |
| application-representation-text-field-max-size-exceeded | If representation text exceeds the size limit |
| *colour-representation-colour-list-required | If the colour list has not been provided in the colour representation field |
| *colour-representation-invalid-format | If there are colours with the wrong format in the colour representation field |
| application-invalid-personal-reference | If personal reference does not match expected format |
| goods-and-services-language-invalid | If the language used in the goods and services classification is not the first or second language |
| application-unsupported-payment-method | If unsupported payment method is found in payment preferences |
| application-second-language-not-allowed | If the second language is not one of the five official EUIPO languages (DE, EN, ES, FR, IT) |
| application-second-language-same-as-first | If the second language has the same value as the first language |
| application-correspondence-language-inapplicable | If the chosen correspondence language is the second language but the first language is one of the five official EUIPO languages |
| application-signatures-max-number-exceeded | If the number of signatures exceeds the number of applicants |
| application-incomplete | If any of the mandatory fields of the application have not been filled in |
| application-not-editable | If client tries to update the application when its status is not DRAFT |
| application-status-error | If client tries to do something that is not compatible with the current status of the application |
| Attachments | |
| application-attachment-not-found | If the document referred to as attachment cannot be found |
| invalid-maximum-size | If attached document size exceeds the size limit |
| invalid-file-format | If attached document format is not on the list of allowed formats |
| invalid-filename-length | If attached document filename length exceeds the maximum allowed |
| invalid-image-color-model | If attached document colour model is not allowed |
| invalid-image-dimensions | If attached document dimensions exceeds the maximum allowed |
| invalid-image-maximum-dpi | If attached document DPI exceeds the maximum allowed |
| invalid-image-progressive | If attached document uses progressive image format |
| invalid-audio-channels | If attached document exceeds the maximum channel limit or is below the minimum channel limit |
| invalid-audio-sampling-size | If attached document exceeds the maximum sampling size limit or is below the minimum sampling size limit |
| invalid-video-bit-rate | If attached document exceeds the maximum bit rate or is below the minimum bit rate or has not defined the bit rate |
| invalid-video-frame-rate | If attached document exceeds the maximum frame rate or is below the minimum frame rate or has not defined the video frame rate |
| invalid-video-frame-size | If attached document exceeds the maximum resolution allowed or is below the minimum resolution allowed or has not defined the resolution |
| Applicants | |
| application-invalid-applicant | If applicant information does not fulfil defined constraints |
| application-imported-applicant-cannot-be-updated | If client tries to update an applicant added using its person identifier |
| application-duplicated-person | If another applicant with same person identifier is already in applicants collection |
| application-invalid-correspondence-recipient | If applicant is not from EEA, has been set as correspondence recipient and there is already another applicant in applicants collection that belongs to EEA. |
| Representatives | |
| application-invalid-representative | If representative information does not fulfil defined constraints |
| application-imported-representative-cannot-be-updated | If client tries to update a representative added using its person identifier |
| application-duplicated-person | If another representative with same person identifier is already in representatives collection |
| representative-not-valid | If imported representative is in a non-valid status |
| application-nature-economic-connection-not-specified | If representative type is EMPLOYEE and nature of economic connection was not specified |
| application-reference-document-not-specified | If representative type is EMPLOYEE, the requisite evidence of this type of economic connection has not been specified |
| Priorities | |
| application-claim-not-found | If trade mark used as for priority claim is not found |
| application-duplicated-claim | If another priority with same st13ApplicationNumber is already in the application |
| claim-invalid-period | If trade mark application date is in the future or older than 6 months |
| *claim-incomplete | If any of the mandatory fields for the priority claim have not been filled in. |
| Seniorities | |
| application-claim-not-found | If trade mark used for seniority claim is not found |
| claim-invalid-import-status | Seniority status is not valid for import |
| application-duplicated-claim | If another seniority with same st13ApplicationNumber is already in the application |
| claim-invalid-period |
|
| *claim-incomplete | If any of the mandatory fields for the seniority claim have not been filled in |
| claim-invalid-registration-number | If registration number is not valid the country of the trade mark |
| claim-invalid-country-office-code | If the seniority claim has a WIPO country code |
| IR Transformations | |
| application-claim-not-found | If international registration is not found |
| claim-invalid-period | If international registration date of registration is in the future |
| *claim-incomplete | If any of the mandatory fields for the IR transformation request have not been filled in. |