# API Overview

The Sail API is organized around REST. It has predictable, resource-oriented URLs, accepts JSON request bodies, returns JSON responses, and uses standard HTTP verbs and response codes.

The API is strictly server-to-server. Calls are made from your backend. Anything your users see and touch happens in a secure, Sail-hosted widget that you embed in your app, not through direct API calls from a client. 

## Base URL

All API requests are sent to the following base URL. Add the endpoint path to this URL to make a request to a specific resource.

```
https://live.savewithsail.com/api/v1
```

## Setup and integration

The resources below cover authentication, error handling, and event delivery. Start here if you're setting up your first integration.

<CardGroup cols={2}>
  <Card title="Authentication" href="/docs/api-reference/authentication" icon="fa6-solid:lock">
    API keys, scopes, ephemeral user tokens, and the endpoint authorization matrix.
  </Card>

  <Card title="Errors" href="/docs/api-reference/errors" icon="fa6-solid:circle-exclamation">
    The standard error envelope and the full HTTP status and error code catalog.
  </Card>

  <Card title="Webhook Events" icon="fa6-solid:bolt" href="/docs/api-reference/webhook-events">
    The complete event catalog, envelope shape, and signature verification.
  </Card>
</CardGroup>

## API resources

Every resource available through the Sail API. Each link takes you to the full endpoint reference for that resource.

<CardGroup cols={3}>
  <Card title="Users" href="/reference/users" icon="fa6-solid:user"/>

  <Card title="Connections" href="/reference/connections" icon="fa6-solid:plug"/>

  <Card title="Accounts" href="/reference/accounts" icon="fa6-solid:building-columns"/>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Connect Account Widgets" href="/reference/connect-account-widgets" icon="fa6-solid:window-maximize"/>

  <Card title="Expenses" href="/reference/expenses" icon="fa6-solid:receipt"/>
</CardGroup>

<CardGroup cols={3}>
  <Card title="Merchants" href="/reference/merchants" icon="fa6-solid:store"/>

  <Card title="Administrators" href="/reference/administrators" icon="fa6-solid:building"/>

  <Card title="Identity" href="/reference/identity" icon="fa6-solid:id-card"/>
</CardGroup>