> For the complete documentation index, see [llms.txt](https://speaking-test-docs.speechace.com/speechace-speaking-test/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://speaking-test-docs.speechace.com/speechace-speaking-test/speaking-test-api.md).

# Speaking Test API

The **Speechace Speaking Test API** lets you retrieve assessment results and related data from the speaking test web application. The API is primarily useful for third party developers who want to integrate speaking test results in to their own apps, LMS's or dashboards.&#x20;

{% hint style="info" %}
**Note:** The Speaking Test API is different from the [Speechace API](https://www.speechace.com/api-plans), which is primarily used to evaluate a speaker's spoken language abilities directly from an audio file. If you are looking for the Speechace speech recognition API then please see the [API developer documentation](https://api-docs.speechace.com/) for endpoint details and the [request and response examples](https://docs.speechace.com/) for sample integrations.
{% endhint %}

### What can you do with the Speaking Test  API ?

* **Access workspaces and assessments:** Retrieve available workspaces, assessments, and activities.
* **Get assessment results:** View candidate attempts, scores, and assessment reports.
* **Get activity results:** Retrieve results for individual activities within an assessment.
* **Get candidate results:** Access assessment-level and activity-level results for a specific candidate.
* **Get detailed results:** Retrieve available scoring details, roleplay conversations, and evaluation feedback.
* **Filter results:** Find relevant records using supported candidate identifiers and date filters.

### How it works ?&#x20;

To get started with the **Speaking Test API**:

1. **Generate an API key** from your Speechace account.
2. **Use your API key** to authenticate your API requests.
3. **Find your workspaces, assessments, and activities** by retrieving their details through the API.
4. **Retrieve results** using the relevant identifiers to access assessment, activity, or candidate results.

Once you have your API key, you're ready to make your first request.

Continue to [**Keys and Authorization**](https://speaking-test-docs.speechace.com/speechace-speaking-test/speaking-test-api/keys-and-authorization.md) to create your API key, authenticate your requests, and make your first API call.
