Available in Classic and VPC
Get the reservation status of message delivery.
Request
This section describes the request format. The method and URI are as follows:
| Method | URI |
|---|---|
| GET | /alimtalk/v2/services/{serviceId}/reservations/{reserveId}/reserve-status |
Request headers
For information about the headers common to all Simple & Easy Notification Service APIs, see Simple & Easy Notification Service request headers.
Request path parameters
You can use the following path parameters with your request:
| Field | Type | Required | Description |
|---|---|---|---|
serviceId |
String | Required | Biz Message service ID
|
reserveId |
String | Required | Reservation request ID
|
Request example
The request example is as follows:
curl --location --request GET 'https://sens.apigw.ntruss.com/alimtalk/v2/services/ncp:kkobizmsg:kr:27*********6:sens/reservations/RBAA-*************-****-********-ERsezZLD/reserve-status' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'
Response
This section describes the response format.
Response body
The response body includes the following data:
| Field | Type | Required | Description |
|---|---|---|---|
reserveId |
String | Required | Reservation request ID |
reserveTimeZone |
String | Required | Reserved time zone
|
reserveTime |
String | Required | Reservation date and time
|
reserveStatus |
String | Required | Reservation status
|
Response status codes
For information about the HTTP status codes common to all Simple & Easy Notification Service APIs, see Simple & Easy Notification Service response status codes.
Response example
The response example is as follows:
{
"reserveId": "RBAA-*************-****-********-ERsezZLD",
"reserveTimeZone": "Asia/Seoul",
"reserveTime": "2025-11-25T17:37:00+09:00",
"reserveStatus": "READY"
}