Get project details

Service version: 1
Last edit: 2019.09.18

On this page

Purpose

This endpoint gets all the fences and other details for a project. This can include objects for which the project is a default.

Request data

HTTPS method: GET

URL format

For ease of viewing and identification:

• Required constants and parameters are shown in bold text.
• Optional parameters are shown in plain text.

https://baseURL/geofencing/versionNumber/projects/projectId?&key=Your_API_Key&defaultObjects=true/false

curl command

curl 'https://baseURL/geofencing/versionNumber/projects/projectId?&key=Your_API_Key&defaultObjects=true/false'

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.
• If there is a default value that will be assumed when an optional parameter is not used, it is shown in the table.
• The order of request parameters is not important.

▲ Return to top

Response data

Response body

The following JSON code block demonstrates a successful Response from the API server.

{
  "name": "project_name",
  "id": "project_id",
  "fences": [
    {
      "id": "fence_id",
      "name": "fence_name",
      ...
    }
  ],
  "defaultObjects": [
    {
      "id": "object_id",
      "name": "object_name",
      ...
    }
  ]
}

Response fields

The following data tables describe all of the fields that can appear in a Response.

HTTP Response codes

▲ Return to top

Examples

Example: Get details of the 'Cities in the Netherlands' (id: 44de824d-c368-46cf-a234-a6792682dfd6) project, including a list of objects that have this project set as their default project.

Request format

https://api.tomtom.com/geofencing/1/projects/44de824d-c368-46cf-a234-a6792682dfd6?key=Your_API_Key&defaultObjects=true

▲ Return to top