{ "openapi":"3.1.0", "info":{ "title":"Infobip OpenAPI Specification", "description":"OpenAPI Specification that contains all public endpoints and webhooks.", "contact":{ "name":"Infobip support", "email":"support@infobip.com" }, "version":"3.210.0", "x-generatedAt":"2026-07-23T15:23:49.30644178Z" }, "tags":[ { "name":"channels", "description":"Create a perfect customer experience by using the channels your customer already use and love.\n", "x-type":"category", "x-displayName":"Channels" }, { "name":"line", "description":"Disrupt the Southeast Asian market with LINE messaging. Send timely notifications and reminders to your customers, through pre-approved templates, so they can take prompt action and never miss out on communications.\n\nTo utilize LINE in combination with other channels, check out [Messages API](https://www.infobip.com/docs/api/platform/messages-api).\n", "x-type":"product", "x-displayName":"LINE" }, { "name":"send-line", "description":"", "x-type":"section", "x-displayName":"Outbound Message" }, { "name":"line-message-status-reports", "description":"", "x-type":"section", "x-displayName":"Message Status Reports" } ], "paths":{ "/line/1/messages":{ "post":{ "tags":[ "channels", "line", "send-line" ], "summary":"Send a LINE message", "description":"Send one or more [LINE Official Notifications](https://www.infobip.com/docs/line/message-types#line-official-notifications-lon) messages to multiple recipients.", "externalDocs":{ "description":"Learn more about LINE channel and use cases", "url":"https://www.infobip.com/docs/line" }, "operationId":"send-line-message", "requestBody":{ "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineRequest" }, "examples":{ "Send a LINE message":{ "summary":"Send a LINE message", "value":{ "messages":[ { "sender":"OFFICIAL-ACCOUNT-ID-123", "destinations":[ { "to":"66855538125" } ], "content":{ "altText":"Thank you for your purchase. We have successfully received your order.", "contents":{ "header":{ "layout":"HORIZONTAL", "paddingAll":"none", "paddingTop":"md", "paddingBottom":"md", "paddingStart":"lg", "paddingEnd":"lg", "offsetTop":"none", "contents":[ { "url":"https://example.com/logo", "flex":2, "align":"CENTER", "gravity":"CENTER", "size":"80%", "type":"IMAGE" }, { "contents":[ { "text":"OFFICIAL NOTIFICATION", "type":"SPAN" } ], "flex":20, "size":"14px", "align":"CENTER", "gravity":"CENTER", "wrap":true, "color":"#ffffff", "weight":"REGULAR", "position":"RELATIVE", "type":"TEXT" }, { "text":"powered by", "contents":[ { "text":"powered by", "size":"10px", "weight":"REGULAR", "style":"ITALIC", "type":"SPAN" } ], "flex":7, "align":"END", "gravity":"CENTER", "wrap":true, "color":"#ffffff", "offsetTop":"0.3px", "type":"TEXT" }, { "text":"powered by", "contents":[ { "text":"LINE", "size":"12px", "weight":"BOLD", "type":"SPAN" } ], "flex":4, "align":"CENTER", "gravity":"CENTER", "wrap":true, "color":"#ffffff", "type":"TEXT" } ], "type":"BOX" }, "body":{ "layout":"VERTICAL", "paddingAll":"none", "paddingTop":"xl", "paddingBottom":"lg", "paddingStart":"xxl", "paddingEnd":"xxl", "contents":[ { "layout":"VERTICAL", "paddingTop":"none", "offsetTop":"none", "offsetBottom":"none", "contents":[ { "text":"Purchase complete", "size":"lg", "wrap":true, "weight":"BOLD", "type":"TEXT" } ], "type":"BOX" }, { "layout":"HORIZONTAL", "paddingTop":"lg", "contents":[ { "contents":[ { "text":"Thank you for your purchase. We have successfully received your order.", "type":"SPAN" } ], "wrap":true, "offsetTop":"none", "type":"TEXT" } ], "type":"BOX" } ], "type":"BOX" }, "footer":{ "layout":"HORIZONTAL", "borderWidth":"none", "margin":"none", "paddingTop":"sm", "paddingBottom":"md", "action":{ "label":"action", "uri":"https://example.com/action", "type":"URI" }, "contents":[ { "contents":[ { "text":"Learn more about LINE Official Notification ", "color":"#BDBDBD", "type":"SPAN" }, { "text":"here", "color":"#00b4ff", "decoration":"UNDERLINE", "type":"SPAN" }, { "text":".", "color":"#BDBDBD", "type":"SPAN" } ], "size":"10px", "align":"CENTER", "wrap":true, "type":"TEXT" } ], "type":"BOX" }, "style":{ "header":{ "backgroundColor":"#06C755" }, "footer":{ "backgroundColor":"#EEEEEE" } }, "type":"BUBBLE" }, "type":"LINE_NOTIFICATION" } } ] } } } } }, "required":true }, "responses":{ "200":{ "description":"OK", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ResponseEnvelopeMessageResponseMessageResponseDetails" }, "examples":{ "LINE message response":{ "summary":"LINE message response", "value":{ "bulkId":"2034072219640523072", "messages":[ { "messageId":"2250be2d4219-3af1-78856-aabe-1362af1edfd2", "status":{ "groupId":1, "groupName":"PENDING", "id":7, "name":"PENDING_ENROUTE", "description":"Message sent to next instance" }, "destination":"66855538125" } ] } } } } } }, "400":{ "description":"Bad Request", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "examples":{ "Bad request":{ "summary":"Bad request", "value":{ "errorCode":"E400", "description":"Request cannot be processed.", "action":"Check the syntax, violations and adjust the request.", "violations":[ { "property":"property.path", "violation":"Violation message." } ], "resources":[] } } } } } }, "401":{ "$ref":"#/components/responses/ApiError401" }, "403":{ "$ref":"#/components/responses/ApiError403" }, "500":{ "$ref":"#/components/responses/ApiError500" } }, "security":[ { "IBSSOTokenHeader":[] }, { "APIKeyHeader":[] }, { "Basic":[] }, { "OAuth2":[] } ], "x-scopes":[ "message:send", "line:message:send", "line:manage" ] } }, "/line/1/reports":{ "get":{ "tags":[ "channels", "line", "line-message-status-reports" ], "summary":"Get LON delivery reports", "description":"If you are unable to receive real-time delivery reports towards your endpoint for various reasons, we offer you an API method to fetch batches of delivery reports to confirm whether specific messages have been delivered. Each request towards this endpoint will return batches of the latest delivery reports. Please note they will be returned only once.", "externalDocs":{ "description":"Learn more about LINE channel and use cases", "url":"https://www.infobip.com/docs/line" }, "operationId":"get-outbound-line-message-delivery-reports", "parameters":[ { "name":"bulkId", "in":"query", "description":"The ID that uniquely identifies the request. Bulk ID will be received only when you send a message to more than one destination address.", "required":false, "style":"form", "explode":true, "schema":{ "type":"string" } }, { "name":"messageId", "in":"query", "description":"The ID that uniquely identifies the message sent.", "required":false, "style":"form", "explode":true, "schema":{ "type":"string" } }, { "name":"limit", "in":"query", "description":"Maximum number of delivery reports to be returned. If not set, the latest 50 records are returned. Maximum limit value is 1000 and you can only access reports for the last 48h.", "required":false, "style":"form", "explode":true, "schema":{ "type":"integer", "format":"int32", "default":50, "maximum":1000 }, "example":1 }, { "name":"entityId", "in":"query", "description":"Entity id used to send the message. For more details, see our [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).", "required":false, "style":"form", "explode":true, "schema":{ "type":"string" }, "example":"promotional-traffic-entity" }, { "name":"applicationId", "in":"query", "description":"Application id used to send the message. For more details, see our [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).", "required":false, "style":"form", "explode":true, "schema":{ "type":"string" }, "example":"marketing-automation-application" }, { "name":"campaignReferenceId", "in":"query", "description":"ID of a campaign that was sent in the message.", "required":false, "style":"form", "explode":true, "schema":{ "type":"string" }, "example":"summersale" } ], "responses":{ "200":{ "description":"OK", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReports" }, "examples":{ "Delivery report":{ "summary":"Delivery report", "value":{ "results":[ { "bulkId":"1688025180464000013", "price":{ "pricePerMessage":0.15, "currency":"EUR" }, "status":{ "groupId":3, "groupName":"DELIVERED", "id":5, "name":"DELIVERED_TO_HANDSET", "description":"Message delivered to handset" }, "error":{ "groupId":0, "groupName":"OK", "id":0, "name":"NO_ERROR", "description":"No Error", "permanent":false }, "messageId":"1688025180464000014", "to":"66855538125", "sender":"OFFICIAL-ACCOUNT-ID-123", "sentAt":"2023-09-26T10:52:15.457+0000", "doneAt":"2023-09-26T10:52:15.799+0000", "messageCount":1, "mccMnc":"22801", "platform":{ "entityId":"promotional-traffic-entity", "applicationId":"marketing-automation-application" } } ] } } } } } }, "401":{ "$ref":"#/components/responses/ApiError401" }, "403":{ "$ref":"#/components/responses/ApiError403" }, "500":{ "$ref":"#/components/responses/ApiError500" } }, "security":[ { "IBSSOTokenHeader":[] }, { "APIKeyHeader":[] }, { "Basic":[] }, { "OAuth2":[] } ], "x-scopes":[ "message:send", "line:message:send", "line:manage" ] } } }, "components":{ "schemas":{ "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action":{ "type":"object", "discriminator":{ "propertyName":"type", "mapping":{ "URI":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.UriAction", "POSTBACK":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.PostbackAction" } }, "properties":{ "type":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ActionType" } }, "title":"Action" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ActionType":{ "type":"string", "enum":[ "URI", "POSTBACK" ], "title":"ActionType" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Alignment":{ "type":"string", "enum":[ "START", "END", "CENTER" ], "title":"Alignment" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.AltUri":{ "type":"object", "properties":{ "desktop":{ "type":"string", "maxLength":1000, "minLength":0 } }, "title":"AltUri" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.AspectMode":{ "type":"string", "enum":[ "COVER", "FIT" ], "title":"AspectMode" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BlockStyle":{ "type":"object", "properties":{ "backgroundColor":{ "type":"string" }, "separator":{ "type":"boolean" }, "separatorColor":{ "type":"string" } }, "title":"BlockStyle" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Box":{ "type":"object", "properties":{ "layout":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BoxLayout" }, "backgroundColor":{ "type":"string" }, "borderColor":{ "type":"string" }, "borderWidth":{ "type":"string" }, "cornerRadius":{ "type":"string" }, "width":{ "type":"string" }, "height":{ "type":"string" }, "flex":{ "type":"integer", "format":"int32", "maximum":20, "minimum":0 }, "margin":{ "type":"string" }, "spacing":{ "type":"string" }, "paddingAll":{ "type":"string" }, "paddingTop":{ "type":"string" }, "paddingBottom":{ "type":"string" }, "paddingStart":{ "type":"string" }, "paddingEnd":{ "type":"string" }, "offsetTop":{ "type":"string" }, "offsetBottom":{ "type":"string" }, "offsetStart":{ "type":"string" }, "offsetEnd":{ "type":"string" }, "position":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position" }, "action":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" }, "contents":{ "type":"array", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" } }, "type":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ComponentType" } }, "required":[ "layout" ], "title":"Box" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BoxLayout":{ "type":"string", "enum":[ "HORIZONTAL", "VERTICAL", "BASELINE" ], "title":"BoxLayout" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleContainer":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineNotificationContainer" }, { "type":"object", "properties":{ "size":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleSize" }, "direction":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleDirection" }, "header":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Box" }, "body":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Box" }, "footer":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Box" }, "style":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Style" }, "action":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" } } } ], "title":"BubbleContainer" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleDirection":{ "type":"string", "enum":[ "LEFT_TO_RIGHT", "RIGHT_TO_LEFT" ], "title":"BubbleDirection" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleSize":{ "type":"string", "enum":[ "NANO", "MICRO", "KILO", "MEGA", "GIGA" ], "title":"BubbleSize" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Button":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "action":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" }, "flex":{ "type":"integer", "format":"int32", "maximum":20, "minimum":0 }, "margin":{ "type":"string" }, "position":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position" }, "offsetTop":{ "type":"string" }, "offsetBottom":{ "type":"string" }, "offsetStart":{ "type":"string" }, "offsetEnd":{ "type":"string" }, "height":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Height" }, "style":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Style" }, "color":{ "type":"string" }, "gravity":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Gravity" } } } ], "required":[ "action" ], "title":"Button" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component":{ "type":"object", "discriminator":{ "propertyName":"type", "mapping":{ "BOX":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Box", "BUTTON":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Button", "ICON":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Icon", "IMAGE":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Image", "SEPARATOR":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Separator", "TEXT":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Text", "SPAN":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Span" } }, "properties":{ "type":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ComponentType" } }, "title":"Component" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ComponentType":{ "type":"string", "enum":[ "BOX", "BUTTON", "ICON", "IMAGE", "SEPARATOR", "TEXT", "SPAN" ], "title":"ComponentType" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DefaultSmsFailover":{ "type":"object", "description":"Failover SMS message to be sent if the original message could not be delivered.", "properties":{ "sender":{ "type":"string", "description":"The sender ID. It can be alphanumeric or numeric (e.g., `CompanyName`). Make sure you don't exceed [character limit](https://www.infobip.com/docs/sms/get-started#sender-names)." }, "text":{ "type":"string", "description":"Content of the message being sent." }, "validityPeriod":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ValidityPeriod" }, "regional":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RegionalOptions" } }, "required":[ "text" ], "title":"DefaultSmsFailover" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryDay":{ "type":"string", "description":"Days of the week which are included in the delivery time window. At least one day must be provided. Separate multiple days with a comma.", "enum":[ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ], "title":"DeliveryDay" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReport":{ "type":"object", "description":"Collection of reports, one per every message.", "properties":{ "bulkId":{ "type":"string", "description":"Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request." }, "price":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessagePrice" }, "status":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageStatus" }, "error":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageError" }, "messageId":{ "type":"string", "description":"Unique message ID." }, "to":{ "type":"string", "description":"Message destination address." }, "sender":{ "type":"string", "description":"The sender ID which can be alphanumeric or numeric (e.g., `CompanyName`)." }, "sentAt":{ "type":"string", "format":"date-time", "description":"Date and time when the message was sent. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ." }, "doneAt":{ "type":"string", "format":"date-time", "description":"Date and time when the Infobip services finished processing the message (i.e., delivered to the destination, network, etc.). Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ." }, "messageCount":{ "type":"integer", "format":"int32", "description":"The number of sent messages." }, "mccMnc":{ "type":"string", "description":"Mobile country and network codes." }, "callbackData":{ "type":"string", "description":"Callback data sent through ‛callbackData‛ field when sending message." }, "platform":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Platform" }, "campaignReferenceId":{ "type":"string", "description":"ID of a campaign that was sent in the message." } }, "title":"DeliveryReport" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReports":{ "type":"object", "properties":{ "results":{ "type":"array", "description":"Collection of reports, one per every message.", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReport" } } }, "title":"DeliveryReports" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryTime":{ "type":"object", "description":"The exact time of the day. The time is expressed in the UTC time zone.", "properties":{ "hour":{ "type":"integer", "format":"int32", "description":"Hour when the time window opens when used in the `from` property or closes when used in the `to` property.", "maximum":23, "minimum":0 }, "minute":{ "type":"integer", "format":"int32", "description":"Minute when the time window opens when used in the `from` property or closes when used in the `to` property.", "maximum":59, "minimum":0 } }, "required":[ "hour", "minute" ], "title":"DeliveryTime" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryTimeWindow":{ "type":"object", "description":"Sets specific message delivery window outside of which messages won't be delivered. Often, used when there are restrictions on when messages can be sent. The exact time of the day to start sending messages can be defined using the `from` property. The exact time of the day to end sending messages can be defined using the `to` property. Properties `from` and `to` should be both provided with the minimum 1 hour difference or omitted.", "properties":{ "days":{ "type":"array", "description":"Days of the week which are included in the delivery time window. At least one day must be provided. Separate multiple days with a comma.", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryDay" } }, "from":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryTime" }, "to":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryTime" } }, "required":[ "days" ], "title":"DeliveryTimeWindow" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Gravity":{ "type":"string", "enum":[ "TOP", "BOTTOM", "CENTER" ], "title":"Gravity" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Height":{ "type":"string", "enum":[ "SMALL", "MEDIUM" ], "title":"Height" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Icon":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "url":{ "type":"string" }, "margin":{ "type":"string" }, "position":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position" }, "offsetTop":{ "type":"string" }, "offsetBottom":{ "type":"string" }, "offsetStart":{ "type":"string" }, "offsetEnd":{ "type":"string" }, "size":{ "type":"string" }, "aspectRatio":{ "type":"string" } } } ], "required":[ "url" ], "title":"Icon" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Image":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "url":{ "type":"string" }, "flex":{ "type":"integer", "format":"int32", "maximum":20, "minimum":0 }, "margin":{ "type":"string" }, "position":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position" }, "offsetTop":{ "type":"string" }, "offsetBottom":{ "type":"string" }, "offsetStart":{ "type":"string" }, "offsetEnd":{ "type":"string" }, "align":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Alignment" }, "gravity":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Gravity" }, "size":{ "type":"string" }, "aspectRatio":{ "type":"string" }, "aspectMode":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.AspectMode" }, "backgroundColor":{ "type":"string" }, "action":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" } } } ], "required":[ "url" ], "title":"Image" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.IndiaDltOptions":{ "type":"object", "description":"Distributed Ledger Technology (DLT) specific parameters required for sending SMS to phone numbers registered in India.", "properties":{ "contentTemplateId":{ "type":"string", "description":"Registered DLT content template ID which matches message you are sending." }, "principalEntityId":{ "type":"string", "description":"Your assigned DLT principal entity ID." }, "telemarketerId":{ "type":"string", "description":"Your assigned Telemarketer ID. (required for Aggregators)" } }, "required":[ "principalEntityId" ], "title":"IndiaDltOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineMessage":{ "type":"object", "description":"An array of message objects of a single message or multiple messages sent under one bulk ID.", "properties":{ "sender":{ "type":"string", "description":"The sender ID. It can be alphanumeric or numeric (e.g., `CompanyName`). Make sure you don't exceed [character limit](https://www.infobip.com/docs/sms/get-started#sender-names)." }, "destinations":{ "type":"array", "description":"An array of destination objects for where messages are being sent. A valid destination is required.", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ToDestination" } }, "content":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOnOutboundContent" }, "options":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MsisdnMessageFailoverOptions" }, "webhooks":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Webhooks" } }, "required":[ "content", "destinations", "sender" ], "title":"LineMessage" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineMessageRequestOptions":{ "type":"object", "description":"Options applicable to all messages in the request.", "properties":{ "schedule":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RequestSchedulingSettings" } }, "title":"LineMessageRequestOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineNotificationContainer":{ "type":"object", "discriminator":{ "propertyName":"type", "mapping":{ "BUBBLE":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BubbleContainer" } }, "properties":{ "type":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineNotificationContainerType" } }, "title":"LineNotificationContainer" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineNotificationContainerType":{ "type":"string", "enum":[ "BUBBLE" ], "title":"LineNotificationContainerType" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOnOutboundContent":{ "type":"object", "description":"Message content.", "discriminator":{ "propertyName":"type", "mapping":{ "LINE_NOTIFICATION":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOutboundNotificationContent" } }, "properties":{ "type":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOnOutboundContentType" } }, "title":"LineOnOutboundContent" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOnOutboundContentType":{ "type":"string", "enum":[ "LINE_NOTIFICATION" ], "title":"LineOnOutboundContentType" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOutboundNotificationContent":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineOnOutboundContent" }, { "type":"object", "properties":{ "altText":{ "type":"string", "maxLength":400, "minLength":0 }, "contents":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineNotificationContainer" } } } ], "required":[ "altText", "contents" ], "title":"LineOutboundNotificationContent" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineRequest":{ "type":"object", "properties":{ "messages":{ "type":"array", "description":"An array of message objects of a single message or multiple messages sent under one bulk ID.", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineMessage" } }, "options":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.LineMessageRequestOptions" } }, "required":[ "messages" ], "title":"LineRequest" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageDeliveryReporting":{ "type":"object", "description":"Provides options for configuring the delivery report behavior.", "properties":{ "url":{ "type":"string", "description":"The URL on your call back server where a delivery report will be sent. If your URL becomes unavailable then the [retry cycle](https://www.infobip.com/docs/sms/sms-over-api#push-retry-cycle-notify-url) uses the following formula: `1min + (1min * retryNumber * retryNumber)`." }, "intermediateReport":{ "type":"boolean", "description":"The real-time intermediate delivery report containing GSM error codes, messages status, pricing, network and country codes, etc., which will be sent on your callback server. Defaults to `false`." }, "notify":{ "type":"boolean", "description":"Notify enables you to specify your preferences for receiving DLRs. If set to false, no DLR will be sent. Note: When no webhook is specified in the request and notify is set to 'true' or not defined, your Subscription settings will apply." } }, "title":"MessageDeliveryReporting" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageError":{ "type":"object", "description":"Indicates whether an [error](https://www.infobip.com/docs/essentials/response-status-and-error-codes#error-codes) occurred during the query execution.", "properties":{ "groupId":{ "type":"integer", "format":"int32", "description":"Error group ID." }, "groupName":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageErrorGroup" }, "id":{ "type":"integer", "format":"int32", "description":"Error ID." }, "name":{ "type":"string", "description":"[Error name](https://www.infobip.com/docs/essentials/response-status-and-error-codes#error-codes)." }, "description":{ "type":"string", "description":"Human-readable description of the error." }, "permanent":{ "type":"boolean", "description":"Indicates whether the error is recoverable or not." } }, "title":"MessageError" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageErrorGroup":{ "type":"string", "description":"Error group name that describes which category the error code belongs to.", "enum":[ "OK", "HANDSET_ERRORS", "USER_ERRORS", "OPERATOR_ERRORS" ], "title":"MessageErrorGroup" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageGeneralStatus":{ "type":"string", "description":"Status group name that describes which category the status code belongs to, i.e., [PENDING](https://www.infobip.com/docs/essentials/response-status-and-error-codes#pending-general-status-codes), [UNDELIVERABLE](https://www.infobip.com/docs/essentials/response-status-and-error-codes#undeliverable-general-status-codes), [DELIVERED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#delivered-general-status-codes), [EXPIRED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#expired-general-status-codes), [REJECTED](https://www.infobip.com/docs/essentials/response-status-and-error-codes#rejected-general-status-codes).", "enum":[ "ACCEPTED", "PENDING", "UNDELIVERABLE", "DELIVERED", "EXPIRED", "REJECTED" ], "title":"MessageGeneralStatus" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessagePrice":{ "type":"object", "description":"Sent message price.", "properties":{ "pricePerMessage":{ "type":"number", "description":"Price per one message." }, "currency":{ "type":"string", "description":"The currency in which the price is expressed." } }, "title":"MessagePrice" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageResponseDetails":{ "type":"object", "description":"Other details of the message.", "title":"MessageResponseDetails" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageResponseMessageResponseDetails":{ "type":"object", "description":"An array of message objects of a single message or multiple messages sent under one bulk ID.", "properties":{ "messageId":{ "type":"string", "description":"Unique message ID. If not provided, it will be auto-generated and returned in the API response." }, "status":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageStatus" }, "destination":{ "type":"string", "description":"The destination address of the message, i.e., its recipient." }, "details":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageResponseDetails" } }, "title":"MessageResponseMessageResponseDetails" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageStatus":{ "type":"object", "description":"Indicates the [status](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes) of the message and how to recover from an error should there be any.", "properties":{ "groupId":{ "type":"integer", "format":"int32", "description":"Status group ID." }, "groupName":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageGeneralStatus" }, "id":{ "type":"integer", "format":"int32", "description":"Status code ID." }, "name":{ "type":"string", "description":"[Status code](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes) name." }, "description":{ "type":"string", "description":"Human-readable description of the status." }, "action":{ "type":"string", "description":"Action to take to recover from the error." } }, "title":"MessageStatus" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MsisdnMessageFailoverOptions":{ "type":"object", "description":"Message options.", "properties":{ "platform":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Platform" }, "validityPeriod":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ValidityPeriod" }, "deliveryTimeWindow":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryTimeWindow" }, "campaignReferenceId":{ "type":"string", "description":"ID that allows you to track, analyze, and show an aggregated overview and the performance of individual campaigns per sending channel.", "maxLength":255, "minLength":0 }, "smsFailover":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DefaultSmsFailover" } }, "title":"MsisdnMessageFailoverOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Platform":{ "type":"object", "description":"Platform options. For more details, see [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).", "properties":{ "entityId":{ "type":"string", "description":"Used when specifying an entity in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).", "maxLength":255, "minLength":0 }, "applicationId":{ "type":"string", "description":"Used when specifying an application in outbound send requests. It is also returned in notification events. For detailed usage, refer to the [documentation](https://www.infobip.com/docs/cpaas-x/application-and-entity-management).", "maxLength":255, "minLength":0 } }, "title":"Platform" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position":{ "type":"string", "enum":[ "RELATIVE", "ABSOLUTE" ], "title":"Position" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.PostbackAction":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" }, { "type":"object", "properties":{ "label":{ "type":"string", "maxLength":20, "minLength":0 }, "data":{ "type":"string", "maxLength":1000, "minLength":0 }, "altUri":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.AltUri" } } } ], "required":[ "data", "label" ], "title":"PostbackAction" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RecipientType":{ "type":"string", "description":"Recipient Type must be `TACIR` or `BIREYSEL`.", "enum":[ "BIREYSEL", "TACIR" ], "title":"RecipientType" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RegionalOptions":{ "type":"object", "description":"Region-specific parameters, often imposed by local laws. Use this, if country or region that you are sending an SMS to requires additional information.", "properties":{ "indiaDlt":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.IndiaDltOptions" }, "turkeyIys":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TurkeyIysOptions" }, "southKorea":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SouthKoreaOptions" } }, "title":"RegionalOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RequestSchedulingSettings":{ "type":"object", "description":"Options for scheduling a message.", "properties":{ "bulkId":{ "type":"string", "description":"Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. If not provided, it will be auto-generated and returned in the API response.", "maxLength":100, "minLength":0 }, "sendAt":{ "type":"string", "format":"date-time", "description":"Date and time when the message is to be sent. Used for scheduled messages. Has the following format: `yyyy-MM-dd'T'HH:mm:ss.SSSZ`, and can only be scheduled for no later than 180 days in advance." }, "sendingSpeedLimit":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SendingSpeedLimit" } }, "title":"RequestSchedulingSettings" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ResponseEnvelopeMessageResponseMessageResponseDetails":{ "type":"object", "properties":{ "bulkId":{ "type":"string", "description":"Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request. If not provided, it will be auto-generated and returned in the API response. Typically used for fetching delivery reports and message logs." }, "messages":{ "type":"array", "description":"An array of message objects of a single message or multiple messages sent under one bulk ID.", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageResponseMessageResponseDetails" } } }, "required":[ "messages" ], "title":"ResponseEnvelopeMessageResponseMessageResponseDetails" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SendingSpeedLimit":{ "type":"object", "description":"Limits the send speed when sending messages in bulk to deliver messages over a longer period of time. You may wish to use this to allow your systems or agents to handle large amounts of incoming traffic, e.g., if you are expecting recipients to follow through with a call-to-action option from a message you sent. Not setting a send speed limit can overwhelm your resources with incoming traffic.", "properties":{ "amount":{ "type":"integer", "format":"int32", "description":"The number of messages to be sent per timeUnit. By default, the system sends messages as fast as the infrastructure allows. Use this parameter to adapt sending capacity to your needs. The system is only able to work against its maximum capacity for ambitious message batches." }, "timeUnit":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SpeedLimitTimeUnit" } }, "required":[ "amount" ], "title":"SendingSpeedLimit" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Separator":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "margin":{ "type":"string" }, "color":{ "type":"string" } } } ], "title":"Separator" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SouthKoreaOptions":{ "type":"object", "description":"Use case dependent parameters for sending SMS to phone numbers registered in South Korea.", "properties":{ "title":{ "type":"string", "description":"Title of the message.", "maxLength":66, "minLength":0 }, "resellerCode":{ "type":"integer", "format":"int32", "description":"Reseller identification code: 9-digit registration number in the business registration certificate for South Korea. Resellers should submit this when sending." } }, "title":"SouthKoreaOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Span":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "text":{ "type":"string" }, "color":{ "type":"string" }, "size":{ "type":"string" }, "weight":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Weight" }, "style":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TextStyle" }, "decoration":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TextDecoration" } } } ], "required":[ "text" ], "title":"Span" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.SpeedLimitTimeUnit":{ "type":"string", "default":"MINUTE", "description":"The time unit to define when setting a messaging speed limit. Defaults to `MINUTE`.", "enum":[ "MINUTE", "HOUR", "DAY" ], "title":"SpeedLimitTimeUnit" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Style":{ "type":"object", "properties":{ "header":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BlockStyle" }, "body":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BlockStyle" }, "footer":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.BlockStyle" } }, "title":"Style" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Text":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Component" }, { "type":"object", "properties":{ "text":{ "type":"string" }, "contents":{ "type":"array", "items":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Span" } }, "flex":{ "type":"integer", "format":"int32", "maximum":20, "minimum":0 }, "margin":{ "type":"string" }, "size":{ "type":"string" }, "align":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Alignment" }, "gravity":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Gravity" }, "wrap":{ "type":"boolean" }, "maxLines":{ "type":"integer", "format":"int32", "minimum":0 }, "color":{ "type":"string" }, "weight":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Weight" }, "position":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Position" }, "offsetTop":{ "type":"string" }, "offsetBottom":{ "type":"string" }, "offsetStart":{ "type":"string" }, "offsetEnd":{ "type":"string" }, "action":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" } } } ], "title":"Text" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TextDecoration":{ "type":"string", "enum":[ "NONE", "UNDERLINE", "LINE_THROUGH" ], "title":"TextDecoration" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TextStyle":{ "type":"string", "enum":[ "NORMAL", "ITALIC" ], "title":"TextStyle" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ToDestination":{ "type":"object", "description":"An array of destination objects for where messages are being sent. A valid destination is required.", "properties":{ "to":{ "type":"string", "description":"The destination address of the message." }, "messageId":{ "type":"string", "description":"The ID that uniquely identifies the message sent.", "maxLength":200, "minLength":0 } }, "required":[ "to" ], "title":"Destination" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.TurkeyIysOptions":{ "type":"object", "description":"IYS regulations specific parameters required for sending promotional SMS to phone numbers registered in Turkey.", "properties":{ "brandCode":{ "type":"integer", "format":"int32", "description":"Brand code is an ID of the company based on a company VAT number. If not provided in request, default value is used from your Infobip account." }, "recipientType":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.RecipientType" } }, "required":[ "recipientType" ], "title":"TurkeyIysOptions" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.UriAction":{ "type":"object", "allOf":[ { "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Action" }, { "type":"object", "properties":{ "label":{ "type":"string", "maxLength":20, "minLength":0 }, "uri":{ "type":"string", "maxLength":1000, "minLength":0 }, "altUri":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.AltUri" } } } ], "required":[ "label", "uri" ], "title":"UriAction" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ValidityPeriod":{ "type":"object", "description":"Message validity period. Once expired, the message won't be sent. Validity period longer than 48h is not supported. If exceeded, it will be automatically set to 48h.", "properties":{ "amount":{ "type":"integer", "format":"int32", "description":"Message validity period's value. If `timeUnit` is not set, it will default to `MINUTES`." }, "timeUnit":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ValidityPeriodTimeUnit" } }, "required":[ "amount" ], "title":"ValidityPeriod" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.ValidityPeriodTimeUnit":{ "type":"string", "default":"MINUTES", "description":"Message validity period time unit.", "enum":[ "SECONDS", "MINUTES", "HOURS" ], "title":"ValidityPeriodTimeUnit" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Webhooks":{ "type":"object", "description":"Provides options for configuring message webhooks.", "properties":{ "delivery":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.MessageDeliveryReporting" }, "contentType":{ "type":"string", "description":"Preferred delivery report content type, `application/json` or `application/xml`." }, "callbackData":{ "type":"string", "description":"Additional data that can be used for identifying, managing, or monitoring a message. Data included here will also be automatically included in the message Delivery Report. The maximum value is 4000 characters.", "maxLength":4000, "minLength":0 } }, "title":"Webhooks" }, "267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.Weight":{ "type":"string", "enum":[ "BOLD", "REGULAR" ], "title":"Weight" }, "ApiError":{ "type":"object", "properties":{ "errorCode":{ "type":"string", "description":"An error code uniquely identifying the error case." }, "description":{ "type":"string", "description":"A detailed description of an error." }, "action":{ "type":"string", "description":"An action that should be taken to recover from the error." }, "violations":{ "type":"array", "description":"List of violations that caused the error.", "items":{ "$ref":"#/components/schemas/ApiErrorViolation" } }, "resources":{ "type":"array", "description":"List of available resources to recover from the error.", "items":{ "$ref":"#/components/schemas/ApiErrorResource" } } }, "required":[ "action", "description", "errorCode", "resources", "violations" ], "title":"ApiError" }, "ApiErrorResource":{ "type":"object", "description":"List of available resources to recover from the error.", "properties":{ "name":{ "type":"string", "description":"Resource name." }, "url":{ "type":"string", "description":"Resource URL." } }, "title":"ApiErrorResource" }, "ApiErrorViolation":{ "type":"object", "description":"List of violations that caused the error.", "properties":{ "property":{ "type":"string", "description":"Request property that caused the error." }, "violation":{ "type":"string", "description":"Detailed violation description." } }, "title":"ApiErrorViolation" } }, "responses":{ "ApiError401":{ "description":"Unauthorized", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":{ "errorCode":"E401", "description":"The request lacks valid authentication credentials for the requested resource.", "action":"Check the resources and adjust authentication credentials.", "violations":[], "resources":[ { "name":"API Authentication", "url":"https://www.infobip.com/docs/essentials/api-authentication" } ] } }, "application/xml":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":"\n E401\n The request lacks valid authentication credentials for the requested resource.\n Check the resources and adjust authentication credentials.\n \n \n \n API Authentication\n https://www.infobip.com/docs/essentials/api-authentication\n \n \n\n" } } }, "ApiError403":{ "description":"Forbidden", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":{ "errorCode":"E403", "description":"Insufficient permissions to access the requested resource.", "action":"Repeat the request with new or different credentials.", "violations":[], "resources":[ { "name":"API Scopes", "url":"https://www.infobip.com/docs/essentials/api-essentials/api-authorization#api-scopes" } ] } }, "application/xml":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":"\n E403\n Insufficient permissions to access the requested resource.\n Repeat the request with new or different credentials.\n \n \n \n API Scopes\n https://www.infobip.com/docs/essentials/api-essentials/api-authorization#api-scopes\n \n \n\n" } } }, "ApiError500":{ "description":"Internal Server Error", "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":{ "errorCode":"E500", "description":"Something went wrong.", "action":"Contact the support.", "violations":[], "resources":[] } }, "application/xml":{ "schema":{ "$ref":"#/components/schemas/ApiError" }, "example":"\n E500\n Something went wrong.\n Contact the support.\n \n \n\n" } } } }, "parameters":{}, "examples":{}, "requestBodies":{}, "headers":{}, "securitySchemes":{ "APIKeyHeader":{ "type":"apiKey", "description":"This is the most secure authorization type and the one with the most flexibility.\n\nAPI keys can be generated by calling the dedicated API method. Furthermore, API keys can have a limited scope and cover only some API methods. Lastly, they can\nbe revoked at any time. This range of possibilities makes API keys well suited for separating the API access rights across multiple applications or use cases.\nFinally, the loss of an API key is easily manageable.\n\nYou can manage your API keys from [GUI](https://portal.infobip.com/settings/accounts/api-keys), or programmatically\nwith [dedicated API](#platform-&-connectivity/settings).\n\nAPI key Authorization header example:\n\n```shell\nAuthorization: App 003026bbc133714df1834b8638bb496e-8f4b3d9a-e931-478d-a994-28a725159ab9\n```\n", "name":"Authorization", "in":"header" }, "Basic":{ "type":"http", "description":"Basic authorization type can be used in situations when the API key is not available. For example, API methods for generating API keys should be authenticated\nwith the Basic type.\n\nIn this case, the credentials included in the Authorization header should be a Base64 encoded username and password combination. More formally, basic\nauthentication header can be constructed in three steps:\n\n* Username and password are concatenated using the colon `(:)` as a separator `username:password`.\n* The resulting string is encoded using the [RFC2045-MIME](https://www.ietf.org/rfc/rfc2045.txt) variant of Base64.\n* Encoded string is added as credentials after the `\"Basic \"` type.\n\nExample:\n\n```shell\nUsername: \"Aladdin\"\nPassword: \"openSesame\"\n\nConcatenated string: \"Aladdin:openSesame\"\n\nBase64 encoded string: \"QWxhZGRpbjpvcGVuU2VzYW1l\"\n\nAuthorization header: \"Basic QWxhZGRpbjpvcGVuU2VzYW1l\"\n```\n\n> **Implementation detail**: Base64 encoding is a standard and many available programming languages and frameworks provide convenient methods for encoding\n> strings.\n", "scheme":"basic" }, "IBSSOTokenHeader":{ "type":"apiKey", "description":"This authorization type is suited for situations when you do not want to store Infobip credentials in your own app. Instead, your users will input their Infobip\ncredentials every time they access your application and the application will use those credentials to create a session. From then on, the session token can be\nused to authenticate subsequent API requests. Note that the session will expire automatically after a predefined period of inactivity, and can also be manually\nterminated by making an appropriate API call.\n\nYou can find more details on the creation and behavior of the session at\nthe [dedicated documentation page](#platform-connectivity/account-management/create-session).\n\nAfter obtaining the session token by calling the above-referenced API method you can include it in the Authorization header like this:\n\n```shell\nAuthorization: IBSSO 2f9b4d31-2d0d-49a8-85f0-9b862bdca394\n```\n", "name":"Authorization", "in":"header" }, "OAuth2":{ "type":"oauth2", "description":"Similarly to the IBSSO Token authentication you can use OAuth 2.0 bearer token with Infobip serving both as resource and authorization server. You can obtain\nthe access token using the client credentials grant from `auth/1/oauth2/token` endpoint. It will provide you with your access token, and its expiration period.\nYou can use the token to authorize your API calls until it expires. You can find out more about the process in\nthe [official specification](https://tools.ietf.org/html/rfc6749#section-4.4).\n\nYou can include your access token in the Authorization HTTP request header like this:\n\n```http\nAuthorization: Bearer \n```", "flows":{ "clientCredentials":{ "tokenUrl":"https://api.infobip.com/auth/1/oauth2/token", "scopes":{} } } } }, "links":{}, "callbacks":{} }, "webhooks":{ "receive-outbound-line-message-delivery-reports":{ "post":{ "tags":[ "channels", "line", "line-message-status-reports" ], "summary":"Receive LON delivery reports", "description":"For each message that you send out, we can send you a delivery report. For this to work you need to have an endpoint to forward the reports to. Please specify the endpoint per each message via the `webhooks > delivery > url` parameter. Alternatively, you can provide the endpoint’s URL to Customer support and they will set it up for you. Contact support@infobip.com if you require help.", "externalDocs":{ "description":"Learn more about LINE channel and use cases", "url":"https://www.infobip.com/docs/line" }, "operationId":"receive-outbound-line-message-delivery-reports", "requestBody":{ "content":{ "application/json":{ "schema":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReports" } }, "application/xml":{ "schema":{ "$ref":"#/components/schemas/267b6ecf9b18ace076c5287f2f55ab493690ff43a19cc6531a331c0c908f8fd5.DeliveryReports" } } } }, "responses":{ "200":{ "description":"Your server returns this code if it accepts the callback." } } } } } }