GuidesKB Articles
Guides
  1. Getting Started

HERE SDK 403 "Forbidden" Error – Missing Project-Service Linking

Summary

When using the HERE SDK, a 403 "Forbidden" error may occur if required services are not properly linked to a project.
This issue typically results from missing permissions between the application, project, and services.

Problem

While running a HERE SDK application, the following error may be returned:

HTTP status code: 403

{
  "title": "Forbidden.",
  "status": 403,
  "code": "403403",
  "cause": "App credentials do not authorize access to perform read action on a HERE service because resource relation is missing",
  "action": "Link the resource to the project and retry"
}

Root Cause


This error occurs when:

  • The HERE SDK application is linked to a project, AND

  • The required HERE services are not added to that project

    In this configuration, access to services is restricted to only those explicitly linked within the project.

Solution


Option 1 — Link Required Services to the Project (Recommended)

  1. Open the HERE Platform Console
  2. Navigate to Projects
  3. Select the relevant project
  4. Go to Services
  5. Choose Add service to project
  6. Add all required services used by your SDK application
  7. Rebuild and rerun the application

Option 2 — Unlink the App from the Project

If project-level scoping is not required:

1. Open the HERE Platform Console
2. Navigate to Apps
3. Select your application
4. Remove the associated project link
5. Re-run your application

This allows the app to access all services available in your account (subject to plan limits)



Required Services for HERE SDK

Depending on your SDK use case, ensure that the following services are enabled in your project:

  • HERE Routing

  • HERE Routing – Transit

  • HERE Isoline Routing

  • HERE Search:
    + Autosuggest
    + Browse
    + Forward Geocoder
    + Reverse Geocoder
    + One Box Search
    + Places ID Lookup

  • HERE Traffic API

  • HERE Vector Tile

  • HERE Vector Tile – Traffic

  • HERE Raster Tile

  • HERE Network Positioning

    Note: The exact list of required services may vary depending on the HERE SDK version and features used.

Best Practices

  • Always verify that all required services are linked when using project-scoped apps
  • Use project scoping only when strict access control is required
  • For troubleshooting, temporarily unlinking the app can help isolate permission issues

References

  • Manage projects and services:

https://www.here.com/docs/bundle/identity-and-access-management-developer-guide/page/topics/manage-projects.html


  • HERE SDK service and billing overview:

https://www.here.com/docs/bundle/sdk-for-android-navigate-developer-guide/page/topics/billing.html