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

# Introduction

> Learn how to use the Smart Send REST API

Use the Smart Send API to automate every aspect of your shipping workflows, from booking shipments to tracking and returns. The API powers all official Smart Send integrations, so anything our Shopify and WooCommerce apps can do, you can do too.

If you are looking for a ready-made solution for your webshop, explore our e-commerce integrations instead:

<Columns cols={2}>
  <Card title="WooCommerce plugin" icon="https://mintcdn.com/smartsend/bqSp1rejr9w3k8P_/icons/woocommerce.svg?fit=max&auto=format&n=bqSp1rejr9w3k8P_&q=85&s=45100db367d50450edd6e4aaee26fc1a" href="/integrations/woocommerce/introduction" horizontal width="256" height="153" data-path="icons/woocommerce.svg" />

  <Card title="Shopify App" icon="shopify" href="/integrations/shopify/introduction" horizontal />
</Columns>

## Base URL

All API requests are made against the following base URL:

```bash theme={null}
https://app.smartsend.io/api
```

## OpenAPI specification

The full API is described in machine-readable OpenAPI specifications. Use them to generate client libraries, import the API into tools like Postman, or explore the available endpoints and schemas.

<Columns cols={2}>
  <Card title="API v1 specification" icon="file-json" href="/openapi-v1.json" horizontal>
    Download the OpenAPI spec for the stable v1 API.
  </Card>

  <Card title="API Beta specification" icon="file-json" href="/openapi-v2beta.json" horizontal>
    Download the OpenAPI spec for the beta API.
  </Card>
</Columns>

## Integrations

The Smart Send API is the same API that powers our official integrations. If you are building on top of an existing platform, you can often save time by starting from one of our open-source integrations rather than calling the API directly:

<Columns cols={2}>
  <Card title="WooCommerce plugin" icon="https://mintcdn.com/smartsend/bqSp1rejr9w3k8P_/icons/woocommerce.svg?fit=max&auto=format&n=bqSp1rejr9w3k8P_&q=85&s=45100db367d50450edd6e4aaee26fc1a" href="/integrations/woocommerce/introduction" horizontal width="256" height="153" data-path="icons/woocommerce.svg" />

  <Card title="Shopify App" icon="shopify" href="/integrations/shopify/introduction" horizontal />
</Columns>

## Authentication

The Smart Send API uses bearer tokens for authentication. Generate a token in the Smart Send platform and include it in the `Authorization` header of every request.

<Card title="Authentication" icon="key" href="/api-reference/authentication" horizontal>
  Learn how to generate, use, and revoke API tokens.
</Card>

## Make your first request

Once you have an API token, you can verify your setup with a simple request. The example below lists the carrier agents available in Denmark:

```bash theme={null}
curl https://app.smartsend.io/api/v2/agents/dk \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
```

If your token is valid, the API responds with a JSON payload describing the available carrier agents. From here, you can start exploring the rest of the API.

## Next steps

<CardGroup cols={3}>
  <Card title="Review authentication" icon="key" href="/api-reference/authentication">
    Generate, rotate, and revoke API tokens.
  </Card>

  <Card title="Review debugging" icon="bug" href="/api-reference/debugging">
    Use headers like `User-Agent` and `Request-ID` to trace requests.
  </Card>

  <Card title="Browse the endpoint reference" icon="book" href="/api-reference/agents/list-carrier-agents-in-country">
    Browse the API sidebar to see available resources and request schemas.
  </Card>
</CardGroup>