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

# Quickstart

> Issue your first e-tax invoice in five minutes.

<Note>
  Some links point to the service guide, which is currently available in Korean only.
</Note>

## Before you begin

<Steps>
  <Step title="Sign up and create a workspace">
    [Sign up for Bolta](/docs/onboarding/getting-started-google), then create a workspace.
  </Step>

  <Step title="Issue a test API key">
    Create a **test key** under [Developer Center > API Keys](/docs/developer-center/api-key).

    Test keys start with `test_`, and every issuance request is processed virtually.
  </Step>

  <Step title="Register a certificate">
    Register your certificate under [Bolta Settings > Certificate](/docs/setting/general/certificate-registration).

    <Info>
      In the test environment you can use a **test certificate**, so you can test your integration even without a real certificate.
    </Info>
  </Step>

  <Step title="Top up credits (for live keys)">
    To call the API with a live key, you must top up credits in advance. You can top up at the [Developer Center](https://developers.bolta.io); if your credit balance is insufficient, API calls will fail.

    <Info>
      Calls made with a test key (`test_`) are free and require no credit top-up. For detailed pricing, see the [Pricing guide](/en/api-introduction/pricing).
    </Info>
  </Step>
</Steps>

## Your first API call

Once you have a test API key and the supplier's `supplierKey`, issue a tax invoice with the curl command below.

```bash theme={"dark"}
curl -X POST https://xapi.bolta.io/v1/taxInvoices/issue \
  -H "Authorization: Basic $(echo -n 'test_YOUR_API_KEY:' | base64)" \
  -H "Supplier-Key: YOUR_SUPPLIER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "YYYY-MM-DD",
    "purpose": "RECEIPT",
    "taxType": "TAXABLE",
    "supplier": {
      "identificationNumber": "1234567890",
      "organizationName": "Supplier Company",
      "representativeName": "Gildong Hong",
      "manager": {
        "email": "supplier@example.com"
      }
    },
    "supplied": {
      "identificationNumber": "0987654321",
      "organizationName": "Recipient Company",
      "representativeName": "Chulsoo Kim",
      "managers": [
        {
          "email": "recipient@example.com",
          "telephone": "010-1234-5678"
        }
      ]
    },
    "items": [
      {
        "date": "YYYY-MM-DD",
        "name": "Test item",
        "unitPrice": 10000,
        "quantity": 1,
        "supplyCost": 10000,
        "tax": 1000
      }
    ]
  }'
```

<Info>
  If you also include the recipient manager's mobile phone number, a KakaoTalk notification (AlimTalk) announcing the tax invoice is sent.
</Info>

<Warning>
  Replace `test_YOUR_API_KEY`, `YOUR_SUPPLIER_KEY`, and both `YYYY-MM-DD` placeholders with real values before sending the request. `Supplier-Key` takes the `supplierKey` of the **supplier (issuer) itself** that issues the tax invoice. The recipient (supplied party) information goes in the `supplied` field of the request body. Both `date` fields must be within the issuance deadline; if you are unsure, try today's date.
</Warning>

## Check the response

If the issuance request succeeds, an `issuanceKey` is returned.

```json theme={"dark"}
{
  "issuanceKey": "8D529FAD3EBAE050B79CE943CCC7CEDE"
}
```

Afterwards, a [webhook](/en/api-introduction/webhook-events) sends an issuance-complete notification, and you can check the result with the [Retrieve Tax Invoice API](/api-reference/tax-invoice/retrieve-tax-invoice).

## Next steps

<CardGroup cols={2}>
  <Card title="Authentication guide" href="/en/api-introduction/authentication">
    Learn more about API key authentication and request headers.
  </Card>

  <Card title="Calculating the issuance amount" href="/en/api-introduction/issuance-guide">
    See how per-item amounts are calculated, with examples.
  </Card>

  <Card title="Use cases" href="/en/api-introduction/usecase-b2b">
    Explore scenarios such as B2B transactions, recurring billing, and reverse issuance.
  </Card>

  <Card title="API Reference" href="/api-reference">
    Explore the full API endpoint reference.
  </Card>
</CardGroup>