Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
145 changes: 122 additions & 23 deletions bandwidth.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5552,6 +5552,10 @@ components:
example: GET
lookupErrorSchema:
type: object
required:
- code
- type
- description
properties:
code:
type: string
Expand Down Expand Up @@ -5699,6 +5703,39 @@ components:
type: array
items:
$ref: '#/components/schemas/lookupErrorSchema'
rcsErrorEnum:
type: string
description: >-
[RCS-Only](#section/RCS-Only). Error encountered during RCS capability
lookup. Appears as the `code` field in the top-level `errors` array.


**RCS service pass-through codes:**

- `REQUEST_FAILED`: The RCS service returned this error code.

- `UNKNOWN_CODE`: The RCS service returned this error code.

- `INVALID_DESTINATION_ADDRESS`: The RCS service returned this error
code.

- `UNKNOWN_STATUS: <code>`: The RCS service returned an unrecognized
status code, where `<code>` is the raw value.


**Service-level errors:**

- `MISSING_FROM_RESPONSE`: The phone number was absent from the RCS
service response.

- `RCS_SERVICE_UNAVAILABLE`: An exception was thrown during the async
RCS service call.

- `RCS_SERVICE_DISABLED`: RCS lookup is disabled in configuration.

- `EMPTY_RESPONSE`: The RCS service returned a null or empty response
body.
example: RCS_SERVICE_UNAVAILABLE
lookupResult:
type: object
description: Carrier information results for the specified telephone number.
Expand Down Expand Up @@ -5757,13 +5794,21 @@ components:
format: date
description: >-
[DNI-Only](#section/DNI-Only). The date bandwidth last received
delivery status information for this phone number.
delivery status information for this phone number.

Use this field to understand how up-to-date the
`latestMessageDeliveryStatus` is.

Value resets every time the `latestMessageDeliveryStatus` changes.
example: '2025-06-21'
rcsEnabled:
type: boolean
description: >
[RCS-Only](#section/RCS-Only). Indicates whether the phone number is
capable of receiving RCS messages. Value will be null if account has
RCS, but no value was returned. Absent when account does not have
RCS.
example: true
accountId1:
type: string
description: User's account ID.
Expand Down Expand Up @@ -7149,6 +7194,10 @@ components:
$ref: '#/components/examples/lookupCompleteWithDniExample'
lookupCompleteExample:
$ref: '#/components/examples/lookupCompleteExample'
lookupCompleteWithRcsExample:
$ref: '#/components/examples/lookupCompleteWithRcsExample'
lookupCompleteWithRcsErrorExample:
$ref: '#/components/examples/lookupCompleteWithRcsErrorExample'
lookupPartialExample:
$ref: '#/components/examples/lookupPartialExample'
lookupFailedExample:
Expand All @@ -7160,8 +7209,8 @@ components:
schema:
$ref: '#/components/schemas/createAsyncBulkLookupResponse'
examples:
lookupInProgressExample:
$ref: '#/components/examples/lookupInProgressExample'
lookupAcceptedExample:
$ref: '#/components/examples/lookupAcceptedExample'
getAsyncBulkLookupResponse:
description: OK
content:
Expand Down Expand Up @@ -8049,25 +8098,32 @@ components:
phoneNumbers:
- '+19196104423'
- '+19196104424'
lookupInProgressExample:
summary: Numbers Lookup In Progress
lookupAcceptedExample:
summary: Numbers Lookup Accepted
value:
links:
- href: href
rel: rel
- href: >-
/accounts/9912345/phoneNumberLookup/bulk/004223a0-8b17-41b1-bf81-20732adf5590
rel: createdRequest
method: GET
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: IN_PROGRESS
results: []
errors: []
lookupInProgressExample:
summary: Numbers Lookup In Progress
value:
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: IN_PROGRESS
results: []
errors: []
lookupFailedExample:
summary: Numbers Lookup Failed
value:
links:
- href: href
rel: rel
method: GET
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: FAILED
Expand All @@ -8084,10 +8140,7 @@ components:
lookupPartialExample:
summary: Numbers Lookup Partial Complete
value:
links:
- href: href
rel: rel
method: GET
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: PARTIAL_COMPLETE
Expand All @@ -8114,10 +8167,7 @@ components:
lookupCompleteExample:
summary: Numbers Lookup Complete (without DNI)
value:
links:
- href: href
rel: rel
method: GET
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: COMPLETE
Expand All @@ -8136,10 +8186,7 @@ components:
lookupCompleteWithDniExample:
summary: Numbers Lookup Complete (with DNI)
value:
links:
- href: href
rel: rel
method: GET
links: []
data:
requestId: 20732adf-bf81-8b17-41b1-004223a05590
status: COMPLETE
Expand Down Expand Up @@ -8177,6 +8224,58 @@ components:
deactivationEvent: DEACTIVATED
latestMessageDeliveryStatus: NOT_ENABLED
errors: []
lookupCompleteWithRcsExample:
summary: Numbers Lookup Complete (with RCS)
value:
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: COMPLETE
results:
- phoneNumber: '+10072904497'
lineType: MOBILE
messagingProvider: Verizon Wireless
voiceProvider: Verizon Wireless
countryCodeA3: USA
rcsEnabled: true
- phoneNumber: '+10072904498'
lineType: MOBILE
messagingProvider: T-Mobile USA
voiceProvider: T-Mobile USA
countryCodeA3: USA
rcsEnabled: false
errors: []
lookupCompleteWithRcsErrorExample:
summary: Numbers Lookup Complete (with RCS error)
value:
links: []
data:
requestId: 004223a0-8b17-41b1-bf81-20732adf5590
status: COMPLETE
results:
- phoneNumber: '+10072904497'
lineType: MOBILE
messagingProvider: Verizon Wireless
voiceProvider: Verizon Wireless
countryCodeA3: USA
- phoneNumber: '+10072904498'
lineType: MOBILE
messagingProvider: T-Mobile USA
voiceProvider: T-Mobile USA
countryCodeA3: USA
errors:
- code: RCS_SERVICE_UNAVAILABLE
type: rcs-error
description: An exception was thrown during the async RCS service call.
meta:
phoneNumbers:
- '+10072904497'
- code: MISSING_FROM_RESPONSE
type: rcs-error
description: The phone number was absent from the RCS service response.
meta:
phoneNumbers:
- '+10072904498'
badRequestExample:
summary: Example Bad Request Error
value:
Expand Down
6 changes: 3 additions & 3 deletions docs/LookupErrorSchema.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@

| Name | Type | Description | Notes |
| ---- | ---- | ----------- | ----- |
| **code** | **String** | Validation error code | [optional] |
| **description** | **String** | Description of validation error | [optional] |
| **type** | **String** | Type of validation error | [optional] |
| **code** | **String** | Validation error code | |
| **description** | **String** | Description of validation error | |
| **type** | **String** | Type of validation error | |
| **meta** | [**LookupErrorSchemaMeta**](LookupErrorSchemaMeta.md) | | [optional] |

## Example
Expand Down
6 changes: 4 additions & 2 deletions docs/LookupResult.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@
| **deactivation_event** | [**DeactivationEventEnum**](DeactivationEventEnum.md) | | [optional] |
| **latest_message_delivery_status** | [**LatestMessageDeliveryStatusEnum**](LatestMessageDeliveryStatusEnum.md) | | [optional] |
| **initial_message_delivery_status_date** | **Date** | [DNI-Only](#section/DNI-Only). The date the phone number entered the status described in &#x60;latestMessageDeliveryStatus&#x60;. Think of this as the \&quot;start time\&quot; for that status. Value resets every time the &#x60;latestMessageDeliveryStatus&#x60; changes. | [optional] |
| **latest_message_delivery_status_date** | **Date** | [DNI-Only](#section/DNI-Only). The date bandwidth last received delivery status information for this phone number. Use this field to understand how up-to-date the &#x60;latestMessageDeliveryStatus&#x60; is. Value resets every time the &#x60;latestMessageDeliveryStatus&#x60; changes. | [optional] |
| **latest_message_delivery_status_date** | **Date** | [DNI-Only](#section/DNI-Only). The date bandwidth last received delivery status information for this phone number. Use this field to understand how up-to-date the &#x60;latestMessageDeliveryStatus&#x60; is. Value resets every time the &#x60;latestMessageDeliveryStatus&#x60; changes. | [optional] |
| **rcs_enabled** | **Boolean** | [RCS-Only](#section/RCS-Only). Indicates whether the phone number is capable of receiving RCS messages. Value will be null if account has RCS, but no value was returned. Absent when account does not have RCS. | [optional] |

## Example

Expand All @@ -32,7 +33,8 @@ instance = Bandwidth::LookupResult.new(
deactivation_event: null,
latest_message_delivery_status: null,
initial_message_delivery_status_date: Fri Jun 20 00:00:00 UTC 2025,
latest_message_delivery_status_date: Sat Jun 21 00:00:00 UTC 2025
latest_message_delivery_status_date: Sat Jun 21 00:00:00 UTC 2025,
rcs_enabled: true
)
```

2 changes: 1 addition & 1 deletion docs/RbmActionBase.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ require 'bandwidth-sdk'
instance = Bandwidth::RbmActionBase.new(
type: null,
text: Hello world,
postback_data: [B@764a3867
postback_data: [B@4693d24f
)
```

2 changes: 1 addition & 1 deletion docs/RbmSuggestionResponse.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ require 'bandwidth-sdk'

instance = Bandwidth::RbmSuggestionResponse.new(
text: Yes, I would like to proceed,
postback_data: [B@764a3867
postback_data: [B@4693d24f
)
```

51 changes: 51 additions & 0 deletions lib/bandwidth-sdk/models/lookup_error_schema.rb
Original file line number Diff line number Diff line change
Expand Up @@ -80,14 +80,20 @@ def initialize(attributes = {})

if attributes.key?(:'code')
self.code = attributes[:'code']
else
self.code = nil
end

if attributes.key?(:'description')
self.description = attributes[:'description']
else
self.description = nil
end

if attributes.key?(:'type')
self.type = attributes[:'type']
else
self.type = nil
end

if attributes.key?(:'meta')
Expand All @@ -100,16 +106,61 @@ def initialize(attributes = {})
def list_invalid_properties
warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
invalid_properties = Array.new
if @code.nil?
invalid_properties.push('invalid value for "code", code cannot be nil.')
end

if @description.nil?
invalid_properties.push('invalid value for "description", description cannot be nil.')
end

if @type.nil?
invalid_properties.push('invalid value for "type", type cannot be nil.')
end

invalid_properties
end

# Check to see if the all the properties in the model are valid
# @return true if the model is valid
def valid?
warn '[DEPRECATED] the `valid?` method is obsolete'
return false if @code.nil?
return false if @description.nil?
return false if @type.nil?
true
end

# Custom attribute writer method with validation
# @param [Object] code Value to be assigned
def code=(code)
if code.nil?
fail ArgumentError, 'code cannot be nil'
end

@code = code
end

# Custom attribute writer method with validation
# @param [Object] description Value to be assigned
def description=(description)
if description.nil?
fail ArgumentError, 'description cannot be nil'
end

@description = description
end

# Custom attribute writer method with validation
# @param [Object] type Value to be assigned
def type=(type)
if type.nil?
fail ArgumentError, 'type cannot be nil'
end

@type = type
end

# Checks equality by comparing each attribute.
# @param [Object] Object to be compared
def ==(o)
Expand Down
Loading