---
title: "Get authentication token"
method: POST
path: "/api/oauth/v1/token"
tags: ["Authentication"]
---

# Get authentication token

`POST /api/oauth/v1/token`

This endpoint allows you to get an authentication token. No need to be authenticated to use this endpoint.

## Headers

- `Content-type` string, required
- `Authorization` string, required

## Request body

- object
  - `username` string, required — Your PIM username
  - `password` string, required — Your PIM password
  - `grant_type` string, required — Always equal to "password"

## Response `200`

Return an authentication token

- object
  - `access_token` string — Authentication token that should be given in every authenticated request to the API
  - `expires_in` integer — Validity of the token given in seconds, 3600s = 1h by default
  - `token_type` string — Token type, always equal to "bearer"
  - `scope` string — Unused, always equal to "null"
  - `refresh_token` string — Use this token when your access token has expired. See <a href="/documentation/authentication.html#refresh-an-expired-token">Refresh an expired token</a> section for more details.

## Other responses

- `400` — Bad request
- `415` — Unsupported Media type
- `422` — Unprocessable entity

---

[API](https://skmtc.net/akeneo/apis/akeneo-pim-rest-api.md) · [All operations](https://skmtc.net/akeneo/apis/akeneo-pim-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/akeneo/akeneo-pim-rest-api/versions/d8bda9b93b59/schema)