TomTom LogoDocs
Products
Resources
Pricing
Sign in
Map Feedback API
Documentation
API Explorer

Create feedback

Service version: 1.0.0Last edit: 2025.09.26

Important note
This API is not available as part of our free evaluation or Pay As You Grow (PAYG) offering. Click the Request Access button above to contact our Sales team.

Purpose

This call is used to create a feedback. Like all other methods of this API, this method requires a TomTom API key. This information will be used to identify the creator of the feedback.

How to request data

HTTP method: POST

  • Constants and parameters enclosed in curly brackets { } must be replaced with their values.
  • Please see the following Request parameters section with the required and optional parameters tables for these values. The generic URL format is as follows.

URL request format

post
URL request format
https://{baseURL}/maps/orbis/feedback?key={API-key}&apiVersion={version}

Request parameters

The following table describes the parameters that can be used in a request.

  • Required parameters must be used or the call will fail.
  • Optional parameters may be used.
  • The order of request parameters is not important.

Parameter

Required

Type

Description

geometry

Yes

string

Center location for the feedback in well-known text (WKT) format. Coordinates must be in longitude-latitude (lon lat) order, e.g. POINT(-3.693252 40.399412).

kind

Yes

string

The schema name used in the data field. This schema must be defined and agreed upon with the TomTom team.

data

Yes

string

Feedback body, a base64 JSON-encoded string following the schema of type ‘kind’

severity

Yes

integer

Severity of the feedback. Must be greater than 0. A lower value means higher severity

labels

No

list of strings

Labels attached to the feedback. A maximum of 20 labels is allowed.

referenceId

No

string

Reference ID of the feedback provided by the customer. The value is unique in the context of the customer.

Example request 

{
 "geometry": "POINT(19.4560 51.7592)",
 "kind": "Example_Kind",
 "data": "ewogICJ0aXRsZSI6ICJQcm9ibGVtIG9uIE1hcCIsCiAgImNyZWF0ZWREYXRlIjogIjIwMjUtMDYtMDYiLAogICJ1c2VyQ29tbWVudCI6ICJUaGlzIHJvYWQgc2hvdWxkIGJlIGRlbGV0ZWQuIiwKICAibG9jYXRpb24iOiAiUE9JTlQoMTkuNDU2MCA1MS43NTkyKSIsCn0=",
 "severity": 1,
 "labels": [
   "Label1"
 ],
 "referenceId": "123001"
}

Response data

Response codes

HTTP Code

Message

Description

Sample response

201

Created

Feedback created successfully

{
  "feedbackId": "7049aa04-91bd-4ad3-8085-bd8bec318905"
}

400

Bad Request

Invalid request parameters

{
  "errorText": "Validation failed",
  "detailedError": {
    "code": "BAD_REQUEST",
    "message": "kind: must not be blank"
  },
  "httpStatusCode": 400
}

403

Forbidden

Access denied

{
  "detailedError": {
    "code": "Forbidden",
    "message": "You are not allowed to access this endpoint"
  }
}

409

Conflict

Conflicting id

{
  "errorText": "Feedback with reference id=mfa-demo-ts-4352167842 already exists",
  "detailedError": {
    "code": "CONFLICT",
    "message": "Feedback with reference id=mfa-demo-ts-4352167842 already exists"
  },
  "httpStatusCode": 409
}

500

Internal Server Error

Internal server error

{
  "errorText": "An unexpected error has occurred. Please try again later.",
  "detailedError": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error has occurred. Please try again later."
  },
  "httpStatusCode": 500
}