---
title: "Get inbound configurations"
method: GET
path: "/resource-management/1/inbound-message-configurations"
tags: ["platform", "resources", "resource-management"]
---

# Get inbound configurations

`GET /resource-management/1/inbound-message-configurations`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/resource-management/1/inbound-message-configurations`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Get all configurations using a filter.<br/>
If you want configuration for a specific number or resource, then one of the following parameters is required: <code>number, numberKey, resource</code> or <code>resourceKey</code>.<br/>
If you are using <code>configurationKey</code> none of previously mentioned parameters are needed.

## Query parameters

- `configurationKey` string: Unique ID of configuration.
- `number` string
- `numberKey` string: Unique ID of a number.
- `resource` string
- `resourceKey` string: Unique ID of a resource.
- `keyword` string: Configuration keyword.
- `channel` 'SMS' | 'MMS' | 'WHATSAPP' | 'RCS' | 'VIBER_BM' | 'APPLE_MB' | 'LINE_OA' | 'KAKAO_SANGDAM' | 'MESSENGER' | 'INSTAGRAM_DM' | 'ZALO_ZNS' | 'TELEGRAM' | 'VIBER_BOT' | 'EMAIL' | 'ZALO_FOLLOWER' | 'OPEN_CHANNEL' | 'TIKTOK_BM', required: Channel type.
- `countryCode` string: Country code in two-letter ISO standard. Required for identifying country specific resources (for instance, short code number types).

## Response `200`

OK

- 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553MoConfigurationResponse[]
  - `configurationKey` string, required: The key of a stored configuration.
  - `channel` 'SMS' | 'MMS' | 'WHATSAPP' | 'RCS' | 'VIBER_BM' | 'APPLE_MB' | 'LINE_OA' | 'KAKAO_SANGDAM' | 'MESSENGER' | 'INSTAGRAM_DM' | 'ZALO_ZNS' | 'TELEGRAM' | 'VIBER_BOT' | 'EMAIL' | 'ZALO_FOLLOWER' | 'OPEN_CHANNEL' | 'TIKTOK_BM': Channel type.
  - `keyword` string: Configuration keyword.
  - `username` string: Configuration username.
  - `platform` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553PlatformDocs: Platform applicationId and entityId to apply to inbound messages that pair to this configuration. If not provided, or if set to default values (applicationId = default and entityId = null), values from the associated number/resource will be used.
    - `applicationId` string: Platform applicationId.
    - `entityId` string: Platform entityId.
  - `forwarding` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553MoActionDocs: Forwarding MO action.
    - `type` 'PULL' | 'HTTP_FORWARD' | 'SMPP_FORWARD' | 'MAIL_FORWARD' | 'NO_ACTION' | 'BLOCK' | 'AUTORESPONSE' | 'USSD' | 'SEND_BULK_MT' | 'EMAIL_TO_SMS_FORWARD' | 'CNS_FWD' | 'USE_CONVERSATIONS' | 'FORWARD_TO_PSTN' | 'FORWARD_TO_IP' | 'FORWARD_TO_IVR' | 'VOICE_NUMBER_MASKING' | 'VOICE_CALL_DROP' | 'FORWARD_TO_WEBRTC' | 'VOICE_FORWARD_TO_CONVERSATIONS' | 'VOICE_FORWARD_TO_CONVERSATIONS_WITH_FLOW' | 'CALL_FORWARD_TO_APPLICATION' | 'FORWARD_TO_SUBSCRIPTION' | 'FORWARD_TO_CALL_ROUTING' | 'USE_ANSWERS' | 'VOICE_FORWARD_TO_ANSWERS' | 'VOICE_FORWARD_TO_FLOW' | 'VOICE_FORWARD_TO_FLOW_WITH_CONVERSATIONS' | 'FORWARD_TO_OPERATOR_CONNECT' | 'FORWARD_TO_EXTERNAL_INTEGRATION' | 'FORWARD_TO_AI_AGENT' | 'FORWARD_TO_MARKUP_LANGUAGE' | 'OTHER', required: Defines action type. It is not possible to create new action type.
  - `conversations` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553UseConversations: Used for forwarding messages to Conversations service.
    - `enabled` boolean, required: Flag which indicates if this action should be enabled. If set to false, the effect will be the same as adding the conversations to unset which will remove the object.
  - `answers` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553UseAnswers: Used for forwarding messages to Answers service.
    - `enabled` boolean, required: Flag which indicates if this action should be enabled. If set to false, the effect will be the same as adding the answers to unset which will remove the object.
  - `autoResponse` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553AutoResponseActionV2Response: Auto-response action configuration.
    - `message` string, required: Text that will be sent as a response message.
    - `sender` string: If set, it will override the sender of the message in autoresponse sent to the user.
    - `deliveryTimeWindow` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553DeliveryTimeWindowResponse: Used to specify a time-window in which a response message is allowed to be sent. If not defined there is no limitation when message will be sent.
      - `from` string, required: Exact time of day in which the sending can start. Consists of hour and minute properties, both mandatory. Time is expressed in the UTC time zone. Formatted as <code>HH:mm</code>.
      - `to` string, required: Exact time of day in which the sending will end. Consists of an hour and minute properties, both mandatory. Time is expressed in the UTC time zone. Formatted as <code>HH:mm</code>.
      - `days` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553DayOfWeek[], required: Days which are included in the delivery time window.
      - `deliveryTimeZone` 'USER_TIME_ZONE' | 'DESTINATION_TIME_ZONE' | 'CUSTOM_NOT_EDITABLE', required: Sending time zone. If the value is <code>CUSTOM_NOT_EDITABLE</code>, then the value is not manageable by API.
  - `blockListConfiguration` 7c77a2c703ce12a601f120565936de62cf48d1baf9232d5411f82fc339353553BlockListConfigurationResponse: Whitelist or blacklist the traffic of MT messages.
    - `type` 'BLOCK' | 'UNBLOCK', required: The type of block configuration. Defines whether you are configuring blocking (blacklisting) or unblocking (whitelisting) configuration.
    - `level` 'FROM_SENDER' | 'FROM_ANY_SENDER' | 'CUSTOM_NOT_EDITABLE', required: The level of block configuration. If the value is <code>CUSTOM_NOT_EDITABLE</code>, then the value is not manageable by API.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)
