# Subscribing to a Service

For a brief overview check out [Consume a Service - quick overview](https://docs.apinity.io/quick-start/consume-a-service-quick)

***

### Finding a Service <a href="#subscribingtoaservice-findingtheperfectservice" id="subscribingtoaservice-findingtheperfectservice"></a>

Navigating to <https://marketplace.apinity.io/> brings you to the marketplace **Catalog**.

You can either browse through the listed Services, use the search bar to look for a specific Service, or filter by category or country using the dropdowns.\\

<figure><img src="https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2FWcupF777sUrBtdgnVkoV%2Fimage.png?alt=media&#x26;token=eebde8b0-0e64-4abf-9bb5-bbf68fbae2e3" alt=""><figcaption></figcaption></figure>

### Viewing Details of a Service <a href="#subscribingtoaservice-viewingdetailsofaservice" id="subscribingtoaservice-viewingdetailsofaservice"></a>

Clicking on a Service leads you to the service's Overview and Available Plans sections.

* **Overview** - this page contains the service description and feature details.
* **Available Plans** - this page contains an overview of all the available plans as well their respective Limits & Pricing, Documentation & Contract, and Swagger File.

![](https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2FUlKPztYDsURZ1BKvvq6i%2Fimage.png?alt=media\&token=f485e1ee-de0c-4f95-8e2b-c4d31b9d38bf) ![](https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2Fp3UZwSw2WipS1q9jZEQ6%2Fimage.png?alt=media\&token=d633530e-2642-436b-8f0d-fc2199468d89)

### Ordering a Subscription <a href="#subscribingtoaservice-orderingasubscription" id="subscribingtoaservice-orderingasubscription"></a>

Once you have decided on the service and plan you want to subscribe to, click **Subscribe** in the Available Plans section of the service.

On the next page, you can review your order, as well as read the [apinity marketplace Terms of Service](https://marketplace.apinity.io/terms-and-conditions), the Terms of Service of the Service Provider, and the [Data Policy](https://marketplace.apinity.io/data-policy)

Click **Complete Order** to agree to the terms and data policy, and to subscribe.

### Setting up your Consumer Clients <a href="#subscribingtoaservice-settingupyourconsumerclients" id="subscribingtoaservice-settingupyourconsumerclients"></a>

After you completed a subscription, you will find the service under the **Subscriptions** section of My Hub. In order to consume the service, you must assign at least one Consumer Client. Under the **Technical Setup** of the service, you have the option to create a new consumer client, or assign an existing one.

<figure><img src="https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2FiShVsCrE1X8K9DKTe5L3%2Fimage.png?alt=media&#x26;token=cc9607df-e7a4-4198-ace7-90b809194197" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If this is your first time setting up a consumer client, please check the [Consumer Clients](https://docs.apinity.io/step-by-step/subscribe-and-consume-a-service/consumer-clients) article for more information.
{% endhint %}

If you have already set up Consumer Clients, you can choose **Assign/Unassign Clients** and select one or more of these.

If you need a new consumer client, you can choose **Create New & Assign**, or freely create new unassigned consumer clients under the **Consumer Clients** section of My Hub, by clicking **Create New Client**. Both will lead you to a similar dialogue window:

<figure><img src="https://416365155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNVziGvOGJssgAUojsPRj%2Fuploads%2F0LbwQQq7Ww4JsoJlXOGE%2Fimage.png?alt=media&#x26;token=9a7aaaf0-3d1d-4bcf-a30d-f4e385cb70aa" alt="" width="525"><figcaption></figcaption></figure>

You can choose between a simple API key and OAuth for authentication. You can read more about these in the [Consumer Clients](https://docs.apinity.io/step-by-step/subscribe-and-consume-a-service/consumer-clients) article.

{% hint style="warning" %}
Make sure to **save the API Key or Client Secret** in a secure place as long as it is visible.\
Once you click on **Create Client**, you will no longer be able to view this API Key or Client Secret, and will have to generate a new one.
{% endhint %}

### Managing your Subscription <a href="#subscribingtoaservice-usingyoursubscription" id="subscribingtoaservice-usingyoursubscription"></a>

Once your subscription is active, you can click on it in the **Subscriptions** section to view the details of the subscription. Technical and business-related information is shown in separate tabs:

* **Technical Setup** (only for API services) - contains the Endpoint URL, consumer client settings, Swagger documentation, and additional technical documentation if provided.
* **Business Setup** - contains the plan, subscription period, pricing and contract. You can also unsubscribe from the service here.

### Using the APIs <a href="#subscribingtoaservice-usetheapis" id="subscribingtoaservice-usetheapis"></a>

With everything in place, you can now start consuming your subscribed Services. For more information, please see the [Consume an API (technical Implementation)](https://docs.apinity.io/step-by-step/subscribe-and-consume-a-service/consume-an-api-technical-implementation) article.