---
# System prepended metadata

title: Authenticate CIC

---

![](https://i.imgur.com/DxgjBlM.png)

Authentication service - Technical documentation
===
> **Product Name:** SDK Web ShareID - Authenticate   
> **Version:** 1.0
> **Date:** 2022-12-22
#


**Retrieve the result of an authentication**

This is an addon on the current authentication flow. You may now use it also in this way to retrieve the result of an authentication.

*You can use the session opening in this way:*

```json
POST https://{sandbox}.shareid.net/authorization/v1/auth_business/login
{
  "business_identifier": "my_business_identifier",
  "business_secret": "my_business_secret",
  "callback_url": "https://example.com/callback-response",
  "with_flow_id": true
}
```
You will notice the last parameter ***with_flow_id*** which will tell the api to track the authentication.
The service will reply the usual document, plus a new entry in the payload section containing the flow_id:
```json
{
  "status": "success",
  "message": "Business logged in",
  "payload": {
    "access_token": "...",
    "expiresIn": 10,
    "flow_id": "de454b9f-4df8-4d47-b9c8-24578c3e199e"
  },
  "trace": "..."
}
```
You should keep this ***flow_id*** to be able to retrieve the result later.

Once the authentication is over, you may call this new api:
```sh
curl --location 
    'https://{sandbox}.shareid.net/v1/data/sdk/authentication_result/<FLOW_ID>' 
    --header 'Authorization: Bearer <TOKEN>'
```
The ***<FLOW_ID>*** parameter must be replaced by the one you got from the session opening.
The ***<TOKEN>*** parameter must be replaced by a valid token you have. This is also a token that you got from the session opening.

***
### Technical support  and contact 💬

[Contact@shareid.ai](mailto:Contact@shareid.ai)

* * *
