---
title: "POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive"
method: POST
path: "/topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive"
---

# POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive

`POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:receive`

Receive a batch of Cloud Events from a subscription.

## Path parameters

- `topicName` string, required
- `eventSubscriptionName` string, required

## Query parameters

- `api-version` string, required
- `maxEvents` integer
- `maxWaitTime` integer

## Response `200`

The request has succeeded.

- ReceiveResult — Details of the Receive operation response.
  - `value` ReceiveDetails[], required — Array of receive responses, one per cloud event.
    - `brokerProperties` BrokerProperties, required — Properties of the Event Broker operation.
      - `lockToken` string, required — The token of the lock on the event.
      - `deliveryCount` integer, required — The attempt count for delivering the event.
    - `event` CloudEvent, required — Properties of an event published to an Azure Messaging EventGrid Namespace topic using the CloudEvent 1.0 Schema.
      - `id` string, required — An identifier for the event. The combination of id and source must be unique for each distinct event.
      - `source` string, required — Identifies the context in which an event happened. The combination of id and source must be unique for each distinct event.
      - `data` unknown
      - `data_base64` string, byte — Event data specific to the event type, encoded as a base64 string.
      - `type` string, required — Type of event related to the originating occurrence.
      - `time` string, date-time — The time (in UTC) the event was generated, in RFC3339 format.
      - `specversion` string, required — The version of the CloudEvents specification which the event uses.
      - `dataschema` string — Identifies the schema that data adheres to.
      - `datacontenttype` string — Content type of data value.
      - `subject` string — This describes the subject of the event in the context of the event producer (identified by source).

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace.md) · [All operations](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/eventgrid-eventgridnamespace/revisions/fa0c2b9f87c0/schema)