---
title: "Authenticate"
method: POST
path: "/v1/auth"
tags: ["Authentication"]
---

# Authenticate

`POST /v1/auth`

## Request

- Base URL: `https://api.spruce.eco`
- URL: `https://api.spruce.eco/v1/auth`
- Auth: none declared

Authenticate with a company API key to obtain a JWT token which must be used when accessing other endpoints.

## Request body

- object
  - `api_key` string, required: API key

## Response `200`

Successfully authenticated

- object
  - `token` string, required: JWT token for authenticating subsequent requests

## Other responses

- `401`: Invalid email or password

---

[API](https://skmtc.dev/spruce/apis/spruce-external-api.md) - [All operations](https://skmtc.dev/spruce/apis/spruce-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spruce/apis/spruce-external-api/revisions/ffdfaf1a73d9?raw)