> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beem.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# Receive inbound message or DLR

> Webhook your application must implement. The Messaging Platform POSTs inbound mobile-originated messages and delivery reports to your configured callback URL. Replace the server URL with your own HTTPS endpoint.



## OpenAPI

````yaml /openapi/multicountry-sms.json post /callback
openapi: 3.0.3
info:
  title: Beem Multicountry SMS & SMPP API
  version: 1.0.0
  description: >-
    HTTP API for sending international SMS messages via the Beem Messaging
    Platform, checking account balance, and receiving inbound messages and
    delivery reports via callback webhooks. SMPP integration is documented in
    the guides.
  contact:
    name: Beem
    url: https://beem.africa
    email: support@beem.africa
servers:
  - url: https://api.blsmsgw.com:8443
    description: Messaging Platform — send API
security: []
tags: []
paths:
  /callback:
    post:
      summary: Receive inbound message or DLR
      description: >-
        Webhook your application must implement. The Messaging Platform POSTs
        inbound mobile-originated messages and delivery reports to your
        configured callback URL. Replace the server URL with your own HTTPS
        endpoint.
      operationId: receiveCallback
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/InboundCallback'
      responses:
        '200':
          description: Acknowledge receipt. Response body should be empty.
      servers:
        - url: https://example.com
          description: Your callback server — replace with your URL
components:
  schemas:
    InboundCallback:
      type: object
      description: Parameters sent by MP for inbound MO messages or delivery reports.
      properties:
        ID:
          type: string
          description: Original message ID.
        DLRID:
          type: string
          description: Message ID the DLR refers to.
        SOURCEADDR:
          type: string
          description: Sender address.
        SOURCEADDRTON:
          type: string
        SOURCEADDRNPI:
          type: string
        DESTADDR:
          type: string
          description: Destination address.
        MESSAGE:
          type: string
          description: Message content or status text.
        STATUS:
          type: string
          description: >-
            DLR status: 1 Delivered, 2 In process, 3 Failed, 4 Deleted, 5
            Expired, 6 Rejected, 7 Canceled, 8 Queued, 9 Orphaned, 10 Relayed,
            11 Unknown.
        MSGTYPE:
          type: string
        KEYWORD:
          type: string
          description: First word of inbound message.
        CHARCODE:
          type: string
        VP:
          type: string
          description: Validity period in seconds.
        CONCATSMSREF:
          type: string
        CONCATSMSSEQ:
          type: string
        CONCATSMSMAX:
          type: string

````