If you wish to allow a single endpoint to support multiple tenants, you may supply the server with a multitenancy provider.

This means that additional logic will be performed during request parsing to determine a tenant ID, which will be supplied to resource providers. This can be useful in servers that have multiple distinct logical pools of resources hosted on the same infrastructure.

5.9.2URL Base Multitenancy


Using URL Base Multitenancy means that an additional element is added to the path of each resource between the server base URL and the resource name. For example, if your restful server is deployed to http://acme.org:8080/baseDstu3 and a client wishes to access Patient 123 for Tenant "FOO", the resource ID (and URL to fetch that resource) would be http://acme.org:8080/FOO/Patient/123.

To enable this mode on your server, simply provide the UrlBaseTenantIdentificationStrategy to the server as shown below:

public class MyServer extends RestfulServer {

   protected void initialize() {

      setTenantIdentificationStrategy(new UrlBaseTenantIdentificationStrategy());

      // ... do other initialization ...

Your resource providers can then use a RequestDetails parameter to determine the tenant ID:

public class MyPatientResourceProvider implements IResourceProvider {

   public Class<? extends IBaseResource> getResourceType() {
      return Patient.class;

   public Patient read(RequestDetails theRequestDetails, @IdParam IdType theId) {

      String tenantId = theRequestDetails.getTenantId();
      String resourceId = theId.getIdPart();

      // Use these two values to fetch the patient

      return new Patient();