Copyrights

Purpose

The Copyrights API is designed to serve copyright information for the Map Display services. As an alternative to copyrights for map request, you can receive copyrights for the map service called captions.

Run this endpoint

You can easily run this and other endpoints. Go to the TomTom API Explorer page and follow the directions.

Map Copyrights

Request data

HTTPS method: GET

Please see the following Request parameters section with the required parameters table for these values. The generic URL format is as follows.

URL format

The schema for the map copyrights request:

https://{baseURL}/map/{versionNumber}/copyrights?key={Your_API_key}

Example

https://api.tomtom.com/map/2/copyrights?key={Your_API_Key}

curl command format

curl 'https://api.tomtom.com/map/2/copyrights?key={Your_API_Key}'

Request parameters (Map Copyrights)

Response data

The response body will contain copyrights in a plain text format.

1© 1992 - 2022 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection,
2database right protection and other intellectual property rights owned by TomTom or its suppliers.
3The use of this material is subject to the terms of a license agreement.
4Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.
5Data Source © 2022 TomTom,
6based on https://www.tomtom.com/en_gb/thirdpartyproductterms/

Map Service Copyrights

Request data

HTTPS method: GET

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 format

The schema for the map service copyrights:

https://{baseURL}/map/{versionNumber}/copyrights/caption.json?key={Your_API_Key}

Example

https://api.tomtom.com/map/2/copyrights/caption.json?key={Your_API_Key}

curl command format

curl 'https://{baseURL}/map/{versionNumber}/copyrights/caption.json?key={Your_API_Key}'

Request parameters (Map Service Copyrights)

Response data

For the map service copyright request, the response body will contain a copyrights caption in JSON format.

1{
2  "formatVersion": "0.0.1",
3  "copyrightsCaption": "©TomTom"
4}

Error response

The Map Display API Copyrights service for an invalid request returns a response body in XML or JSON format. The XML format is returned by default. To have an error response returned in JSON format, application/json has to be specified in the Accept HTTP request header.

Error response field structure

Error response example

1{
2  "detailedError": {
3    "code": "BAD_REQUEST",
4    "message": "Bad Request"
5  }
6}

1<errorResponse description="Bad Request" errorCode="400" version="1.0.54-mascoma">
2  <detailedError>
3    <code>BAD_REQUEST</code>
4    <message>Bad Request</message>
5  </detailedError>
6</errorResponse>

Response codes

Response headers