---
title: "Authentication endpoint"
method: POST
path: "/v1/authenticate"
tags: ["Login"]
---

# Authentication endpoint

`POST /v1/authenticate`

Use this endpoint to obtain an access token for calling Velo Payments APIs. Use HTTP Basic Auth. String value of
Basic and a Base64 endcoded string comprising the API key (e.g. 44a9537d-d55d-4b47-8082-14061c2bcdd8) and API
secret  (e.g. c396b26b-137a-44fd-87f5-34631f8fd529) with a colon between them. E.g. Basic 44a9537d-d55d-4b47-8082-14061c2bcdd8:c396b26b-137a-44fd-87f5-34631f8fd529

## Query parameters

- `grant_type` string

## Response `200`

Valid Authenication response

- AuthResponse
  - `access_token` string, uuid, required
  - `token_type` string, required
  - `expires_in` number
  - `refresh_token` string
  - `scope` string
  - `entityIds` string[]

## Changes

- **2019-12-11** `a0b19fa311c0` — 2 info
  - api tag `Login` added
  - api tag `Auth` removed
- **2019-08-02** `916feac19ad0` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2019-07-19** `a88221744820` — 1 info
  - endpoint added
- **2019-07-15** `ced8e167a97c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v1/authenticate/post.md)

---

[API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [All operations](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/revisions/1b2abf26b5d6?raw)