---
title: Host Authentication
description: Host Authentication
---

[Skip to content](https://portal.sandgrain.eu/knowledge-base/api/host-authentication#main-content)

English

Show submenu for translations

![SandGrain\_Logo\_RGB\_white-bijgesneden (1)](https://portal.sandgrain.eu/hs-fs/hubfs/SandGrain_Logo_RGB_white-bijgesneden%20(1).png?width=427&height=83&name=SandGrain_Logo_RGB_white-bijgesneden%20(1).png)

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- [Contact us](https://portal.sandgrain.eu/login)

[Contact us](https://portal.sandgrain.eu/login?hsLang=en)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Knowledge Base](https://portal.sandgrain.eu/knowledge-base?hsLang=en)
2. [API Documentation](https://portal.sandgrain.eu/knowledge-base/api-documentation?hsLang=en)
3. [Device API Integration](https://portal.sandgrain.eu/knowledge-base/api-documentation?hsLang=en#device-api-integration)

October 6, 2026

# Host Authentication

This endpoint is used for immediate device authentication which returns the authentication result as a response.

#### Method & Endpoint

**Method:** GET

**Endpoint:** `/api/device/requestHostAuth`

**Headers:** `CF-Access-Client-ID` and `CF-Access-Client-Secret`

#### Request Body

```
{  "requestSignedResponse": false,  "TID": "800000001000000010000000000000014464b592da61f3fd5506fcb1f37f4bef",  "HCW": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",  "HRW": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"}
```

#### ✅ Successful Response — 200 Created

```
{  "transactionId": "123e4567-e89b-12d3-a456-426614174000"}
```

#### ❌ Error Responses

**401 Unauthorized** — Invalid authentication

```
{  "statusCode": 401,  "message": "Unauthorized"}
```

**403 Forbidden** — Authorization Forbidden

```
{  "statusCode": 403,  "message": "Invalid request",  "error": "Forbidden"}
```

**520 Web Server Returned an Unknown Error** — The origin server returned an empty, unknown, or unexpected response to Cloudflare.

---

 

### Check Request Host Authentication Status

This endpoint responsible for checking the authentication result. From previous examples, a correct transactionId is needed to proceed.

#### Method & Endpoint

**Method:** POST

**Endpoint:**`/api/device/checkRequestHostAuthStatus`

**Headers:** `Transaction ID, ``CF-Access-Client-ID` and `CF-Access-Client-Secret```

✅ 200 OK: Success response

```
{  "status": [    "AUTH_OK",    "AUTH_NOT_OK",    "CLAIM_TOKEN"  ],  "claimTokenId": "123e4567-e89b-12d3-a456-426614174000"}
```

#### ❌ Error Responses

**401 Unauthorized** — Invalid authentication

```
{  "statusCode": 401,  "message": "Unauthorized"}
```

**403 Forbidden** — Authorization Forbidden

```
{  "statusCode": 403,  "message": "Invalid request",  "error": "Forbidden"}
```

**500 Internal Server Error** — Unexpected Error Occurred

```
{  “statusCode”: 500,  “message”: “Internal server error”}
```

**520 Web Server Returned an Unknown Error** — The origin server returned an empty, unknown, or unexpected response to Cloudflare.

| [← Token Authentication with Ephemeral Key (EK)](https://portal.sandgrain.eu/knowledge-base/token-authentication-with-ephemeral-key-ek?hsLang=en) | [Priority Host Authentication →](https://portal.sandgrain.eu/knowledge-base/priority-host-authentication?hsLang=en) |
| --- | --- |

- [User Documentation](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#main-content)

    - [Quick Starter Guide](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#quick-starter-guide)
    - [User Manual](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#user-manual)
    - [Whitepaper](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#whitepaper)
    - [Token Leaflet](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#token-leaflet)
    - [Claim Token Procedure](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#claim-token-procedure)
    - [Daisy Chain](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#daisy-chain)
    - [Release Note](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#release-note)
    - [Naming Convention](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#naming-convention)
    - [SandGrain SDK](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#sandgrain-sdk)
    - [TrustBridge](https://portal.sandgrain.eu/knowledge-base/user-documentation?hsLang=en#trustbridge)
- [API Documentation](https://portal.sandgrain.eu/knowledge-base/api-documentation?hsLang=en#main-content)

    - [Device API Integration](https://portal.sandgrain.eu/knowledge-base/api-documentation?hsLang=en#device-api-integration)
    - [Daisy Chain and Attestation](https://portal.sandgrain.eu/knowledge-base/api-documentation?hsLang=en#daisy-chain-and-attestation)
- [SDK](https://portal.sandgrain.eu/knowledge-base/sdk?hsLang=en#main-content)

    - [Core Functions](https://portal.sandgrain.eu/knowledge-base/sdk?hsLang=en#core-functions)
    - [SandGrain SDK](https://portal.sandgrain.eu/knowledge-base/sdk?hsLang=en#sandgrain-sdk)

[![SandGrain\_Logo\_RGB\_white-bijgesneden (1)-1](https://portal.sandgrain.eu/hs-fs/hubfs/SandGrain_Logo_RGB_white-bijgesneden%20(1)-1.png?width=427&height=83&name=SandGrain_Logo_RGB_white-bijgesneden%20(1)-1.png "SandGrain_Logo_RGB_white-bijgesneden (1)-1")](https://portal.sandgrain.eu/?hsLang=en)

<https://www.facebook.com/> <https://www.twitter.com/> <https://www.instagram.com/> <https://podcasts.apple.com/> [mailto:email@email.com](mailto:email@email.com)

Copyright © 2026, sandgrain.eu