# Getting started

The Service Provider role is fulfilled by a legal entity that provides a service, in the form of data, for consumption by a Service Consumer. This legal entity provides the result of a service that Service Consumer(s) need; for example, the party that uses a truck’s time and location to calculate and communicate the truck’s optimal route and estimated time of arrival.

## Prerequisites

Make sure you execute the following steps before trying to provide as an iSHARE Service Provider.

1. **Obtain a valid identity (private key + certificate)**
   * **Staging:** [Click here](https://ca7.isharetest.net:8442/ejbca/ra/index.xhtml) to request a test certificate. More information on [Get Test Certificate section](/version-2.2/introduction/getting-started/test-certificates.md).
   * **Production:** Acquire a certificate from an eIDAS certificate provider.
2. **Register yourself as iSHARE Provider**
   * **Staging:** If you want to register at a specific Participant Registry, contact the Participant Registry through their communication channels. A registration via the Scheme Owner is also possible: [Contact the Scheme Owner](https://ishare.eu/home/contact/).
   * **Production:** Register yourself with any Participant Registry using their registration procedure, using the [admission process](https://framework.ishare.eu/detailed-descriptions/operational/operational-processes/admission).

## Implementation of required endpoints

Any Service Providers is required to implement the following endpoints. These endpoints will be subject of the conformance test, as part of the [admission process](https://framework.ishare.eu/detailed-descriptions/operational/operational-processes/admission).

* [ ] [Access Token](/version-2.2/all-roles-common-endpoints/access-token-m2m.md)
* [ ] [Capabilities](/version-2.2/all-roles-common-endpoints/capabilities.md)
* [ ] [Return](/version-2.2/service-provider-role/return.md) (for human-to-machine (H2M) consumption of its services using an Identity Provider)

## Example implementation of REST endpoint

If the Service Provider wants to expose a REST endpoint as part of its services as iSHARE Service Provider, it can do so following the example implementation given in the following endpoint:

* [ ] [Service](/version-2.2/service-provider-role/getting-started/service.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.ishare.eu/version-2.2/service-provider-role/getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.