---
title: "Quick Start"
slug: "quick-start"
updated: 2025-12-15T18:46:19Z
published: 2025-12-15T18:46:19Z
canonical: "guide.youraspire.com/quick-start"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.youraspire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

In a nutshell, using the API requires:

- An Aspire account within a supported company tier.
- Access to the API sandbox and production environments.
- Authorization to use the API.
- The ability to execute requests

This guide will show you how to meet these requirements.

### 

## Prerequisites

### Supported company tier

Your current company tier determines if you will be able to use the API:

- **Enterprise:** API access is included.
- **Corporate**: You can request API access at no additional cost.
- **Growth:** You can request API access at no additional cost.

If your company does not currently have API access, reach out to **AspireCare** to request activation or discuss available options.

### Available environments

Aspire offers access to two different servers:

- Use the sandbox environment to test requests before publishing them in production.
  - Base URL -  [https://cloudsandbox-api.youraspire.com](https://cloud-api.youraspire.com/swagger/index.html)/
- [](https://cloud-api.youraspire.com/swagger/index.html)Production is a stable environment that should be used once your constructed requests are ready to go live.
  - Base URL - [https://cloud-api.youraspire.com](https://cloud-api.youraspire.com/swagger/index.html)/

## Authenticate & authorize

Once prerequisites are met, credentials must be authenticated to obtain the access token needed to access endpoints. Only an [](https://cloud.youraspire.com/login?returnUrl=%2Fapp)Aspire user account with [Admin permission](https://guide.youraspire.com/may-2021/docs/admin-permissions) can be used to create or change the Client ID and Key needed to generate and refresh the access token to authorize using the External Aspire API. Click [Authentication & Authorization](https://guide.youraspire.com/apidocs/authentication-and-authorization) for step-by-step instructions.

## Create your first request in the API Guide

Requests can be created once successfully authenticated. Let's test and ensure your setup is correct using the GET/Contacts endpoint to retrieve a list of contacts that are not active. You must adhere to [OData Syntax](https://guide.youraspire.com/apidocs/odata-syntax-and-query-parameters) when using the query parameters to create the request.

Follow these steps to create the request described above.

1. Select the GET/Contacts endpoint from the API reference menu.
2. Enter your access token (you will only need to enter it once during a session. After doing so, it will automatically populate within the **Token*** section of the other endpoints you interact with).
3. You will find the properties and fields that can be queried under the Array of Object section. The data type for the Active field is **boolean**, so we know the value can be true if we are looking to retrieve a list of active contacts and false if we need to generate a list of inactive contacts.
4. Enter **Active eq false** next to the  $filter query option.
5. The response should appear as shown in the image in the pane next to step five if everything is set up correctly.

![](https://cdn.document360.io/5942a8d7-f3b1-4919-bdfa-d477d8498fe3/Images/Documentation/image-1704702669953.png)

A unique identifier assigned to a client application in authentication and authorization systems, often used in protocols like OAuth.

AKA a secret key. It is an encrypted key, used for securing and authorizing communication between systems.