# Sync

#### Synchronisation State

Sync has a different `status` that determines the state of the verifications, I will be listing everything below and their descriptions&#x20;

A sample webhook payload

```json
{
    "event": "sync.success",
    "data": {
        "metadata": {
            "userId": "a021bf83"
        },
        "id": "a021bf83-519f-4df1-87bc-a867382417df",
        "reason": null,
        "flow": {
            "id": "3ea0117e-e04c-4d22-aec9-08fd5b2ab2da",
            "reference": "flw_Xgjh4q7vpQ",
            "name": "Document and Biometric verification"
        },
        "verifications": [...],
        "status": "approved",
        "createdAt": "2024-02-04T20:49:50.875Z",
        "updatedAt": "2024-02-04T20:49:50.875Z"
    }
}
```

| Status     | Description                                                          |
| ---------- | -------------------------------------------------------------------- |
| approved   | All the verifications tied to sync  has been processed and verified  |
| processing | Some of the verifications tied to the sync is still in review        |
| rejected   | Some of the verifications tied to the sync was rejected after review |
| failed     | Verifications tied to the sync failed                                |

{% tabs %}
{% tab title="ID Documents(Passport, National ID, etc)" %}

```json
{
    "id": "6dff9f53-c7b0-4dec-a44c-0e651148cd60",
    "metadata": {
        "userId": "0e651148cd60"
    },
    "reason": null,
    "status": "approved",
    "deviceFingerprint": {
        "device": {
            "os": {
                "name": "Mac OS",
                "version": "10.15.7"
            },
            "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36",
            "cpu": {},
            "agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36",
            "device": {
                "model": "Macintosh",
                "vendor": "Apple"
            },
            "engine": {
                "name": "Blink",
                "version": "121.0.0.0"
            },
            "browser": {
                "name": "Chrome",
                "major": "121",
                "version": "121.0.0.0"
            }
        },
        "location": {
            "eu": "0",
            "ip": "2001:8f8:1927:34dc:8593:716d:9fbc:26ae",
            "ll": [
                24,
                54
            ],
            "area": 100,
            "city": "",
            "metro": 0,
            "range": "",
            "region": "",
            "country": "AE",
            "timezone": "Asia/Dubai"
        }
    },
    "createdAt": "2024-02-07T14:38:45.799Z",
    "updatedAt": "2024-02-07T14:38:45.799Z",
    "verifications": [
        {
            "id": "c9dc4500-f573-49c9-b485-813f6524ef17",
            "reference": "vrf_Dg5J19Kmw6",
            "idNumber": "11XXXXXXX",
            "firstName": "John",
            "lastName": "Doe",
            "middleName": "Mark",
            "phone": null,
            "email": null,
            "dateOfBirth": "1999-03-31",
            "age": null,
            "sex": "M",
            "country": "AE",
            "nationality": "NGA",
            "issuedDate": null,
            "expiryDate": "2024-11-28",
            "aml": {
                ...
            },
            "amlRisk": "",
            "address": null,
            "assets": [
                {
                    "iso": "AE",
                    "url": "https://verisync-production.s3.eu-west-2.amazonaws.com/247cede1-60f2-4ad8-8f70-d30b42f3e0c6-ID%20Front.jpeg",
                    "type": "national-id",
                    "filename": "ID Front.jpeg",
                    "stateCode": ""
                },
                {
                    "iso": "AE",
                    "url": "https://verisync-production.s3.eu-west-2.amazonaws.com/4dc16cc4-32be-4b81-838b-b2cd3a7e9883-ID%20Back.jpeg",
                    "type": "national-id",
                    "filename": "ID Back.jpeg",
                    "stateCode": ""
                }
            ],
            "channel": "web",
            "active": true,
            "message": null,
            "reverifyReason": null,
            "reverifiedAt": null,
            "verifiedAt": "2024-02-07T14:41:39.634Z",
            "deviceFingerprint": {
                "ip": "13.42.70.11",
                "ua": "axios/1.4.0",
                "origin": "",
                "vpnDetectionEnabled": false
            },
            "status": "approved",
            "createdAt": "2024-02-07T14:38:09.316Z",
            "updatedAt": "2024-02-07T14:41:38.395Z"
        }
    ],
    "user": {
        "id": "65344a57-385d-485a-b486-d9ff67fb8559",
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Mark",
        "email": "mail@gmail.com",
        "phone": "+234904182XXXX",
        "status": "active",
        "emailVerifiedAt": "2024-02-07T14:34:47.543Z",
        "phoneVerifiedAt": "2024-02-07T14:35:37.964Z",
        "createdAt": "2024-02-07T14:34:47.550Z",
        "updatedAt": "2024-02-11T13:43:53.780Z"
    },
    "flow": {
        "id": "3ea0117e-e04c-4d22-aec9-08fd5b2ab2da",
        "name": "Document verification",
        "reference": "flw_Xgjh4q7vpQ",
        "status": "active",
        "configurations": {},
        "createdAt": "2024-02-01T17:25:22.410Z",
        "updatedAt": "2024-02-01T17:25:22.410Z"
    }
}
```

{% endtab %}

{% tab title="Nigeria BVN" %}

```json
{
    "event": "sync.success",
    "data": {
        "metadata": {
            "userId": "739e940b7ace"
        },
        "id": "4fabe9c7-c86a-4410-a7fe-739e940b7ace",
        "reason": null,
        "flow": {
            "id": "59067480-4345-4dc5-b978-4e9b9ade5a2b",
            "reference": "flw_XaT0WL8m8w",
            "name": "BVN Verification"
        },
        "verifications": [
            {
                "id": "aac4cfc8-bc98-462f-82d9-8cf6cd74c95b",
                "reference": "vrf_F0USuycwOy",
                "idNumber": "224XXXXXXXX",
                "firstName": "ABDULFATAI",
                "lastName": "SULEIMAN",
                "middleName": "",
                "phone": "0816184XXXX",
                "email": null,
                "dateOfBirth": "16-01-2XXX",
                "age": null,
                "sex": "Male",
                "country": "NG",
                "nationality": null,
                "issuedDate": null,
                "expiryDate": null,
                "aml": null,
                "amlRisk": null,
                "address": null,
                "assets": [
                    {
                        "name": "Document_ID",
                        "value": "22476977855"
                    },
                    {
                        "name": "First_name",
                        "value": "Abdulfatai"
                    },
                    {
                        "name": "Last_name",
                        "value": "Suleiman"
                    }
                ],
                "channel": "web",
                "active": true,
                "message": null,
                "reverifyReason": null,
                "reverifiedAt": null,
                "verifiedAt": "2024-02-01T19:37:27.565Z",
                "deviceFingerprint": {
                    "ip": "13.42.70.11",
                    "ua": "axios/1.4.0",
                    "origin": "",
                    "vpnDetectionEnabled": false
                },
                "status": "approved",
                "createdAt": "2024-02-01T19:36:01.413Z",
                "updatedAt": "2024-02-01T19:37:26.285Z",
                "identity": {
                    "id": "1030a9d1-4db9-46e9-bbb0-b82d1abdc2f4",
                    "reference": "id_gZuJ86PSEe",
                    "name": "Bank Verification Number",
                    "slug": "bvn",
                    "description": "Verify your Bank Verification Number",
                    "recomended": false,
                    "type": "foundational",
                    "category": "document-verification",
                    "active": true,
                    "status": "approved",
                    "createdAt": "2024-01-30T20:25:02.912Z",
                    "updatedAt": "2024-01-30T20:25:02.912Z"
                },
                "bvn": "224XXXXXXXX",
                "gender": "Male"
            }
        ],
        "status": "approved",
        "createdAt": "2024-02-03T09:15:21.301Z",
        "updatedAt": "2024-02-03T09:15:21.301Z"
    }
}
```

{% endtab %}

{% tab title="Nigeria NIN" %}

```json
{
    "id": "6dff9f53-c7b0-4dec-a44c-0e651148cd60",
    "metadata": {
        "userId": "0e651148cd60"
    },
    "reason": null,
    "status": "approved",
    "deviceFingerprint": {
        "device": {
            "os": {
                "name": "Mac OS",
                "version": "10.15.7"
            },
            "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36",
            "cpu": {},
            "agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36",
            "device": {
                "model": "Macintosh",
                "vendor": "Apple"
            },
            "engine": {
                "name": "Blink",
                "version": "121.0.0.0"
            },
            "browser": {
                "name": "Chrome",
                "major": "121",
                "version": "121.0.0.0"
            }
        },
        "location": {
            "eu": "0",
            "ip": "2001:8f8:1927:34dc:8593:716d:9fbc:26ae",
            "ll": [
                24,
                54
            ],
            "area": 100,
            "city": "",
            "metro": 0,
            "range": "",
            "region": "",
            "country": "AE",
            "timezone": "Asia/Dubai"
        }
    },
    "createdAt": "2024-02-07T14:38:45.799Z",
    "updatedAt": "2024-02-07T14:38:45.799Z",
    "verifications": [
        {
            "id": "3eae4c02-2da7-4498-9c6c-4b9e7ab9142f",
            "reference": "vrf_X0tm9QGg1",
            "idNumber": "57749XXXXXX",
            "firstName": "John",
            "lastName": "Doe",
            "middleName": "-",
            "phone": "07035620046",
            "email": "-",
            "dateOfBirth": "16-01-2000",
            "age": null,
            "sex": "m",
            "country": "NG",
            "nationality": "-",
            "issuedDate": null,
            "expiryDate": null,
            "aml": null,
            "amlRisk": null,
            "address": null,
            "assets": [
                {
                    "name": "Document_ID",
                    "value": "57749XXXXXX"
                },
                {
                    "name": "First_name",
                    "value": "John"
                },
                {
                    "name": "Last_name",
                    "value": "Doe"
                }
            ],
            "channel": "web",
            "active": true,
            "message": null,
            "reverifyReason": null,
            "reverifiedAt": null,
            "verifiedAt": "2024-02-26T10:15:00.377Z",
            "deviceFingerprint": {
                "ip": "13.42.70.11",
                "ua": "axios/1.4.0",
                "origin": "",
                "vpnDetectionEnabled": false
            },
            "status": "approved",
            "createdAt": "2024-02-26T10:14:16.290Z",
            "updatedAt": "2024-02-26T10:14:58.379Z",
            "identity": {
                "id": "95a225b4-f4be-4138-9feb-b9cc86c7115f",
                "reference": "id_uTESIvbz9",
                "name": "National Identification Number",
                "slug": "nin",
                "description": "Verify your National Identification Number",
                "recomended": false,
                "type": "foundational",
                "category": "document-verification",
                "active": true,
                "status": "approved",
                "createdAt": "2024-02-08T19:00:08.442Z",
                "updatedAt": "2024-02-08T19:00:08.442Z"
            },
            "nin": "57749XXXXXX",
            "vnin": "-",
            "title": "mr",
            "gender": "m",
            "height": "-",
            "heigth": "156",
            "religion": "islam",
            "centralID": "32620355",
            "nextOfKin": {
                "lga": "lga",
                "town": "toqn",
                "state": "state",
                "address1": "address1",
                "address2": "",
                "lastName": "Doe",
                "firstName": "John",
                "middleName": "-"
            },
            "residence": {
                "lga": "lga",
                "state": "state",
                "address1": "address1"
            },
            "profession": "STUDENT",
            "trackingId": "S7Y0NYFHD0006RA",
            "lgaOfOrigin": "-",
            "nspokenlang": "language",
            "birthCountry": "-",
            "maritalStatus": "single",
            "placeOfOrigin": "-",
            "stateOfOrigin": "-",
            "educationalLevel": "secondary",
            "employmentStatus": "unemployed"
        }
    ],
    "user": {
        "id": "65344a57-385d-485a-b486-d9ff67fb8559",
        "firstName": "John",
        "lastName": "Doe",
        "middleName": "Mark",
        "email": "mail@gmail.com",
        "phone": "+2349041XXXXXX",
        "status": "active",
        "emailVerifiedAt": "2024-02-07T14:34:47.543Z",
        "phoneVerifiedAt": "2024-02-07T14:35:37.964Z",
        "createdAt": "2024-02-07T14:34:47.550Z",
        "updatedAt": "2024-02-11T13:43:53.780Z"
    },
    "flow": {
        "id": "3ea0117e-e04c-4d22-aec9-08fd5b2ab2da",
        "name": "NIN verification",
        "reference": "flw_Xgjh4q7vpQ",
        "status": "active",
        "configurations": {},
        "createdAt": "2024-02-01T17:25:22.410Z",
        "updatedAt": "2024-02-01T17:25:22.410Z"
    }
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://verisync.gitbook.io/docs/integration-options/webhooks/sync.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
