> For the complete documentation index, see [llms.txt](https://fortisx.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fortisx.gitbook.io/docs/introduction/readme.md).

# Getting Started

This guide shows how to make your first request to the **Fortisx API** and interpret responses.

***

## Base URL

```
https://api.fortisx.fi/v1
```

> Use this URL for all production requests.

***

## Authentication

* **System Endpoints:** no API key required.
* **All other endpoints:** include your API key as a Bearer token in the `Authorization` header:

```
Authorization: Bearer <API_KEY>
```

***

## Your First Call: `GET /ping`

Returns a simple health-check response to verify connectivity with the API.

**HTTP**

```
GET /ping
Accept: application/json
```

***

## Quick Examples

### cURL

```bash
curl -G "https://api.fortisx.fi/v1/ping" -H "Accept: application/json"
```

***

## Successful Response

**200 OK**

```json
{ "status": "ok" }
```

***

## Error Responses

All error responses follow the same JSON shape:

```json
{ "error": "<short description>" }
```

See [**Errors**](/docs/api-reference/errors.md) for details.