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

# Quickstart

This guide walks you through the client happy path end to end: authenticate, optionally upload a source file, submit a Request for Quote, accept the quote you receive and track the resulting project.

All examples use the production base URL `https://api.adaptria.locaria.com`. Swap in another [environment](/client-api/environments.md) as needed.

## 1. Authenticate

Every request carries your API key in the `Api-key` header. A quick way to confirm your key works is to list your RFQs:

```bash
curl https://api.adaptria.locaria.com/api/public/v1/rfqs \
  -H "Api-key: lla_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

## 2. (Optional) Upload a source file

If your RFQ needs source content attached, upload each file first and keep the returned `fileId`. Files are uploaded per service.

```bash
curl -X POST https://api.adaptria.locaria.com/api/public/v1/files/upload/presigned-url \
  -H "Api-key: lla_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@/path/to/source-content.docx"
```

The response contains a `fileId`, which you reference as an `assetFileIds` entry in the next step.

## 3. Submit the RFQ

Create and submit the RFQ in a single call. Describe the work, list the services you need (with languages or target markets) and attach any uploaded file IDs.

```bash
curl -X POST https://api.adaptria.locaria.com/api/public/v1/rfqs \
  -H "Api-key: lla_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "projectName": "Q4 Marketing Campaign",
    "projectDescription": "Translate marketing content from English to French and German.",
    "services": [
      {
        "serviceId": "8398f952-99f3-468a-a44c-6620a48dd07c",
        "type": "LINGUISTICS",
        "sourceLanguageId": "3ebf026a-578b-46cb-b4a5-de4b54bab575",
        "targetLanguageIds": ["7da3f046-8d67-4cdc-beea-8e9afdaeaf30"],
        "assetFileIds": ["91cc2de4-293b-4c37-b257-5d39cd1133da"]
      }
    ],
    "autoSubmit": true
  }'
```

{% hint style="info" %}
To gather the IDs above, use the reference endpoints: `GET /api/public/v1/client/companies`, `GET /api/public/v1/client/services`, `GET /api/public/v1/client/languages` and `GET /api/public/v1/client/target-markets`.
{% endhint %}

Check the RFQ's status at any time with `GET /api/public/v1/rfqs/{id}`.

## 4. Receive and accept the quote

Adaptria reviews your RFQ and prepares a quote. List your quotes with `GET /api/public/v1/quotes`, and retrieve a single quote with `GET /api/public/v1/quotes/{id}`. You can also download a quote as a PDF from `GET /api/public/v1/quotes/{id}/pdf`.

When you are happy with a quote that is in `SENT` or `REVISED` status, accept it:

```bash
curl -X POST https://api.adaptria.locaria.com/api/public/v1/quotes/{id}/accept \
  -H "Api-key: lla_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

Accepting converts the quote into an active project. If you do not wish to proceed, decline it with `POST /api/public/v1/quotes/{id}/decline`.

## 5. Track the project

Follow the project through to delivery:

```bash
curl https://api.adaptria.locaria.com/api/public/v1/projects/{id} \
  -H "Api-key: lla_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```

Retrieve the finished files with `GET /api/public/v1/projects/{id}/deliverables`, and share feedback with `POST /api/public/v1/projects/{id}/feedback`.

## Where to go next

* See the [API Reference](/client-api/reference.md) for the complete set of endpoints and their parameters.