> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools-and-resources/api-reference/external-apis/sends-data-with-sync-events.md).

# Sends Data with Sync Events

**`POST /external/{policyId}/{blockTag}/sync-events`**

Sends a Verifiable Credential (VC) document to a specific policy block and returns synchronous policy events triggered by the submission.

***

## Request

### Path Parameters

| Parameter  | Type   | Required | Description                             |
| ---------- | ------ | -------- | --------------------------------------- |
| `policyId` | string | Yes      | The ID of the target policy             |
| `blockTag` | string | Yes      | The tag name of the target policy block |

### Query Parameters

| Parameter | Type    | Required | Default | Description                                          |
| --------- | ------- | -------- | ------- | ---------------------------------------------------- |
| `history` | boolean | No       | `false` | Whether to include historical events in the response |

### Request Body

```json
{
  "owner": "did:hedera:testnet:zHcDLGFNymFAJiMBKnpbHDgjvTn6yZnwkPPeFhtJBECH_0.0.4532001",
  "policyTag": "example_policy_tag",
  "document": {
    "@context": ["https://www.w3.org/2018/credentials/v1"],
    "id": "urn:uuid:63e3e5e8-a01b-3c00-1234-abcdef012345",
    "type": ["VerifiableCredential"],
    "issuer": "did:hedera:testnet:zHcDLGFNymFAJiMBKnpbHDgjvTn6yZnwkPPeFhtJBECH_0.0.4532001",
    "issuanceDate": "2024-06-01T00:00:00.000Z",
    "credentialSubject": {}
  }
}
```

| Field       | Type   | Required | Description                        |
| ----------- | ------ | -------- | ---------------------------------- |
| `owner`     | string | Yes      | DID of the document owner          |
| `policyTag` | string | No       | Tag of the policy                  |
| `document`  | object | Yes      | The Verifiable Credential document |

***

## Response

### Success Response

**Status:** `200 OK`

```json
{
  "result": true,
  "events": [
    {
      "blockTag": "approve_application",
      "data": {}
    }
  ]
}
```

### Error Responses

| Status                      | Description               |
| --------------------------- | ------------------------- |
| `500 Internal Server Error` | Unexpected server failure |