# Quick Start

## Acquiring an API Key

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can can access your API key directly from your management dashboard:

1. Login to the management dashboard with your account
2. Using the left side navigation panel click on Settings -> Account
3. Here you can reveal your API key or easily copy it.

{% hint style="info" %}
**Important to know:** Currently you can have only one API key. Make sure to save it in a secure location and do not share it. Also make sure to use it only on secured environments like your backend and absolutely not your front end.
{% endhint %}

## Using Your API Key

You may use any server-side programming language that can make HTTPS requests to target the Giftoin API. All requests should target the URL: `https://api.giftoin.org/api/v1` 

You need to supply your API Key in REST API calls in the header with a custom header:\
`x-gft_api_key`

## Make your first request

To make your first request, send an authenticated request to the campaigns endpoint. This will return you an array of existing campaigns, if you have none it will return an empty array.

{% hint style="info" %}
**Don't forget:** You must include your API key with every API call, otherwise you will receive an error.
{% endhint %}

{% openapi src="/files/t4I5L0nOvIDZ44vbu5Sn" path="/v1/gcm/reseller/campaign" method="get" %}
[reseller-1.1.1.yaml](https://content.gitbook.com/content/EhIwc268Kkd8bsiYY2hw/blobs/CPmtKes8SM3wpBcCZFGE/reseller-1.1.1.yaml)
{% endopenapi %}


---

# 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://docs.giftoin.org/introduction/quick-start.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.