openapi: 3.2.0
info:
title: Infobip OpenAPI Specification Connectivity API
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:37.825639538Z'
tags:
- name: connectivity
description: 'Powerful infrastructure and tools that connect you to the world.
'
x-type: category
x-displayName: Connectivity
paths:
/number/1/notify:
post:
tags:
- connectivity
summary: Number Context lookup (async)
description: This method allows you to get number context information for requested phone numbers and receive information at some endpoint asynchronously. Information may vary per country and your package. For package change, contact your account manager or [support](https://www.infobip.com/contact).
operationId: number-context-lookup-async
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcNotifyRequest'
examples:
Look up several phone numbers:
summary: Look up several phone numbers
value:
notifyContentType: application/json
notifyUrl: https://www.example.com/number/lookup/report
to:
- '41793026727'
- '41793026834'
application/xml:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcNotifyRequest'
examples:
Look up several phone numbers:
summary: Look up several phone numbers
value: "\n application/json\n https://www.example.com/number/lookup/report\n \n 41793026727\n 41793026834\n \n\n"
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseAsync'
examples:
Async number lookup response:
summary: Async number lookup response
value:
results:
- to: '3859851212'
status:
groupId: 1
groupName: PENDING
id: 3
name: PENDING_WAITING_DELIVERY
description: Message sent, waiting for delivery report
messageId: 2b691c32-1233-4716-a763-4f70cc929eae
- to: '3816038923'
status:
groupId: 1
groupName: PENDING
id: 3
name: PENDING_WAITING_DELIVERY
description: Message sent, waiting for delivery report
messageId: 24c753c7-8113-4983-9ddb-c50978ba47dc
bulkId: BULK-ID-123-xyz
application/xml:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseAsync'
examples:
Async number lookup response:
summary: Async number lookup response
value: "\n BULK-ID-123-xyz\n \n \n 3859851212\n \n 1\n PENDING\n 3\n PENDING_WAITING_DELIVERY\n Message sent, waiting for delivery report\n \n 2b691c32-1233-4716-a763-4f70cc929eae\n \n \n 3816038923\n \n 1\n PENDING\n 3\n PENDING_WAITING_DELIVERY\n Message sent, waiting for delivery report\n \n 24c753c7-8113-4983-9ddb-c50978ba47dc\n \n \n\n"
'400':
description: Error responses
content:
application/json:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value:
requestError:
serviceException:
messageId: BAD_REQUEST
text: Bad request
application/xml:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value: "\n \n \n BAD_REQUEST\n Bad request\n \n \n\n"
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- number-lookup:manage
- number-lookup:send
/number/1/query:
post:
tags:
- connectivity
summary: Number Context lookup
description: This method allows you to get Number Context information for the requested phone numbers. For package change, contact your account manager or [support](https://www.infobip.com/contact).
operationId: number-context-lookup
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcQueryRequest'
examples:
Look up a phone number:
summary: Look up a phone number
value:
to:
- '41793026727'
application/xml:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcQueryRequest'
examples:
Look up a phone number:
summary: Look up a phone number
value: "\n \n 41793026727\n \n\n"
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponse'
examples:
Number lookup response:
summary: Number lookup response
value:
results:
- to: '41793026727'
mccMnc: '22801'
imsi: '228011234567890'
originalNetwork:
networkName: Swisscom
networkPrefix: '79'
countryName: Switzerland
countryPrefix: '41'
networkId: 123
ported: false
roaming: false
servingMSC: '41001'
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
bulkId: BULK-ID-123-xyz
Ported number lookup response:
summary: Ported number lookup response
value:
results:
- to: '41793026727'
mccMnc: '22801'
imsi: '228011234567890'
originalNetwork:
networkName: Swisscom
networkPrefix: '79'
countryName: Switzerland
countryPrefix: '41'
networkId: 123
ported: true
portedNetwork:
networkName: Sunrise
networkPrefix: '77'
countryName: Switzerland
countryPrefix: '41'
networkId: 321
roaming: false
servingMSC: '41002'
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
bulkId: BULK-ID-123-xyz
Roaming number lookup response:
summary: Roaming number lookup response
value:
results:
- to: '41793026727'
mccMnc: '22801'
imsi: '228011234567890'
originalNetwork:
networkName: Swisscom
networkPrefix: '79'
countryName: Switzerland
countryPrefix: '41'
networkId: 123
ported: false
roaming: true
roamingNetwork:
networkName: Tele2
networkPrefix: '739'
countryName: Sweden
countryPrefix: '46'
networkId: 456
servingMSC: '46003'
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
bulkId: BULK-ID-123-xyz
application/xml:
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponse'
examples:
Number lookup response:
summary: Number lookup response
value: "\n BULK-ID-123-xyz\n \n \n 41793026727\n 22801\n 228011234567890\n \n Swisscom\n 79\n Switzerland\n 41\n 123\n \n false\n false\n 41001\n \n 3\n DELIVERED\n 5\n DELIVERED_TO_HANDSET\n Message delivered to handset\n \n \n 0\n Ok\n 0\n NO_ERROR\n No Error\n false\n \n \n \n\n"
Ported number lookup response:
summary: Ported number lookup response
value: "\n BULK-ID-123-xyz\n \n \n 41793026727\n 22801\n 228011234567890\n \n Swisscom\n 79\n Switzerland\n 41\n 123\n \n true\n \n Sunrise\n 77\n Switzerland\n 41\n 321\n \n false\n 41002\n \n 3\n DELIVERED\n 5\n DELIVERED_TO_HANDSET\n Message delivered to handset\n \n \n 0\n Ok\n 0\n NO_ERROR\n No Error\n false\n \n \n \n\n"
Roaming number lookup response:
summary: Roaming number lookup response
value: "\n BULK-ID-123-xyz\n \n \n 41793026727\n 22801\n 228011234567890\n \n Swisscom\n 79\n Switzerland\n 41\n 123\n \n false\n true\n \n Tele2\n 739\n Sweden\n 46\n 456\n \n 46003\n \n 3\n DELIVERED\n 5\n DELIVERED_TO_HANDSET\n Message delivered to handset\n \n \n 0\n Ok\n 0\n NO_ERROR\n No Error\n false\n \n \n \n\n"
'400':
description: Error responses
content:
application/json:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value:
requestError:
serviceException:
messageId: BAD_REQUEST
text: Bad request
application/xml:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value: "\n \n \n BAD_REQUEST\n Bad request\n \n \n\n"
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- number-lookup:manage
- number-lookup:send
/number/1/logs:
get:
tags:
- connectivity
summary: Get Number Context logs
description: This method allows you to get logs of sent Number Context requests.
operationId: get-number-context-logs
parameters:
- name: to
in: query
description: Destination address.
required: false
style: form
explode: true
schema:
type: string
- name: bulkId
in: query
description: Bulk ID for which log is requested.
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: messageId
in: query
description: NC lookup ID for which log is requested.
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: generalStatus
in: query
description: Requested Number Context [status](https://www.infobip.com/docs/essentials/response-status-and-error-codes#api-status-codes).
required: false
style: form
explode: true
schema:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.MessageGeneralStatus'
- name: sentSince
in: query
description: 'The logs will only include NC lookups sent after this date. Use it alongside `sentUntil` to specify a time range for the logs, but only up to the maximum limit of 1000 logs per call. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
required: false
style: form
explode: true
schema:
type: string
format: date-time
example: 2015-02-22T17:42:05.390+0100
- name: sentUntil
in: query
description: 'The logs will only include NC lookups sent before this date. Use it alongside `sentSince` to specify a time range for the logs, but only up to the maximum limit of 1000 logs per call. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
required: false
style: form
explode: true
schema:
type: string
format: date-time
example: 2015-02-22T19:42:05.390+0100
- name: limit
in: query
description: Maximum number of Number Context lookups in returned logs. If not set, the latest 50 records are returned. Maximum limit value is `1000` and you can only access logs for the last 48h.
required: false
style: form
explode: true
schema:
type: integer
format: int32
exclusiveMinimum: 0
minimum: 0
- name: mcc
in: query
description: Mobile Country Code.
required: false
style: form
explode: true
schema:
type: string
- name: mnc
in: query
description: 'Mobile Network Code. Mobile Country Code is required if this property is used. '
required: false
style: form
explode: true
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3d.NcLogResponse'
application/xml:
schema:
$ref: '#/components/schemas/4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3d.NcLogResponse'
'400':
description: Error responses
content:
application/json:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value:
requestError:
serviceException:
messageId: BAD_REQUEST
text: Bad request
application/xml:
schema:
$ref: '#/components/schemas/578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException'
examples:
Bad request:
summary: Bad request
value: "\n \n \n BAD_REQUEST\n Bad request\n \n \n\n"
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
$ref: '#/components/responses/ApiException429'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- number-lookup:logs:read
- number-lookup:manage
x-throttling-info:
- type: time
numberOfRequests: 60
numberOfTimeUnits: 0
timeUnit: m
/number-activation-state/1/network-reports:
get:
tags:
- connectivity
summary: Get Network Reports metadata
description: Get a paginated list of Network Reports metadata.
operationId: get-reports-metadata
parameters:
- name: page
in: query
description: Results page to retrieve (0..N).
required: false
style: form
explode: true
schema:
type: integer
format: int32
default: 0
- name: size
in: query
description: Number of records per page.
required: false
style: form
explode: true
schema:
type: integer
format: int32
default: 20
- name: dateFrom
in: query
description: 'Date in UTC that exactly defines the dateFrom property of the reports.
Format: yyyy-MM-dd
When both dateFrom and dateTo are provided then a list of reports between those two dates are returned.'
required: false
style: form
explode: true
schema:
type: string
example: '2024-03-02'
- name: dateTo
in: query
description: 'Date in UTC that exactly defines the dateTo property of the reports.
Format: yyyy-MM-dd
When both dateFrom and dateTo are provided then a list of reports between those two dates are returned.'
required: false
style: form
explode: true
schema:
type: string
example: '2024-03-03'
- name: reportId
in: query
description: The reportId to find
required: false
style: form
explode: true
schema:
type: string
example: 1f7a9938-0e3b-4e20-bb69-4968dca75078
- name: networkId
in: query
description: The networkId of network that provided the report content.
required: false
style: form
explode: true
schema:
type: integer
format: int32
example: 1717
- name: networkName
in: query
description: The name of network that provided the report content.
required: false
style: form
explode: true
schema:
type: string
example: Verizon Wireless
- name: generatedDateFrom
in: query
description: Filter by report generation date (inclusive lower bound)
required: false
style: form
explode: true
schema:
type: string
example: '2024-03-01'
- name: generatedDateTo
in: query
description: Filter by report generation date (inclusive upper bound)
required: false
style: form
explode: true
schema:
type: string
example: '2024-03-31'
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageReportMetadata'
examples:
Response for getting a list of Reports metadata results:
summary: Response for getting a list of Reports metadata results
value:
results:
- reportId: 1f7a9938-0e3b-4e20-bb69-4968dca75078
networkName: Verizon Wireless
networkId: 1717
generatedDate: '2024-03-19T00:00:00Z'
dateFrom: '2024-03-19T00:00:00Z'
dateTo: '2024-03-20T00:00:00Z'
expiryDate: '2024-05-18T00:00:00Z'
- reportId: 534a3153-0b3d-4408-9bc5-121d3e9c6537
networkName: AT&T Mobility
networkId: 1733
generatedDate: '2024-03-19T00:00:00Z'
dateFrom: '2024-03-19T00:00:00Z'
dateTo: '2024-03-20T00:00:00Z'
expiryDate: '2024-05-18T00:00:00Z'
paging:
page: 0
size: 2
totalPages: 30
totalResults: 61
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
$ref: '#/components/responses/ApiException429'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- number-activation-state:read
x-throttling-info:
- type: time
numberOfRequests: 1
numberOfTimeUnits: 0
timeUnit: s
/number-activation-state/1/network-reports/{reportId}/records:
get:
tags:
- connectivity
summary: Get Network Report content
description: Get a paginated list of destination number activation state changes from a given Report.
operationId: get-single-report
parameters:
- name: page
in: query
description: Results page to retrieve (0..N).
required: false
style: form
explode: true
schema:
type: integer
format: int32
default: 0
- name: size
in: query
description: Number of records per page.
required: false
style: form
explode: true
schema:
type: integer
format: int32
default: 20
- name: reportId
in: path
description: The reportId to retrieve
required: true
style: simple
explode: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageReports'
examples:
Response for getting a Deactivates Report content:
summary: Response for getting a Deactivates Report content
value:
results:
- date: 2024-03-05T00:00:00.000+0000
destination: '15123456789'
type: DEACTIVATION
- date: 2024-03-05T11:00:00.000+0000
destination: '15222222222'
type: DEACTIVATION
newDestination: '15777777777'
paging:
page: 1
size: 2
totalPages: 10
totalResults: 21
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not Found
content:
'*/*':
schema:
type: object
'429':
$ref: '#/components/responses/ApiException429'
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- number-activation-state:read
x-throttling-info:
- type: time
numberOfRequests: 1
numberOfTimeUnits: 0
timeUnit: s
/mi/verification/1/verify:
post:
tags:
- connectivity
summary: Silent Mobile Verification
description: 'Verify possession of end-user''s mobile phone number with the mobile network operator''s data connection.
API and URL may vary per country. Please contact your sales for more details.'
operationId: silent-mobile-verification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifyRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Silent Mobile Verification request status.
enum:
- REDIRECT
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
deviceRedirectUrl:
type: string
format: uri
description: An URL to perform mobile device redirect to if specified so by 'status'.
example: https://api.infobip.com/mno-domain/smv-check-endpoint
examples:
OK:
summary: OK
description: OK
value:
status: REDIRECT
token: 123e4567-e89b-12d3-a456-426655440000
deviceRedirectUrl: https://api.infobip.com/mno-domain/smv-check-endpoint
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
status: ERROR
token: 123e4567-e89b-12d3-a456-426655440000
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
status: ERROR
token: 123e4567-e89b-12d3-a456-426655440000
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
status: ERROR
token: 123e4567-e89b-12d3-a456-426655440000
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/verification/1/verify/advanced:
post:
tags:
- connectivity
summary: Advanced Silent Mobile Verification
description: 'Verify possession of the end user''s mobile phone number with a mobile network operator''s data connection.
If request body is supplied with additional data, the following can be done:
- SIM swap check before the mobile phone number verification
- Fallback SMS message if silent mobile verification fails
API and URL may vary per country. Contact your Account Manager for implementation details.'
operationId: advanced-silent-mobile-verification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifyAdvancedRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ACCEPTED
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
OK:
summary: OK
description: OK
value:
status: ACCEPTED
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
status: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
status: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
status:
type: string
description: Silent Mobile Verification request status.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
status: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/verification/1/verify/synchronous:
post:
tags:
- connectivity
summary: Synchronous Silent Mobile Verification
description: 'Verify possession of end-user''s mobile phone number with the mobile network operator''s data connection.
This API endpoint is available only in Brazil. Please contact your sales for more details.'
operationId: synchronous-silent-mobile-verification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifySynchronousRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
result:
type: string
description: Verification result.
enum:
- VALID
- INVALID
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
VALID:
summary: VALID
description: VALID
value:
result: VALID
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
INVALID:
summary: INVALID
description: INVALID
value:
result: INVALID
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
result: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
result: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
result: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
deprecated: true
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
x-deprecationInformation:
deprecation: 2025-12-24T00:00:00.000+0000
/mi/verification/1/zero-rated/init:
post:
tags:
- connectivity
summary: Zero rated request initialization
description: 'Initialise zero rated request.
This API endpoint is available only in Brazil. Please contact your sales for more details.'
operationId: initiate-zero-rated-silent-mobile-verification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.InitZeroRatedRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
deviceRedirectUrl:
type: string
format: uri
description: An URL to perform mobile device redirect to if specified so by 'status'.
example: https://api.infobip.com/mno-domain/smv-check-endpoint
examples:
OK:
summary: OK
description: OK
value:
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
deviceRedirectUrl: https://api.infobip.com/mi/verification/1/zero-rated?token=6a31ccca-ceba-4998-a3b0-16ae5e182ab0
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/verification/1/verify/zero-rated:
post:
tags:
- connectivity
summary: Zero rated request verify
description: 'Verify possession of end-user''s mobile phone number with the mobile network operator''s data connection.
This API endpoint is available only in Brazil. Please contact your sales for more details.'
operationId: zero-rated-silent-mobile-verification
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.VerifyZeroRatedRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
result:
type: string
description: Verification result.
enum:
- VALID
- INVALID
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
VALID:
summary: VALID
description: VALID
value:
result: VALID
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
INVALID:
summary: INVALID
description: INVALID
value:
result: INVALID
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Bad request:
summary: Bad request
description: Bad request
value:
result: ERROR
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
error:
id: 201
name: EC_INVALID_TOKEN
description: Token is invalid or does not exist
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
result: ERROR
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
result:
type: string
description: Verification result.
enum:
- ERROR
token:
type: string
format: uuid
description: Unique request ID. The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.
example: 123e4567-e89b-12d3-a456-426655440000
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
result: ERROR
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/number-intelligence/1/query:
post:
tags:
- connectivity
summary: Number Intelligence
description: 'Use this method to perform a query by a mobile phone number (MSISDN) for a given attribute name.
API and URL may vary per country. Contact your Account Manager for implementation details.'
operationId: query-number-intelligence
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NiQueryRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
token:
type: string
format: uuid
description: Unique request identifier.
examples:
OK:
summary: OK
description: OK
value:
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/simswap/1/check:
post:
tags:
- connectivity
summary: SIM Swap
description: 'Verify if there was a SIM swap event for a given mobile phone number and period.
API and URL may vary per country. Contact your Account Manager for implementation details.'
operationId: check-sim-swap
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapCheckRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
requestId:
type: string
format: uuid
description: Unique request identifier.
simSwapOccurred:
type:
- boolean
- 'null'
description: Indicates whether SIM swap occurred in the requested period.
networkInfo:
type: object
description: Additional network information about the SIM swap.
examples:
OK:
summary: OK
description: OK
value:
requestId: 665b6d63-0b65-4faf-a499-25530f0e93e0
simSwapOccurred: false
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
With additional timestamp:
summary: With additional timestamp
description: With additional timestamp
value:
requestId: 665b6d63-0b65-4faf-a499-25530f0e93e0
simSwapOccurred: true
networkInfo:
simSwapTimestamp: '2020-04-15T20:00:00Z'
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
With additional period:
summary: With additional period
description: With additional period
value:
requestId: 665b6d63-0b65-4faf-a499-25530f0e93e0
simSwapOccurred: true
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: 24
simSwapPeriodEndHours: 72
'400':
description: Bad request - no coverage
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
requestId:
type: string
format: uuid
description: Unique request identifier.
simSwapOccurred:
type:
- boolean
- 'null'
description: Always null on error.
networkInfo:
type: object
description: Network information (may be empty on error).
examples:
Bad request - no coverage:
summary: Bad request - no coverage
description: Bad request - no coverage
value:
error:
id: 100
name: EC_NO_COVERAGE
description: No coverage for requested mobile phone number
requestId: bfe2be7d-69a0-48e7-9672-e3e0236463c7
simSwapOccurred: null
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
requestId:
type: string
format: uuid
description: Unique request identifier.
simSwapOccurred:
type:
- boolean
- 'null'
description: Always null on error.
networkInfo:
type: object
description: Network information (may be empty on error).
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
requestId: 665b6d63-0b65-4faf-a499-25530f0e93e0
simSwapOccurred: null
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
'500':
description: Internal error - operation failed
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
requestId:
type: string
format: uuid
description: Unique request identifier.
simSwapOccurred:
type:
- boolean
- 'null'
description: Always null on error.
networkInfo:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
examples:
Internal error - operation failed:
summary: Internal error - operation failed
description: Internal error - operation failed
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
requestId: 665b6d63-0b65-4faf-a499-25530f0e93e0
simSwapOccurred: null
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/mi/national-identity-number/1/check:
post:
tags:
- connectivity
summary: National Identity Number check
description: 'Check if provided mobile phone number (MSISDN) belongs to user with provided national identity number.
'
operationId: check-national-identity-number
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NinCheckRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
token:
type: string
format: uuid
description: Unique request identifier.
match:
type: string
description: Match result.
enum:
- MATCHED
- NOT_MATCHED
examples:
OK:
summary: OK
description: OK
value:
token: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
match: MATCHED
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Bad request:
summary: Bad request
description: Bad request
value:
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied - Platform authorization error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: No permission to access resource
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
error:
id: 400
name: EC_UNPROCESSABLE_CONTENT
description: Unable to process provided data.
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
error:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto'
token:
type: string
format: uuid
description: Unique request identifier.
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
error:
id: 1000
name: EC_INTERNAL_ERROR
description: Internal error in Infobip platform. Contact Support to resolve the issue.
token: 56693a53-4174-4e81-8e9c-b8863a7ad827
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/biometrics/1/scenarios:
get:
tags:
- connectivity
summary: Get Scenarios
description: This function is used to retrieve all scenarios enabled for your account.
operationId: get-biometrics-scenarios
parameters:
- name: applicationTypes
in: query
description: 'One or more application types to filter scenarios. If none is set, then scenarios for all application types are returned in the response. Example: `?applicationTypes=extraction,kyc`.'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
description: Application type identifier.
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ScenarioResponse'
examples:
OK:
summary: OK
description: OK
value:
scenarios:
- name: CODE_EXTRACTION_QR
description: Scenario for default code extraction.
applicationType: EXTRACTION
- name: PASSPORT_MRZ_STANDARD
description: Scan MRZ and image from passport, extract MRZ data and ask for selfie to compare it with the scanned image.
applicationType: KYC
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_UNKNOWN_APPLICATION
text: Application cannot be found. Check application name in url parameter!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
/biometrics/1/extraction/sessions:
get:
tags:
- connectivity
summary: Get Extraction Session
description: This function is used to retrieve a session by `sessionId` received in [Create Extraction Session](#platform-connectivity/biometrics/create-biometrics-extraction-session) response.
operationId: get-biometrics-extraction-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GetSessionResponse'
examples:
OK:
summary: OK
description: OK
value:
session:
scenarioName: SOME_SCENARIO_NAME
locationInfo:
country: HRV
language: en-US
partnerReference: MyRef-jqhof
webhook:
url: https://example.com/webhook
type: ON_END
successUrl: https://example.com/success
cancelUrl: https://example.com/cancel
retainData: true
status: ACTIVE
id: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
applicationType: KYC
createdAt: '2021-11-02T14:15:45.7058838Z'
validUntil: '2021-11-02T14:25:45.7059354Z'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
post:
tags:
- connectivity
summary: Create Extraction Session
description: This function is used to initiate a session. It is the very first step for extraction application.
operationId: create-biometrics-extraction-session
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ExtractionSessionRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.CreatedSessionResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Bad request:
summary: Bad request
description: Bad request
value:
requestError:
serviceException:
messageId: EC_ACCOUNT_VALIDATION
text: Account does not have scenario enabled.
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
delete:
tags:
- connectivity
summary: Abort Extraction Session
description: This function is used to abort the session. Use `sessionId` received in the [Create Extraction Session](#platform-connectivity/biometrics/create-biometrics-extraction-session) response.
operationId: delete-biometrics-extraction-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'204':
description: Aborted successfully
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
/biometrics/1/kyc/sessions:
get:
tags:
- connectivity
summary: Get KYC Session
description: This function is used to retrieve a session by `sessionId` received in the [Create KYC Session](#platform-connectivity/biometrics/create-biometrics-kyc-session) response.
operationId: get-biometrics-kyc-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GetSessionResponse'
examples:
OK:
summary: OK
description: OK
value:
session:
scenarioName: SOME_SCENARIO_NAME
locationInfo:
country: HRV
language: en-US
partnerReference: MyRef-jqhof
webhook:
url: https://example.com/webhook
type: ON_END
successUrl: https://example.com/success
cancelUrl: https://example.com/cancel
retainData: true
status: ACTIVE
id: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
applicationType: KYC
createdAt: '2021-11-02T14:15:45.7058838Z'
validUntil: '2021-11-02T14:25:45.7059354Z'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
post:
tags:
- connectivity
summary: Create KYC Session
description: This function is used to initiate a session. It is the very first step for KYC application.
operationId: create-biometrics-kyc-session
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.KycSessionRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.CreatedSessionResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Bad request:
summary: Bad request
description: Bad request
value:
requestError:
serviceException:
messageId: EC_ACCOUNT_VALIDATION
text: Account does not have scenario enabled.
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
delete:
tags:
- connectivity
summary: Abort KYC Session
description: This function is used to abort the session. Use `sessionId` received in the [Create KYC Session](#platform-connectivity/biometrics/create-biometrics-kyc-session) response.
operationId: delete-biometrics-kyc-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'204':
description: Aborted successfully
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
/biometrics/1/enrollment/sessions:
get:
tags:
- connectivity
summary: Get Enrollment Session
description: This function is used to retrieve a session by `sessionId` received in the [Create Enrollment Session](#platform-connectivity/biometrics/create-biometrics-enrollment-session) response.
operationId: get-biometrics-enrollment-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GetSessionResponse'
examples:
OK:
summary: OK
description: OK
value:
session:
scenarioName: SOME_SCENARIO_NAME
locationInfo:
country: HRV
language: en-US
partnerReference: MyRef-jqhof
webhook:
url: https://example.com/webhook
type: ON_END
successUrl: https://example.com/success
cancelUrl: https://example.com/cancel
retainData: true
status: ACTIVE
id: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
applicationType: KYC
createdAt: '2021-11-02T14:15:45.7058838Z'
validUntil: '2021-11-02T14:25:45.7059354Z'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
post:
tags:
- connectivity
summary: Create Enrollment Session
description: This function is used to initiate a session. It is the very first step for Enrollment application.
operationId: create-biometrics-enrollment-session
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.EnrollmentSessionRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.CreatedSessionResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Bad request:
summary: Bad request
description: Bad request
value:
requestError:
serviceException:
messageId: EC_ACCOUNT_VALIDATION
text: Account does not have scenario enabled.
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
delete:
tags:
- connectivity
summary: Abort Enrollment Session
description: This function is used to abort the session. Use `sessionId` received in the [Create Enrollment Session](#platform-connectivity/biometrics/create-biometrics-enrollment-session) response.
operationId: delete-biometrics-enrollment-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'204':
description: Aborted successfully
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
/biometrics/1/verification/sessions:
get:
tags:
- connectivity
summary: Get Verification Session
description: This function is used to retrieve a session by `sessionId` received in the [Create Verification Session](#platform-connectivity/biometrics/create-biometrics-verification-session) response.
operationId: get-biometrics-verification-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GetSessionResponse'
examples:
OK:
summary: OK
description: OK
value:
session:
scenarioName: SOME_SCENARIO_NAME
locationInfo:
country: HRV
language: en-US
partnerReference: MyRef-jqhof
webhook:
url: https://example.com/webhook
type: ON_END
successUrl: https://example.com/success
cancelUrl: https://example.com/cancel
retainData: true
status: ACTIVE
id: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
applicationType: KYC
createdAt: '2021-11-02T14:15:45.7058838Z'
validUntil: '2021-11-02T14:25:45.7059354Z'
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
post:
tags:
- connectivity
summary: Create Verification Session
description: This function is used to initiate a session. It is the very first step for Verification application.
operationId: create-biometrics-verification-session
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.VerificationSessionRequest'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.CreatedSessionResponse'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Bad request:
summary: Bad request
description: Bad request
value:
requestError:
serviceException:
messageId: EC_ACCOUNT_VALIDATION
text: Account does not have scenario enabled.
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
delete:
tags:
- connectivity
summary: Abort Verification Session
description: This function is used to abort the session. Use `sessionId` received in the [Create Verification Session](#platform-connectivity/biometrics/create-biometrics-verification-session) response.
operationId: delete-biometrics-verification-session
parameters:
- name: X-Session-Id
in: header
description: Session ID header.
required: true
style: simple
explode: false
schema:
type: string
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
responses:
'204':
description: Aborted successfully
'401':
$ref: '#/components/responses/ApiException401'
'403':
$ref: '#/components/responses/ApiException403'
'404':
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Not found:
summary: Not found
description: Not found
value:
requestError:
serviceException:
messageId: EC_SESSION_NOT_FOUND
text: Session not found. Check session ID!
'429':
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
examples:
Too Many Requests:
summary: Too Many Requests
description: Too Many Requests
value:
requestError:
serviceException:
messageId: EC_TOO_MANY_REQUESTS
text: Too many requests.
'500':
$ref: '#/components/responses/ApiException500'
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- biometrics:manage
/camara/number-verification/v0/authorize:
get:
tags:
- connectivity
summary: Number verify device authorization
description: 'Use this method to redirect the mobile device on the MNO network for authorization, based on the mobile device IP address.
Upon authorization, the device is redirected back to the URL specified in `redirectUrl`.
When redirected back, a new query parameter `code` is being added.
It needs to be sent in a subsequent verify request to complete verification.
**Error handling behavior:**
- When `redirectUrl` parameter **is provided**: All errors are returned as a 302 redirect back to the `redirectUrl` with OAuth 2.0 error query parameters (`error`, `error_description` (optional), `state`).
- When `redirectUrl` parameter **is NOT provided**: A JSON response is returned (see below).
'
operationId: authorize-number-verify
parameters:
- name: clientId
in: query
description: Client ID to identify the client on whose behalf the device is making the request. This is **provided to the client** upon registration. The value is usually the username that is being used to login into Infobip portal when generating [API key header](https://www.infobip.com/docs/essentials/api-essentials/api-authentication#api-key-header) and/or client_id that is being used when [generating OAuth2 token](https://www.infobip.com/docs/api/platform/account-management/create-oauth2-token).
required: true
style: form
explode: true
schema:
type: string
example: enterprise-client-id
- name: redirectUrl
in: query
description: URL to redirect back the device to after authorization on MNO network. **This URL needs to be static**. For request tracking and correlation purposes, the `state` query parameter will be added to this URL before redirecting the device back.
required: true
style: form
explode: true
schema:
type: string
format: uri
example: https://enterprise.com/authorization-complete
- name: state
in: query
description: String that will be returned as a query parameter in the `redirectUrl`.
required: false
style: form
explode: true
schema:
type: string
example: 51A7_7131
- name: login_hint
in: query
description: OIDC login hint. Expects a phone number in `tel:+{phone_number_with_country_code}` format.
required: false
style: form
explode: true
schema:
type: string
example: tel:+441134961234
responses:
'302':
description: ' Redirect to MNO authorization endpoint. Response body is empty, information is returned in response headers.'
headers:
Location:
description: 'MNO authorization endpoint URL
**Error redirect:** When an error occurs and `redirectUrl` was provided, the error is returned as OAuth 2.0 query parameters in the redirect URL.
**Error redirect URL format:** `{redirectUrl}?error={error_code}&error_description={error_description}&state={state}`
Note: `error_description` is optional.
**OAuth error codes:**
- `invalid_request` - The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed.
- `unauthorized_client` - The client is not authorized to request an authorization code using this method.
- `access_denied` - The user or authorization server denied the request (for example, the user cannot be authenticated or denied the consent).
- `unsupported_response_type` - The authorization server does not support obtaining an authorization code using this method.
- `invalid_scope` - The requested scope is either invalid, unknown, or malformed.
- `consent_required` - The authorization server requires user consent.
- `server_error` - The authorization server encountered an unexpected condition that prevented it from fulfilling the request.
- `temporarily_unavailable` - The authorization server is currently unable to handle the request due to a temporary overloading or maintenance of the server.
- `invalid_request_object` - The request parameter contains an invalid Request Object.
- `request_uri_not_supported` - The authorization server does not support use of the request_uri parameter.
'
style: simple
explode: false
schema:
type: string
format: uri
example: https://mno.example.com/authorize?queryParam=...
x-correlator:
description: Correlation ID for tracking the request
style: simple
explode: false
schema:
type: string
format: uuid
example: 6a31ccca-ceba-4998-a3b0-16ae5e182ab0
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraResponseBaseDto'
'400':
description: 'Bad request.
When `redirectUrl` is available, this error is returned via 302 redirect with `error=invalid_request`'
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthenticated
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUnauthenticatedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthenticated:
summary: Unauthenticated
description: Unauthenticated
value:
requestError:
serviceException:
messageId: UNAUTHENTICATED
text: Invalid login details
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
/camara/number-verification/v0/verify:
post:
tags:
- connectivity
summary: Number Verification
description: Use this method to verify possession of the end-user's mobile phone number with the mobile network operator's data connection.
operationId: verify-number
parameters:
- name: X-Correlator
in: header
description: '`Code` parameter that was received on `/authorize` request. This header is not required only if OAuth2 `grant_type=authorization_code` was used on token generation.'
required: false
style: simple
explode: false
schema:
type: string
format: uuid
requestBody:
description: Number verification request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyRequestDto'
examples:
Phone verification:
summary: Phone verification
description: Phone verification
value:
phoneNumber: '+441134961234'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyResponseDto'
examples:
Verified:
summary: Verified
description: Verified
value:
devicePhoneNumberVerified: true
Not verified:
summary: Not verified
description: Not verified
value:
devicePhoneNumberVerified: false
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthenticated
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUnauthenticatedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthenticated:
summary: Unauthenticated
description: Unauthenticated
value:
requestError:
serviceException:
messageId: UNAUTHENTICATED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'409':
description: Conflict
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 409
code:
type: string
description: Error code.
enum:
- CONFLICT
message:
type: string
description: Detailed error message.
enum:
- Another request is created for the same MSISDN
examples:
Conflict:
summary: Conflict
description: Conflict
value:
status: 409
code: CONFLICT
message: Another request is created for the same MSISDN
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/number-verification/v2/dcql:
post:
tags:
- connectivity
summary: Number verification DCQL Request
description: Use this method to generate a credential request structure for the Android CredentialManager. The response must be passed to the device for SIM-based (TS.43) authentication.
operationId: create-dcql-request
requestBody:
description: DCQL request object specifying the desired use case
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlRequestDto'
examples:
Get phone number:
summary: Get phone number
description: Get phone number
value:
useCase: GET_PHONE_NUMBER
nonce: a1b2c3d4-e5f6-7890-abcd-ef1234567890
carrierIds:
- 123
- 456
Verify phone number:
summary: Verify phone number
description: Verify phone number
value:
useCase: VERIFY_PHONE_NUMBER
nonce: a1b2c3d4-e5f6-7890-abcd-ef1234567890
carrierIds:
- 123
- 456
required: true
responses:
'200':
description: OK — per-carrier map of DCQL credential objects or error objects
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlResponseDto'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlNotFoundErrorResponse'
examples:
All carriers successful:
summary: All carriers successful
description: All carriers successful
value:
'123':
id: miapi.infobip.com
format: dc-authorization+sd-jwt
meta:
credential_authorization_jwt: eyJhbGciOiJFUzI1NiIs...
vct_values:
- number-verification/device-phone-number/ts43
claims:
- path:
- android_carrier_hint
values:
- 123
'456':
id: miapi.infobip.com
format: dc-authorization+sd-jwt
meta:
credential_authorization_jwt: eyJhbGciOiJFUzI1NiIs...
vct_values:
- number-verification/device-phone-number/ts43
claims:
- path:
- android_carrier_hint
values:
- 456
Some carriers failed, some succeeded:
summary: Some carriers failed, some succeeded
description: Some carriers failed, some succeeded
value:
'123':
id: miapi.infobip.com
format: dc-authorization+sd-jwt
meta:
credential_authorization_jwt: eyJhbGciOiJFUzI1NiIs...
vct_values:
- number-verification/device-phone-number/ts43
claims:
- path:
- android_carrier_hint
values:
- 123
'456':
status: 404
code: NOT_FOUND
message: Not found
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/number-verification/v2/device-phone-number:
get:
tags:
- connectivity
summary: Get Phone Number
description: Use this method to retrieve the phone number associated with the device SIM.
operationId: get-device-phone-number
parameters:
- name: X-Correlator
in: header
description: In SIM based (TS.43) verification flow this should be the `vp_token` (SD-JWT) value received from Android Credential Manager.
required: false
style: simple
explode: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DevicePhoneNumberResponseDto'
examples:
Verified:
summary: Verified
description: Verified
value:
devicePhoneNumber: '+441134961234'
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthenticated
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUnauthenticatedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthenticated:
summary: Unauthenticated
description: Unauthenticated
value:
requestError:
serviceException:
messageId: UNAUTHENTICATED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'409':
description: Conflict
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 409
code:
type: string
description: Error code.
enum:
- CONFLICT
message:
type: string
description: Detailed error message.
enum:
- Another request is created for the same MSISDN
examples:
Conflict:
summary: Conflict
description: Conflict
value:
status: 409
code: CONFLICT
message: Another request is created for the same MSISDN
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/number-verification/v2/verify:
post:
tags:
- connectivity
summary: Number Verification
description: Use this method to verify possession of the end-user's mobile phone number with the phone SIM card.
operationId: verify-number-v2
parameters:
- name: X-Correlator
in: header
description: 'In SIM based (TS.43) verification flow this should be the `vp_token` (SD-JWT) value received from Android Credential Manager. If using SIM based (TS.43) verification flow, this header is mandatory.
'
required: false
style: simple
explode: false
schema:
type: string
requestBody:
description: Number verification request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyV2RequestDto'
examples:
Phone verification:
summary: Phone verification
description: Phone verification
value:
phoneNumber: '+441134961234'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyResponseDto'
examples:
Verified:
summary: Verified
description: Verified
value:
devicePhoneNumberVerified: true
Not verified:
summary: Not verified
description: Not verified
value:
devicePhoneNumberVerified: false
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthenticated
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUnauthenticatedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthenticated:
summary: Unauthenticated
description: Unauthenticated
value:
requestError:
serviceException:
messageId: UNAUTHENTICATED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'409':
description: Conflict
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 409
code:
type: string
description: Error code.
enum:
- CONFLICT
message:
type: string
description: Detailed error message.
enum:
- Another request is created for the same MSISDN
examples:
Conflict:
summary: Conflict
description: Conflict
value:
status: 409
code: CONFLICT
message: Another request is created for the same MSISDN
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/location/v0/verify:
post:
tags:
- connectivity
summary: Device Location Verification
description: 'Use this method to verify whether the device location is within a requested area.
A circle with a center specified by the latitude and longitude, and a radius specified by the accuracy.
'
operationId: verify-device-location
requestBody:
description: Device location verification request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraDeviceLocationVerifyRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
verificationResult:
type: boolean
description: Result of the location verification.
examples:
In requested radius:
summary: In requested radius
description: In requested radius
value:
verificationResult: true
Not in requested radius:
summary: Not in requested radius
description: Not in requested radius
value:
verificationResult: false
'303':
description: Give consent for device location verification
content:
application/json:
schema:
type: object
properties:
consentUrl:
type: string
format: uri
description: URL to redirect user for consent.
examples:
Consent not given:
summary: Consent not given
description: Consent not given
value:
consentUrl: https://mno.com/consent-page
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/sim-swap/v0/check:
post:
tags:
- connectivity
summary: SIM Swap
description: Use this method to verify if there was a SIM swap event for a given mobile phone number and period.
operationId: sim-swap-check
requestBody:
description: SIM swap check request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapCheckRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapCheckResponseDto'
examples:
OK:
summary: OK
description: OK
value:
swapped: false
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- SIM_SWAP.UNKNOWN_PHONE_NUMBER
message:
type: string
description: Detailed error message.
enum:
- SIM Swap can't be checked because the phone number is unknown
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: SIM_SWAP.UNKNOWN_PHONE_NUMBER
message: SIM Swap can't be checked because the phone number is unknown
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/sim-swap/v0/retrieve-date:
post:
tags:
- connectivity
summary: Retrieve SIM Swap date
description: Use this method to retrieve the last date when the SIM Swap occurred for a given mobile phone number.
operationId: sim-swap-retrieve-date
requestBody:
description: SIM swap retrieve date request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapRetrieveDateRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapRetrieveDateResponseDto'
examples:
OK:
summary: OK
description: OK
value:
latestSimChange: '2024-01-03T02:05:58Z'
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
/camara/kyc-match/v0.3/match:
post:
tags:
- connectivity
summary: KYC Match
description: Use this method to match customer data against Mobile Operators data.
operationId: know-your-customer-match
requestBody:
description: KYC match request object.
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraKycMatchRequestDto'
required: true
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraKycMatchResponseDto'
examples:
OK:
summary: OK
description: OK
value:
idDocumentMatch: 'true'
nameMatch: 'false'
nameMatchScore: 85
givenNameMatch: 'false'
givenNameMatchScore: 90
familyNameMatch: 'true'
nameKanaHankakuMatch: not_available
nameKanaZenkakuMatch: 'false'
nameKanaZenkakuMatchScore: 70
middleNamesMatch: 'true'
familyNameAtBirthMatch: 'false'
familyNameAtBirthMatchScore: 60
addressMatch: 'false'
addressMatchScore: 80
streetNameMatch: 'true'
streetNumberMatch: 'false'
streetNumberMatchScore: 75
postalCodeMatch: 'true'
regionMatch: 'false'
regionMatchScore: 65
localityMatch: 'true'
countryMatch: 'true'
houseNumberExtensionMatch: not_available
birthdateMatch: 'true'
emailMatch: 'false'
emailMatchScore: 88
genderMatch: 'true'
'400':
description: Bad request
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 400
code:
type: string
description: Error code.
enum:
- INVALID_ARGUMENT
message:
type: string
description: Detailed error message.
enum:
- Client specified an invalid argument, request body or query param
examples:
Bad request:
summary: Bad request
description: Bad request
value:
status: 400
code: INVALID_ARGUMENT
message: Client specified an invalid argument, request body or query param
'401':
description: Unauthorized - Platform authentication error
content:
application/json:
schema:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'403':
description: Permission denied
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse'
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse'
examples:
Permission denied:
summary: Permission denied
description: Permission denied
value:
status: 403
code: PERMISSION_DENIED
message: Client does not have sufficient permissions to perform this action
Unauthorized:
summary: Unauthorized
description: Unauthorized
value:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Invalid login details
'404':
description: Not found
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 404
code:
type: string
description: Error code.
enum:
- NOT_FOUND
message:
type: string
description: Detailed error message.
enum:
- Not found
examples:
Not found:
summary: Not found
description: Not found
value:
status: 404
code: NOT_FOUND
message: Not found
'422':
description: Unprocessable content
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 422
code:
type: string
description: Error code.
enum:
- SERVICE_NOT_APPLICABLE
message:
type: string
description: Detailed error message.
enum:
- The service is not available for the provided identifier
examples:
Unprocessable content:
summary: Unprocessable content
description: Unprocessable content
value:
status: 422
code: SERVICE_NOT_APPLICABLE
message: The service is not available for the provided identifier
'500':
description: Internal server error
content:
application/json:
schema:
type: object
properties:
status:
type: integer
description: HTTP status code.
enum:
- 500
code:
type: string
description: Error code.
enum:
- INTERNAL
message:
type: string
description: Detailed error message.
enum:
- Server error
examples:
Internal server error:
summary: Internal server error
description: Internal server error
value:
status: 500
code: INTERNAL
message: Server error
security:
- IBSSOTokenHeader: []
- APIKeyHeader: []
- Basic: []
- OAuth2: []
x-scopes:
- mobile-identity:manage
webhooks:
receive-silent-mobile-verification-result:
post:
tags:
- connectivity
summary: Receive silent mobile verification result
description: Silent mobile verification request will be processed asynchronously after the request is made to silent mobile verification API. After processing of the request is done, results will be delivered to the URL provided in silent mobile verification request.
externalDocs:
description: Learn more about the Mobile Identity platform and its use cases.
url: https://www.infobip.com/docs/mobile-identity
operationId: receive-silent-mobile-verification-result
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/acc54cffc2fdf57be1405002c65f11d7bb0b2506a15f7e1c75bb3cbcc41d6219.ResultResponse'
examples:
Successful response:
summary: Successful response
description: Successful silent mobile verification result.
value:
result: VALID
token: 123e4567-e89b-12d3-a456-426655440000
error: null
Unsuccessful response:
summary: Unsuccessful response
description: Error occurred while processing silent mobile verification request.
value:
result: ERROR
token: 123e4567-e89b-12d3-a456-426655440000
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
responses:
'200':
description: Your server returns this code if it accepts the callback.
receive-advanced-silent-mobile-verification-result:
post:
tags:
- connectivity
summary: Receive advanced silent mobile verification result
description: Advanced silent mobile verification request will be processed asynchronously after the request is made to advanced silent mobile verification API. After processing of the request is done, results will be delivered to the URL provided in advanced silent mobile verification request.
externalDocs:
description: Learn more about the Mobile Identity platform and its use cases.
url: https://www.infobip.com/docs/mobile-identity
operationId: receive-advanced-silent-mobile-verification-result
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/aaab91bc67ad6fdd15298ef61b480f76a93a7cae8c7684c83b1e909cda7f154f.ResultResponse'
examples:
Successful response:
summary: Successful response
description: Successful advanced silent mobile verification result.
value:
token: 123e4567-e89b-12d3-a456-426655440000
result: VALID
status: COMPLETED
error: null
Unsuccessful response:
summary: Unsuccessful response
description: Error occurred while processing silent mobile verification request.
value:
token: 123e4567-e89b-12d3-a456-426655440000
result: ERROR
status: COMPLETED
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
Unsuccessful response and fallback to SMS:
summary: Unsuccessful response and fallback to SMS
description: Error occurred while processing silent mobile verification request and fallback to SMS was issued.
value:
token: 123e4567-e89b-12d3-a456-426655440000
result: OTP_SMS_SENT
status: COMPLETED
error: null
Successful response with detected SIM Swap event:
summary: Successful response with detected SIM Swap event
description: Successful advanced silent mobile verification result of a detected SIM Swap event.
value:
token: 123e4567-e89b-12d3-a456-426655440000
result: SIM_SWAP_DETECTED
status: COMPLETED
error: null
responses:
'200':
description: Your server returns this code if it accepts the callback.
receive-number-intelligence-query-results:
post:
tags:
- connectivity
summary: Receive number intelligence query results
description: Number intelligence query request will be processed asynchronously after the request is made to number intelligence API. After processing of the request is done, results will be delivered to the URL provided in number intelligence request.
externalDocs:
description: Learn more about the Mobile Identity platform and its use cases.
url: https://www.infobip.com/docs/mobile-identity
operationId: receive-number-intelligence-query-results
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/c33580c9fc909cbe636f10f5fddd71adf658d961011f6b0e7df8bbb45e9ab4cb.QueryResultResponse'
examples:
Successful response:
summary: Successful response
description: Successful SIM swap attribute query result.
value:
token: e1ec531a-1de8-4c2e-8fee-464c7769ce90
niAttributes:
simSwap:
simSwapOccurred: true
networkInfo:
simSwapTimestamp: '2020-04-15T20:00:00+02:00'
simSwapPeriodStartHours: null
simSwapPeriodEndHours: null
nationalIdentityNumber:
match: MATCHED
Error on attribute level:
summary: Error on attribute level
description: Error occurred while querying SIM swap attribute.
value:
token: e1ec531a-1de8-4c2e-8fee-464c7769ce90
niAttributes:
simSwap:
simSwapOccurred: null
networkInfo: null
error:
id: 101
name: EC_GATEWAY_OPERATION_FAILED
description: Provider service failed
nationalIdentityNumber:
match: null
error:
id: 101
name: EC_GATEWAY_OPERATION_FAILED
description: Provider service failed
Error on number intelligence operation level:
summary: Error on number intelligence operation level
description: Error occurred while executing number intelligence operation.
value:
token: e1ec531a-1de8-4c2e-8fee-464c7769ce90
niAttributes: 'null'
error:
id: 202
name: EC_CONSENT_NOT_GRANTED
description: User consent not granted
National Identity Number NO_DATA match:
summary: National Identity Number NO_DATA match
description: National Identity Number could not conclude due to insufficient data from a provider.
value:
token: e1ec531a-1de8-4c2e-8fee-464c7769ce90
niAttributes:
nationalIdentityNumber:
match: NO_DATA
error:
id: 1
name: EC_UNKNOWN_SUBSCRIBER
description: The number does not exist or it has not been assigned to any active subscriber in the operator’s user database.
simSwap:
simSwapOccurred: true
networkInfo:
simSwapTimestamp: null
simSwapPeriodStartHours: 24
simSwapPeriodEndHours: 48
responses:
'200':
description: Your server returns this code if it accepts the callback.
receive-extraction-session-results:
post:
tags:
- connectivity
summary: Receive Extraction Session Results
description: Webhook that will be called with information about the Extraction Session status and results. The webhook URL provided in the [Create Extraction Session](#platform-connectivity/biometrics/create-biometrics-extraction-session) request will be called with the POST method that contains all the info in JSON format. It only expects `200 OK` status with no content in response.
operationId: receive-extraction-session-results
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.ExtractionWebhookRequest'
responses:
'200':
description: Your server returns this code if it accepts the callback
receive-kyc-session-results:
post:
tags:
- connectivity
summary: Receive KYC Session Results
description: Webhook which will be called with information about the KYC session status and results. The webhook URL provided in the [Create KYC Session](#platform-connectivity/biometrics/create-biometrics-kyc-session) request will be called with the POST method that contains all the info in JSON format. It only expects `200 OK` status with no content in response.
operationId: receive-kyc-session-results
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.KycWebhookRequest'
responses:
'200':
description: Your server returns this code if it accepts the callback
receive-enrollment-session-results:
post:
tags:
- connectivity
summary: Receive Enrollment Session Results
description: Webhook that will be called with information about the Enrollment Session status and results. The webhook URL provided in the [Create Enrollment Session](#platform-connectivity/biometrics/create-biometrics-enrollment-session) request will be called with the POST method that contains all the info in JSON format. It only expects `200 OK` status with no content in response.
operationId: receive-enrollment-session-results
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.EnrollmentWebhookRequest'
responses:
'200':
description: Your server returns this code if it accepts the callback
receive-verification-session-results:
post:
tags:
- connectivity
summary: Receive Verification Session Results
description: Webhook which will be called with information about the Verification session status and results. The webhook URL provided in the [Create Verification Session](#platform-connectivity/biometrics/create-biometrics-verification-session) request will be called with the POST method that contains all the info in JSON format. It only expects `200 OK` status with no content in response.
operationId: receive-verification-session-results
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.VerificationWebhookRequest'
responses:
'200':
description: Your server returns this code if it accepts the callback
components:
schemas:
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseAsync:
type: object
properties:
results:
type: array
description: Collection of preliminary lookup results.
items:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseAsyncDetails'
bulkId:
type: string
description: The ID that uniquely identifies the request.
title: NcResponseAsync
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyV2RequestDto:
type: object
properties:
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '+441134961234'
required:
- phoneNumber
title: NumberVerifyV2RequestDto
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcLogPrice:
type: object
properties:
currency:
type: string
description: The currency in which the price is expressed.
readOnly: true
pricePerLookup:
type: number
format: double
description: Price per one NC lookup.
readOnly: true
title: NcLogPrice
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseAsyncDetails:
type: object
description: Collection of preliminary lookup results.
properties:
to:
type: string
description: The looked up phone number.
readOnly: true
status:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcStatus'
messageId:
type: string
description: The ID that uniquely identifies the performed lookup.
readOnly: true
title: NcResponseAsyncDetails
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ScenarioDescription:
type: object
description: Object containing scenario identifier and its description.
properties:
name:
type: string
description: Scenario identifier. This value should be used in all Create Session requests.
description:
type: string
description: Scenario description.
applicationType:
type: string
description: Application type identifier.
title: ScenarioDescription
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo:
type: object
description: End user location information.
properties:
country:
type: string
description: End user country needed for processing documents. Format [ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).
example: HRV
language:
type: string
default: en-US
description: 'End user language. Will be used within the UI when completing scenario steps. Format: [ISO 639-1](http://www.lingoes.net/en/translator/langcode.htm).'
example: en-US
required:
- country
title: LocationInfo
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraNotFoundErrorResponse:
type: object
description: Camara API error response.
properties:
status:
type: integer
format: int32
description: HTTP status code.
example: 404
code:
type: string
description: Error code.
example: NOT_FOUND
message:
type: string
description: Detailed error message.
example: Not found
title: Camara Error Response
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ExtractionSessionRequest:
type: object
description: JSON containing session parameters and client identifiers for extraction application.
properties:
scenarioName:
type: string
description: 'Request a specific scenario within the application. To get possible values call [Get Scenarios](#platform-connectivity/biometrics/get-biometrics-scenarios) with the following query parameter: `?applicationTypes=extraction`. Check scenario descriptions in the response to find the scenario you need, and copy its `name`.'
example: CODE_EXTRACTION_QR
locationInfo:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo'
partnerReference:
type: string
description: Your (usually unique) identifier of the end user performing the scenario. Will be sent together with the rest of the information via the webhook.
example: MyRef-jqhof
webhook:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo'
successUrl:
type: string
description: End user will be sent to this URL after the selected scenario has been successfully completed.
example: https://example.com/success
cancelUrl:
type: string
description: End user will be sent to this URL if they cancel the scenario.
example: https://example.com/cancel
retainData:
type: boolean
description: Indicates whether Infobip should store and retain data. This value overrides value in account configuration.
example: true
required:
- locationInfo
- scenarioName
- webhook
title: ExtractionSessionRequest
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DeviceLocationRequestDto:
type: object
description: Check if provided MSISDN is in location defined by provided coordinates.
properties:
latitude:
type: number
format: float
description: Latitude that will be used to check for location of a mobile phone for provided phone number.
maximum: 90
minimum: -90
longitude:
type: number
format: float
description: Longitude that will be used to check for location of a mobile phone for provided phone number.
maximum: 180
minimum: -180
accuracy:
type: integer
format: int32
description: Accuracy in km that will be used to check for location of a mobile phone for provided phone number.
maximum: 20
minimum: 2
title: DeviceLocationRequestDto
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.EnrollmentWebhookRequest:
type: object
properties:
sessionId:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
partnerReference:
type: string
description: Your identifier of the end user performing a scenario sent in the initial request.
example: MyRef-jqhof
status:
type: string
description: Current session status.
enum:
- CREATED
- ACTIVE
- SUCCESS
- EXPIRED
- CANCELED
example: SUCCESS
data:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.EnrollmentWebhookData'
required:
- data
- partnerReference
- sessionId
title: EnrollmentWebhookRequest
c33580c9fc909cbe636f10f5fddd71adf658d961011f6b0e7df8bbb45e9ab4cb.QueryResultResponse:
type: object
description: Query result for each attribute sent to number intelligence query request
properties:
token:
type: string
description: Unique request identifier. This value was returned on number intelligence query request.
niAttributes:
type: object
description: List of query results for attributes provided on number intelligence query request.
properties:
simSwap:
type: object
description: Object representing SIM swap occurrence.
properties:
simSwapOccurred:
type: boolean
description: Information if SIM swap has occurred or not.
networkInfo:
type: object
description: Addition time information about SIM swap occurrence.
properties:
simSwapTimestamp:
type: string
description: Timestamp of SIM swap occurrence. This value will is null in case there is no information about occurrence timestamp.
simSwapPeriodStartHours:
type: number
format: integer
description: Starting hour of time frame when SIM swap occurred. This value will is null in case there is no information about occurrence timeframe starting hour.
simSwapPeriodEndHours:
type: number
format: integer
description: Ending hour of time frame when SIM swap occurred. This value will is null in case there is no information about occurrence timeframe ending hour.
error:
$ref: '#/components/schemas/4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse'
nationalIdentityNumber:
type: object
description: Object representing if national identity number and MSISDN matches.
properties:
match:
type: string
description: Information if user with provided national identity number owns provided MSISDN.
enum:
- MATCHED
- NOT_MATCHED
- NO_DATA
error:
$ref: '#/components/schemas/4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse'
error:
$ref: '#/components/schemas/4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse'
title: NumberIntelligenceQueryResultResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyRequestDto:
type: object
description: Number verification request object.
properties:
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '+441134961234'
required:
- phoneNumber
title: NumberVerifyRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DltDto:
type: object
description: Distributed Ledger Technology (DLT) specific parameters required for sending SMS to phone numbers registered in India.
properties:
principalEntityId:
type: string
description: Your assigned DLT principal entity ID.
contentTemplateId:
type: string
description: Registered DLT content template ID which matches message you are sending.
required:
- principalEntityId
title: DltDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.AttributesRequestDto:
type: object
description: 'Object with parameters per attribute for Number Intelligence to query.
Attribute value MUST NOT be null as in that case it will be ignored.
In some cases where attribute value has no parameters it NEEDS TO BE an empty object.'
example:
simSwap:
period: 24
nationalIdentityNumber:
nationalId: 123.456.789-10
properties:
simSwap:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapRequestDto'
nationalIdentityNumber:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NationalIdentityNumberDto'
deviceLocation:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DeviceLocationRequestDto'
title: AttributesRequestDto
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponse:
type: object
properties:
results:
type: array
description: Collection of lookup results.
items:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseDetails'
bulkId:
type: string
description: The ID that uniquely identifies the request.
title: NcResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifySynchronousRequestDto:
type: object
description: Silent Mobile Verification Synchronous request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '441134961234'
deviceIp:
type: string
format: xxx.xxx.xxx.xxx|xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx
description: IPv4 or IPv6 address of the mobile device that will be verified with operator.
example: 10.20.30.100|1111:22222:3333:4444:AAAA:BBBB:CCCC:DDDD
devicePort:
type: integer
format: int32
description: Port of the mobile device that will be verified with operator. Can be used only when "deviceIp" is also provided.
example: 54321
required:
- consentGranted
- deviceIp
- devicePort
- phoneNumber
title: SmvVerifySynchronousRequestDto
aaab91bc67ad6fdd15298ef61b480f76a93a7cae8c7684c83b1e909cda7f154f.ResultResponse:
type: object
description: Advanced silent mobile verification request result
properties:
token:
type: string
description: Unique request identifier. This value was returned on advanced silent mobile verification request.
result:
type: string
description: Advanced silent mobile verification request result.
enum:
- UNABLE_TO_VERIFY
- SIM_SWAP_DETECTED
- SIM_SWAP_CHECK_FAILED
- INVALID
- VALID
- OTP_SMS_SENT
status:
type: string
description: Advanced silent mobile verification request status.
enum:
- COMPLETED
- DEVICE_REDIRECT
error:
$ref: '#/components/schemas/4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse'
title: AdvancedSilentMobileVerificationResultResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraDeviceLocationVerifyRequestDto:
type: object
properties:
ueId:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUserEquipmentIdentifierDto'
uePort:
type: integer
format: int32
description: User equipment port.
example: 8080
maximum: 65535
minimum: 0
latitude:
type: number
format: double
description: Latitude of the location.
example: 51.5074
maximum: 90
minimum: -90
longitude:
type: number
format: double
description: Longitude of the location.
example: -0.1278
maximum: 180
minimum: -180
accuracy:
type: integer
format: int32
description: Radius of the circle in kilometers.
example: 10
maximum: 200
minimum: 2
required:
- accuracy
- latitude
- longitude
- ueId
title: CamaraDeviceLocationVerifyRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmsFailoverDto:
type: object
description: SMS failover message contents. In case this field is null, no SMS failover will be done.
properties:
from:
type: string
description: Message failover sender.
example: '441134961234'
text:
type: string
description: Message failover text.
example: 'One time verification pin: 1234'
validityPeriod:
type: integer
format: int32
description: The message validity period in seconds. When the period expires, it will not be allowed for the message to be sent.
example: 5
minimum: 0
regional:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.RegionalDto'
required:
- from
- text
title: SmsFailoverDto
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.VerificationWebhookRequest:
type: object
properties:
sessionId:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
partnerReference:
type: string
description: Your identifier of the end user performing a scenario sent in the initial request.
example: MyRef-jqhof
status:
type: string
description: Current session status.
enum:
- CREATED
- ACTIVE
- SUCCESS
- EXPIRED
- CANCELED
example: SUCCESS
data:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.VerificationWebhookData'
required:
- data
- partnerReference
- sessionId
title: VerificationWebhookRequest
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcStatus:
type: object
properties:
groupId:
type: integer
format: int32
description: Status group ID.
readOnly: true
groupName:
type: string
description: Status group name that describes which category the status code belongs to, e.g. PENDING, UNDELIVERABLE, DELIVERED, EXPIRED, REJECTED.
readOnly: true
id:
type: integer
format: int32
description: Status ID.
readOnly: true
name:
type: string
description: '[Status name](https://www.infobip.com/docs/essentials/response-status-and-error-codes).'
readOnly: true
description:
type: string
description: Human-readable description of the status.
readOnly: true
action:
type: string
description: Action that should be taken to recover from the error.
readOnly: true
title: NcStatus
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcQueryRequest:
type: object
properties:
to:
type: array
description: 'Array of phone numbers to look up. Numbers must be in international format (Example: `41793026727`). Numbers longer than 256 characters in the request will be clipped during processing. The clipped numbers will be included in the response, reports, and logs.'
items:
type: string
description: 'Array of phone numbers to look up. Numbers must be in international format (Example: `41793026727`). Numbers longer than 256 characters in the request will be clipped during processing. The clipped numbers will be included in the response, reports, and logs.'
maxItems: 1000
minItems: 1
required:
- to
title: NcQueryRequest
xml:
name: NumberContextRequest
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.RegionalDto:
type: object
description: Region specific parameters, often specified by local laws. Use this if country or region that you are sending SMS to requires some extra parameters.
properties:
indiaDlt:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DltDto'
title: RegionalDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapCheckRequestDto:
type: object
description: SIM Swap request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '441134961234'
period:
type: integer
format: int32
description: SIM swap check will be verified with MNO in "period" amount of hours from when this request was received. The value should be greater than 0.
example: 15
minimum: 0
required:
- consentGranted
- period
- phoneNumber
title: SimSwapCheckRequestDto
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.KycWebhookRequest:
type: object
properties:
sessionId:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
partnerReference:
type: string
description: Your identifier of the end user performing a scenario sent in the initial request.
example: MyRef-jqhof
status:
type: string
description: Current session status.
enum:
- CREATED
- ACTIVE
- SUCCESS
- EXPIRED
- CANCELED
example: SUCCESS
data:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.KycWebhookData'
required:
- data
- partnerReference
- sessionId
title: KycWebhookRequest
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.Network:
type: object
description: Information about the roaming network.
properties:
networkName:
type: string
description: Optional human readable name of the network.
readOnly: true
networkPrefix:
type: string
description: Network prefix.
readOnly: true
countryName:
type: string
description: Optional name of the country the network operates in.
readOnly: true
countryPrefix:
type: string
description: Country prefix.
readOnly: true
networkId:
type: integer
format: int32
description: ID of the network.
readOnly: true
readOnly: true
title: Network Information
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapRetrieveDateResponseDto:
type: object
description: SIM swap retrieve date response object.
properties:
latestSimChange:
type: string
format: date-time
description: Timestamp of the latest SIM swap event.
title: CamaraSimSwapRetrieveDateResponseDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.VerifyZeroRatedRequestDto:
type: object
description: Silent Mobile Verification zero rated request verification.
properties:
token:
type: string
format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
description: 'Unique request ID.
The whole flow from the request to response has same token so it can be used for debugging in case of error or matching API request with the callback webhook response.'
example: 123e4567-e89b-12d3-a456-426655440000
title: VerifyZeroRatedRequestDto
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.EnrollmentSessionRequest:
type: object
description: JSON containing session parameters and client identifiers for Enrollment application.
properties:
scenarioName:
type: string
description: 'Request a specific scenario within the application. To get possible values call [Get Scenarios](#platform-connectivity/biometrics/get-biometrics-scenarios) with the following query parameter: `?applicationTypes=enrollment`. Check scenario descriptions in the response to find the scenario you need, and copy its `name`.'
example: FACE_ENROLLMENT
locationInfo:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo'
partnerReference:
type: string
description: Your (usually unique) identifier of the end user performing the scenario. Will be sent together with the rest of the information via the webhook.
example: MyRef-jqhof
webhook:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo'
successUrl:
type: string
description: End user will be sent to this URL after the selected scenario has been successfully completed.
example: https://example.com/success
cancelUrl:
type: string
description: End user will be sent to this URL if they cancel the scenario.
example: https://example.com/cancel
retainData:
type: boolean
description: Indicates whether Infobip should store and retain data. This value overrides value in account configuration.
example: true
required:
- locationInfo
- scenarioName
- webhook
title: EnrollmentSessionRequest
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ErrorDto:
type:
- object
- 'null'
description: Error object describing occurred error, present only if an error has occurred.
properties:
id:
type: integer
format: int32
description: 'Unique identifier of occurred error on Infobip platform.
Response Status and Error Codes documentation page, section [Mobile Identity Error Codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#mobile-identity-error-codes),
contains all available Mobile Identity error IDs.'
name:
type: string
description: 'Unique value of occurred error under Mobile Identity product.
Response Status and Error Codes documentation page, section [Mobile Identity Error Codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#mobile-identity-error-codes),
contains all available Mobile Identity error codes.'
description:
type: string
description: 'Description of occurred error for easier error comprehension.
Response Status and Error Codes documentation page, section [Mobile Identity Error Codes](https://www.infobip.com/docs/essentials/response-status-and-error-codes#mobile-identity-error-codes),
contains descriptions of all errors that can occur on Mobile Identity platform.'
title: ErrorDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlRequestDto:
type: object
properties:
useCase:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Ts43UseCase'
nonce:
type: string
description: 'A single-use, client generated value. The client keeps it and uses it to correlate the eventual response. Infobip embeds this same value in the credential_authorization_jwt payload.
'
example: 2307e608-e619-4df5-a460-a99b4446f3f0
carrierIds:
type: array
description: Array of Android canonical carrier IDs.
example:
- 123
- 456
items:
type: integer
format: int32
description: Array of Android canonical carrier IDs.
operationType:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.OperationType'
required:
- carrierIds
- nonce
- useCase
title: DcqlRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Claim:
type: object
description: Claim object containing the optional hint used by Android to suggest the right SIM in dual-SIM devices.
properties:
path:
type: array
description: Name of the hint parameter
example:
- android_carrier_hint
items:
type: string
description: Name of the hint parameter
example: '["android_carrier_hint"]'
values:
type: array
description: Value of the hint parameter
example:
- 1234
items:
type: integer
format: int32
description: Value of the hint parameter
title: Claim
4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3d.NcLogResponse:
type: object
properties:
results:
type: array
description: Collection of logs.
items:
$ref: '#/components/schemas/4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3d.NcLog'
title: NcLogResponse
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricData:
type: object
description: Biometric data.
oneOf:
- $ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricReference'
- $ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricVector'
title: BiometricData
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.ReportMetadata:
type: object
properties:
reportId:
type: string
description: The unique reportId. Needed for accessing the report content
example: 138a2a58-0cf3-4ed3-a828-c3dc35eb2bb6
maxLength: 64
networkName:
type: string
description: The name of network that provided the report content.
example: Verizon Wireless
networkId:
type: integer
format: int32
description: The networkId of network that provided the report content.
example: 1717
generatedDate:
type: string
description: 'Date in UTC then given report was generated. Format: yyyy-MM-dd'
example: '2024-03-09'
dateFrom:
type: string
description: 'Date in UTC that defines since when the report has data about activation changes on a given network.
Format: yyyy-MM-ddNote that multiple reports for the same date range on the same network are possible.
'
example: '2024-03-07'
dateTo:
type: string
description: 'Date in UTC that defines till when the report has data about activation changes on a given network.
Format: yyyy-MM-dd
Note that multiple reports for the same date range on the same network are possible.'
example: '2024-03-08'
expiryDate:
type: string
description: 'Date in UTC that defines when the report will be considered expired and consequently deleted.
Format: yyyy-MM-dd'
example: '2024-06-08'
required:
- dateFrom
- dateTo
- expiryDate
- generatedDate
- networkId
- networkName
- reportId
title: ReportMetadata
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.KycSessionRequest:
type: object
description: JSON containing session parameters and client identifiers for KYC application.
properties:
scenarioName:
type: string
description: 'Request a specific scenario within the application. To get possible values call [Get Scenarios](#platform-connectivity/biometrics/get-biometrics-scenarios) with the following query parameter: `?applicationTypes=kyc`. Check scenario descriptions in the response to find the scenario you need, and copy its `name`.'
example: KYC_PASSPORT_HRV
locationInfo:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo'
partnerReference:
type: string
description: Your (usually unique) identifier of the end user performing the scenario. Will be sent together with the rest of the information via the webhook.
example: MyRef-jqhof
webhook:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo'
successUrl:
type: string
description: End user will be sent to this URL after the selected scenario has been successfully completed.
example: https://example.com/success
cancelUrl:
type: string
description: End user will be sent to this URL if they cancel the scenario.
example: https://example.com/cancel
retainData:
type: boolean
description: Indicates whether Infobip should store and retain data. This value overrides value in account configuration.
example: true
required:
- locationInfo
- scenarioName
- webhook
title: KycSessionRequest
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GenericSession:
type: object
description: Session object.
properties:
scenarioName:
type: string
description: Request a specific scenario within the application.
example: SOME_SCENARIO_NAME
locationInfo:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo'
partnerReference:
type: string
description: Your (usually unique) identifier of the end user performing the scenario. Will be sent together with the rest of the information via the webhook.
example: MyRef-jqhof
webhook:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo'
successUrl:
type: string
description: End user will be sent to this URL after the selected scenario has been successfully completed.
example: https://example.com/success
cancelUrl:
type: string
description: End user will be sent to this URL if they cancel the scenario.
example: https://example.com/cancel
retainData:
type: boolean
description: Indicates whether Infobip should store and retain data. This value overrides value in account configuration.
example: true
status:
type: string
description: Current session status.
enum:
- CREATED
- ACTIVE
- SUCCESS
- EXPIRED
- CANCELED
example: ACTIVE
id:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
applicationType:
type: string
description: Application type identifier.
example: KYC
createdAt:
type: string
format: date-time
description: 'Session creation date and time. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
example: '2021-11-02T14:15:45.7058838Z'
validUntil:
type: string
format: date-time
description: 'Session validity date and time. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
example: '2021-11-02T14:25:45.7059354Z'
required:
- locationInfo
- scenarioName
- webhook
title: GenericSession
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.ExtractionWebhookData:
type: object
description: Result data object.
properties:
payload:
type: string
description: Payload extracted from scanned code.
example: '1234567890'
title: ExtractionWebhookData
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.ExtractionWebhookRequest:
type: object
properties:
sessionId:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
partnerReference:
type: string
description: Your identifier of the end user performing a scenario sent in the initial request.
example: MyRef-jqhof
status:
type: string
description: Current session status.
enum:
- CREATED
- ACTIVE
- SUCCESS
- EXPIRED
- CANCELED
example: SUCCESS
data:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.ExtractionWebhookData'
required:
- data
- partnerReference
- sessionId
title: ExtractionWebhookRequest
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapRetrieveDateRequestDto:
type: object
properties:
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '+441134961234'
required:
- phoneNumber
title: CamaraSimSwapRetrieveDateRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifyRequestDto:
type: object
description: Silent Mobile Verification request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '441134961234'
callbackUrl:
type: string
description: Your URL that will be called to provide [result](#platform-connectivity/mobile-identity/receive-silent-mobile-verification-result) when the process is completed.
example: https://api.infobip.com/my-callback-webook/my-path
returnUrl:
type: string
description: An URL to which the mobile device will be redirected to when verification is complete.
example: https://api.infobip.com/my-site/my-shop.html
deviceIp:
type: string
format: xxx.xxx.xxx.xxx|xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx
description: IPv4 or IPv6 address of the mobile device that will be verified with operator. Currently, can be used only in Brazil.
example: 10.20.30.100|1111:22222:3333:4444:AAAA:BBBB:CCCC:DDDD
devicePort:
type: integer
format: int32
description: Port of the mobile device that will be verified with operator. Can be used only when "deviceIp" is also provided. Currently, can be used only in Brazil.
example: 54321
required:
- callbackUrl
- consentGranted
- phoneNumber
title: SmvVerifyRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapCheckRequestDto:
type: object
properties:
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '+441134961234'
maxAge:
type: integer
format: int32
default: 240
description: SIM swap check will be verified with MNO in "period" amount of hours from when this request was received. The value should be greater than 0.
example: 15
maximum: 2400
minimum: 1
required:
- phoneNumber
title: CamaraSimSwapCheckRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Meta:
type: object
properties:
credential_authorization_jwt:
type: string
description: JWT token for credential authorization signed by Infobip.
example: eyJhbGciOiJIUzI1NiI...
vct_values:
type: array
description: Array containing the Google-defined TS.43 credential type identifier that corresponds to the CAMARA scope from the request
items:
type: string
description: Array containing the Google-defined TS.43 credential type identifier that corresponds to the CAMARA scope from the request
title: Meta
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcNotifyRequest:
type: object
properties:
notifyContentType:
type: string
description: Preferred lookup report content type. Can be `application/json` or `application/xml`.
notifyUrl:
type: string
description: The URL on your call back server on which the lookup report will be sent.
to:
type: array
description: 'Array of phone numbers to look up. Numbers must be in international format (Example: `41793026727`). Numbers longer than 256 characters in the request will be clipped during processing. The clipped numbers will be included in the response, reports, and logs.'
items:
type: string
description: 'Array of phone numbers to look up. Numbers must be in international format (Example: `41793026727`). Numbers longer than 256 characters in the request will be clipped during processing. The clipped numbers will be included in the response, reports, and logs.'
required:
- to
title: NcNotifyRequest
xml:
name: NumberContextRequest
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NiQueryRequestDto:
type: object
description: Number Intelligence query request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to perform a query by. The number must be in international format.
example: '441134961234'
callbackUrl:
type: string
description: Your URL that will be called to provide [query results](#platform-connectivity/mobile-identity/receive-number-intelligence-query-results) when the process is completed.
example: https://api.infobip.com/my-callback-webook/my-path
attributes:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.AttributesRequestDto'
required:
- attributes
- callbackUrl
- consentGranted
- phoneNumber
title: NiQueryRequestDto
4033c81feb806caaa02f9cef553f79f0137a7aaa85d200d9d5e6449874c43c3d.NcLog:
type: object
description: Collection of logs.
properties:
bulkId:
type: string
description: The ID that uniquely identifies the request.
messageId:
type: string
description: The ID that uniquely identifies the performed lookup.
to:
type: string
description: The looked up phone number.
sentAt:
type: string
format: date-time
description: 'Tells when the lookup was performed. Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
doneAt:
type: string
format: date-time
description: 'Tells when Infobip finished processing the lookup (e.g. lookup request was delivered to the destination network). Has the following format: `yyyy-MM-dd''T''HH:mm:ss.SSSZ`.'
mccMnc:
type: string
description: Mobile country and network codes.
price:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcLogPrice'
status:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcStatus'
error:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcError'
title: NcLog
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NumberVerifyResponseDto:
type: object
description: Number verification response object.
properties:
devicePhoneNumberVerified:
type: boolean
description: Device verification result.
title: NumberVerifyResponseDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlResponseDto:
type: object
additionalProperties:
allOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlCredentialPerCarrierDtoResponse'
x-additionalPropertiesName: carrierId
description: 'Map of resolved DCQL credential objects keyed by carrier ID, used to build the credential request structure for the Android
CredentialManager (TS.43 SIM-based authentication). If one or more requested carriers could not be resolved, their error responses
will be returned in the same map. For unresolved carrier response structure, see `DCQL Carrier Error Map` section.
'
title: DCQL Credential Map
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.DeactivationType:
type: string
description: 'Type of the activation information. Potential values are:
DEACTIVATION - number was deactivated. All messaging to this number must stop.
ACTIVATION - number was activated after being deactivated previously. These numbers must opt-in again to a program to begin any messaging activity.
SUSPENSION - number got suspended. Messaging to this number must be suspended.
REACTIVATION - number was reactivated after being previously suspended. Messaging to this number can resume.
'
enum:
- DEACTIVATION
- REACTIVATION
- SUSPENSION
example: DEACTIVATION
title: DeactivationType
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraResponseBaseDto:
type: object
title: CamaraResponseBaseDto
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcResponseDetails:
type: object
description: Collection of lookup results.
properties:
to:
type: string
description: The looked up phone number.
readOnly: true
mccMnc:
type: string
description: Mobile country code and mobile network code concatenated. MccMnc will start with the MCC, and it will always have three digits, followed by the MNC (length of the MNC depends on the value of the MCC, and it can be two or three).
readOnly: true
imsi:
type: string
description: International Mobile Subscriber Identity, used to uniquely identify the user of a mobile network.
readOnly: true
originalNetwork:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.Network'
ported:
type: boolean
description: True if number has been ported.
readOnly: true
portedNetwork:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.Network'
roaming:
type: boolean
description: True if number is currently in roaming.
readOnly: true
roamingNetwork:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.Network'
servingMSC:
type: string
description: Serving mobile switching center.
readOnly: true
status:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcStatus'
error:
$ref: '#/components/schemas/20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcError'
title: NcResponseDetails
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NationalIdentityNumberDto:
type: object
description: Check if provided MSISDN belongs to user with provided national identity number.
properties:
nationalId:
type: string
description: 'National Identification Number that will be used to check for a match against a mobile phone number.
'
minLength: 1
documentType:
type: string
description: 'Document type that will be used to check for a match against a mobile phone number.
Currently, used and mandatory only in Colombia. Available values are `CC`, `CE` and `NIT`.
'
title: NationalIdentityNumberDto
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageReportMetadata:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.ReportMetadata'
paging:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageInfo'
title: PageReportMetadata
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ServiceException:
type: object
description: Service exception object containing error details.
properties:
messageId:
type: string
description: Identifier of the error.
example: UNAUTHORIZED
text:
type: string
description: Detailed error description.
example: Invalid login details
title: ServiceException
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraSimSwapCheckResponseDto:
type: object
description: SIM swap check response object.
properties:
swapped:
type: boolean
description: Indicates whether the SIM card has been swapped during the period.
title: CamaraSimSwapCheckResponseDto
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricVector:
type: object
allOf:
- $ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricData'
- type: object
properties:
vector:
type: array
description: Biometric vector associated with the end user. Used when Infobip didn't store the vector in enrolment phase.
example:
- -0.09652680158615112
- 0.07107646763324738
- -0.029479391872882843
- -0.006973235867917538
items:
type: number
format: double
title: BiometricVector
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapRequestDto:
type: object
description: Check if sim swap has occurred for requested MSISDN in provided time period.
properties:
period:
type: integer
format: int32
description: 'If SIM swap attribute is included it will be verified with MNO allowed hour period.
The value should be greater than 0.
'
example: 15
minimum: 0
title: SimSwapRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraPermissionDeniedErrorResponse:
type: object
description: Camara API error response for permission denied requests.
properties:
status:
type: integer
format: int32
description: HTTP status code.
example: 403
code:
type: string
description: Error code.
example: PERMISSION_DENIED
message:
type: string
description: Detailed error message.
example: Client does not have sufficient permissions to perform this action
title: Camara Error Response
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ScenarioResponse:
type: object
properties:
scenarios:
type: array
description: List of all enabled scenarios.
items:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.ScenarioDescription'
title: ScenarioResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapCheckDto:
type: object
description: SIM swap check parameters. In case this field is null, no SIM swap checks will be done.
properties:
period:
type: integer
format: int32
description: SIM swap check will be verified with MNO in "period" amount of hours from when this request was received. The value should be greater than 0.
example: 15
minimum: 0
proceedOn:
type: array
description: 'If specified, proceed to the SMV verify in case:
- SIM swap check fails
- There is no SIM swap coverage
- Result of the SIM swap check was unknown'
items:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapProceedOnDto'
uniqueItems: true
required:
- period
title: SimSwapCheckDto
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.MrzWebhookData:
type: object
description: Results of reading Machine Readable Zone (MRZ) data.
properties:
name:
type: string
description: Name; part of the MRZ name of a holder.
example: NAME
surname:
type: string
description: Surname; part of the MRZ name of a holder.
example: SURNAME
documentNumber:
type: string
description: MRZ document number.
example: '123456789'
birthDate:
type: string
description: 'MRZ date of birth. Has the following format: `YYMMDD`.'
example: '000101'
expiryDate:
type: string
description: 'MRZ date of expiry. Has the following format: `YYMMDD`.'
example: '250101'
country:
type: string
description: MRZ issuing state or organization.
example: HRV
sex:
type: string
description: MRZ gender.
example: F
nationality:
type: string
description: MRZ nationality.
example: HRV
optionalData:
type: array
description: MRZ optional data.
example:
- mrzOptionalItem1
- mrzOptionalItem2
items:
type: string
personalNumber:
type: string
description: Personal identification number, part of MRZ optional data.
example: 01234567890
type:
type: string
description: MRZ document code.
example: P
title: MrzWebhookData
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GetSessionResponse:
type: object
description: JSON containing execution results and details about the retrieved session.
properties:
session:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.GenericSession'
title: GetSessionResponse
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.NcError:
type: object
properties:
groupId:
type: integer
format: int32
description: Error group ID.
readOnly: true
groupName:
type: string
description: Error group name.
readOnly: true
id:
type: integer
format: int32
description: Error ID.
readOnly: true
name:
type: string
description: Error name.
readOnly: true
description:
type: string
description: Human-readable description of the error.
readOnly: true
permanent:
type: boolean
description: Tells if the error is permanent.
readOnly: true
title: NcError
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult:
type: string
enum:
- 'TRUE'
- 'FALSE'
- NOT_AVAILABLE
title: MatchResult
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.PlatformErrorResponse:
type: object
description: Platform error response for authentication and authorization errors.
properties:
requestError:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.RequestError'
title: Platform Error Response
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapProceedOnDto:
type: string
description: 'If specified, proceed to the SMV verify in case:
- SIM swap check fails
- There is no SIM swap coverage
- Result of the SIM swap check was unknown'
enum:
- ANY_ERROR
- UNKNOWN
- NO_COVERAGE
title: SimSwapProceedOnDto
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageReports:
type: object
properties:
results:
type: array
items:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.ReportLineItem'
paging:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageInfo'
title: PageReports
acc54cffc2fdf57be1405002c65f11d7bb0b2506a15f7e1c75bb3cbcc41d6219.ResultResponse:
type: object
description: Silent mobile verification request result
properties:
result:
type: string
description: Silent mobile verification request result.
enum:
- VALID
- INVALID
- ERROR
token:
type: string
description: Unique request identifier. This value was returned on silent mobile verification request.
error:
$ref: '#/components/schemas/4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse'
title: SilentMobileVerificationResultResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlNotFoundErrorResponse:
type: object
additionalProperties:
allOf:
- $ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraNotFoundErrorResponse'
x-additionalPropertiesName: carrierId
description: 'Map of DCQL error responses keyed by carrier ID, returned when one or more requested carriers could not be resolved.
Resolved carriers will be returned in the same map. For resolved carrier response structure, see `DCQL Credential Map` section.
'
title: DCQL Carrier Error Map
20085a4036d67f66ebf204560d55d58a7c131c15d42c8ed9442747c488e08630.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
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUserEquipmentIdentifierDto:
type: object
description: User equipment identifier.
properties:
externalId:
type: string
description: External identifier.
example: 123456789@domain.com
msisdn:
type: string
description: Mobile phone number (MSISDN) in international format.
example: '+441134961234'
ipv4Addr:
type: string
description: IPv4 address of the device.
example: 192.168.1.100
pattern: ^$|^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$|(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))
ipv6Addr:
type: string
description: IPv6 address of the device.
example: 2001:db8::1
pattern: ^$|^(([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$|(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))
required:
- msisdn
title: CamaraUserEquipmentIdentifierDto
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo:
type: object
description: Webhook that will be called with the information about the request status. The webhook will be called with a POST method that contains all the info in JSON format. Check webhook endpoint for more details.
properties:
url:
type: string
format: uri
description: Your webhook URL onto which the request is received.
example: https://example.com/webhook
type:
type: string
default: ON_END
description: Defines what kind of requests you want to receive on a webhook. `ON_END` - only final status at the end, `ON_STATUS_CHANGE` - any change in the scenario.
enum:
- ON_END
- ON_STATUS_CHANGE
example: ON_END
required:
- url
title: WebhookInfo
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.RequestError:
type: object
description: Request error object.
properties:
serviceException:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.ServiceException'
title: RequestError
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraKycMatchRequestDto:
type: object
description: Camara Know Your Customer Match request object
properties:
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '+441134961234'
idDocument:
type: string
description: Id number associated to the official identity document in the country.
example: '987654321'
name:
type: string
description: Complete name of the customer, usually composed of first/given name and last/family/sur-name in a country.
example: Jane Smith
givenName:
type: string
description: First/given name or compound first/given name of the customer.
example: Jane
familyName:
type: string
description: Last name, family name, or surname of the customer.
example: Smith
nameKanaHankaku:
type: string
description: Complete name of the customer in Hankaku-Kana format (reading of name) for Japan.
example: ジェーン スミス
nameKanaZenkaku:
type: string
description: Complete name of the customer in Zenkaku-Kana format (reading of name) for Japan.
example: ジェーン スミス
middleNames:
type: string
description: Middle name/s of the customer.
example: Marie
familyNameAtBirth:
type: string
description: Last/family/sur-name at birth of the customer.
example: Johnson
address:
type: string
description: Complete address of the customer.
example: 742 Evergreen Terrace, Springfield, IL 62704
streetName:
type: string
description: Name of the street of the customer's address. It should not include the type of the street.
example: ' Evergreen Terrace'
streetNumber:
type: string
description: The street number of the customer's address. Number identifying a specific property on the 'streetName'.
example: '742'
postalCode:
type: string
description: Zip code or postal code.
example: '62704'
region:
type: string
description: Region/prefecture of the customer's address.
example: Illinois
locality:
type: string
description: Locality of the customer's address.
example: Springfield
country:
type: string
description: Country of the customer's address. Format ISO 3166-1 alpha-2.
example: US
houseNumberExtension:
type: string
description: Specific identifier of the house needed depending on the property type. For example, number of apartment in an apartment building.
example: Apt 2B
birthdate:
type: string
format: date
description: The birthdate of the customer, in RFC 3339 / ISO 8601 calendar date format (YYYY-MM-DD).
example: '1985-07-15'
email:
type: string
format: email
description: Email address of the customer in the RFC specified format (local-part@domain).
example: jane.smith@example.com
gender:
type: string
description: Gender of the customer.
enum:
- MALE
- FEMALE
- OTHER
example: FEMALE
required:
- phoneNumber
title: CamaraKycMatchRequestDto
ApiRequestError:
type: object
properties:
serviceException:
$ref: '#/components/schemas/ApiRequestErrorDetails'
title: ApiRequestError
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.VerificationWebhookData:
type: object
description: Result data object.
properties:
faceMatch:
type: boolean
description: The result of comparing face images between a document and a selfie. `True`, if distance between images is less than configured threshold, which means that the faces most likely match. `False` means that the faces most likely do not match.
example: true
faceDistance:
type: number
format: float
description: Distance between face images from a document and a selfie. Possible values are numbers between `0.00` and `1.00`. The closer the number is to `0.00`, the more likely it is that the images match.
example: 0.232
faceConfidenceScore:
type: number
format: float
description: Confidence score between face images from a document and a selfie. Possible values are numbers between `0.00` and `100.00`. The closer the number is to `100.00`, the more likely it is that the images match.
example: 83
title: VerificationWebhookData
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Ts43UseCase:
type: string
description: The TS.43 operation use case.
enum:
- GET_PHONE_NUMBER
- VERIFY_PHONE_NUMBER
example: GET_PHONE_NUMBER
title: Ts43UseCase
578c889dd8f68587bd351066c5c6572a98ea0c15c65b5cacb8779be90fbfbb70.ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: ApiException
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DevicePhoneNumberResponseDto:
type: object
description: Device phone number response object.
properties:
devicePhoneNumber:
type: string
description: Device phone number result.
title: DevicePhoneNumberResponseDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraKycMatchResponseDto:
type: object
description: Camara Know Your Customer Match response object
properties:
idDocumentMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
nameMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
nameMatchScore:
type: integer
format: int32
givenNameMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
givenNameMatchScore:
type: integer
format: int32
familyNameMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
familyNameMatchScore:
type: integer
format: int32
nameKanaHankakuMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
nameKanaHankakuMatchScore:
type: integer
format: int32
nameKanaZenkakuMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
nameKanaZenkakuMatchScore:
type: integer
format: int32
middleNamesMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
middleNamesMatchScore:
type: integer
format: int32
familyNameAtBirthMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
familyNameAtBirthMatchScore:
type: integer
format: int32
addressMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
addressMatchScore:
type: integer
format: int32
streetNameMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
streetNameMatchScore:
type: integer
format: int32
streetNumberMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
streetNumberMatchScore:
type: integer
format: int32
postalCodeMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
regionMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
regionMatchScore:
type: integer
format: int32
localityMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
localityMatchScore:
type: integer
format: int32
countryMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
houseNumberExtensionMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
birthdateMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
emailMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
emailMatchScore:
type: integer
format: int32
genderMatch:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.MatchResult'
title: CamaraKycMatchResponseDto
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.KycWebhookData:
type: object
description: Result data object.
properties:
mrzData:
$ref: '#/components/schemas/eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.MrzWebhookData'
faceMatch:
type: boolean
description: The result of comparing face images between a document and a selfie. `True`, if distance between images is less than configured threshold, which means that the faces most likely match. `False` means that the faces most likely do not match.
example: true
faceDistance:
type: number
format: float
description: Distance between face images from a document and a selfie. Possible values are numbers between `0.00` and `1.00`. The closer the number is to `0.00`, the more likely it is that the images match.
example: 0.232
faceConfidenceScore:
type: number
format: float
description: Confidence score between face images from a document and a selfie. Possible values are numbers between `0.00` and `100.00`. The closer the number is to `100.00`, the more likely it is that the images match.
example: 83
biometricReference:
type: string
description: 36-character unique identifier of a biometric vector associated with the end user. Used, if Infobip needs to store the vector.
example: usr_eb1cfc67ead74fc29ff2c65c4cec2baf
biometricVector:
type: array
description: Biometric vector associated with the end user. Used, if Infobip does not store the vector.
example:
- -0.09652680158615112
- 0.07107646763324738
- -0.029479391872882843
- -0.006973235867917538
items:
type: number
format: double
title: KycWebhookData
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.DcqlCredentialPerCarrierDtoResponse:
type: object
description: DCQL credential object per carrier.
properties:
id:
type: string
description: Aggregator ID.
example: miapi.infobip.com
format:
type: string
description: 'Fixed value for the DCQL credential: `dc-authorization+sd-jwt`.'
example: dc-authorization+sd-jwt
meta:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Meta'
claims:
type: array
description: Array of claim objects containing the optional hint used by Android to suggest the right SIM in dual-SIM devices.
items:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.Claim'
title: DcqlCredentialPerCarrierDtoResponse
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.ReportLineItem:
type: object
properties:
date:
type: string
description: Date in UTC when the activation state change has happened. Format yyyy-MM-dd'T'HH:mm:ss.SSSZ
example: 2024-03-05T11:00:00.000+0000
destination:
type: string
description: The phone number that changed its activation state
example: '15987654321'
type:
$ref: '#/components/schemas/8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.DeactivationType'
newDestination:
type: string
description: Optional information about a new phone number that replaced the original deactivated phone number.
Only optionally included in case of DEACTIVATION type of the entry
example: '15123456789'
required:
- date
- destination
- type
title: ReportLineItem
ApiRequestErrorDetails:
type: object
properties:
messageId:
type: string
description: Identifier of the error.
text:
type: string
description: Detailed error description.
validationErrors:
type: object
additionalProperties:
type: array
items:
type: string
description: Validation errors.
description: Validation errors.
title: ApiRequestErrorDetails
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.CreatedSessionResponse:
type: object
description: JSON containing information about the new session.
properties:
sessionId:
type: string
description: Unique session identifier.
example: efc373be-ab6d-4c63-b798-1f65b7b4b2b3
redirectUrl:
type: string
description: URL with `sessionId` to be sent to the end user which would then directly apply the scenario.
example: https://example.com/web/?sessionId=efc373be-ab6d-4c63-b798-1f65b7b4b2b3
title: CreatedSessionResponse
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.InitZeroRatedRequestDto:
type: object
description: Silent Mobile Verification zero rated request initialization.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '441134961234'
returnUrl:
type: string
description: An URL to which the mobile device will be redirected to when verification is complete.
example: https://api.infobip.com/my-site/my-shop.html
required:
- consentGranted
- phoneNumber
title: InitZeroRatedRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.OperationType:
type: string
enum:
- SILENT_MOBILE_VERIFICATION
- KNOW_YOUR_CUSTOMER
- SIM_SWAP
- NUMBER_SHARE
- NUMBER_INTELLIGENCE
- DEVICE_LOCATION
- NATIONAL_IDENTITY_NUMBER
title: OperationType
eb583710b0e1739c1b6da279daf56e71bef92e0a50c90d88ff2c7fea69527204.EnrollmentWebhookData:
type: object
description: Result data object.
properties:
biometricReference:
type: string
description: 36-character unique identifier of a biometric vector associated with the end user. Used, if Infobip needs to store the vector.
example: usr_eb1cfc67ead74fc29ff2c65c4cec2baf
biometricVector:
type: array
description: Biometric vector associated with the end user. Used, if Infobip does not store the vector.
example:
- -0.09652680158615112
- 0.07107646763324738
- -0.029479391872882843
- -0.006973235867917538
items:
type: number
format: double
title: EnrollmentWebhookData
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.VerificationSessionRequest:
type: object
description: JSON containing session parameters and client identifiers for Verification application.
properties:
scenarioName:
type: string
description: 'Request a specific scenario within the application. To get possible values call [Get Scenarios](#platform-connectivity/biometrics/get-biometrics-scenarios) with the following query parameter: `?applicationTypes=verification`. Check scenario descriptions in the response to find the scenario you need, and copy its `name`.'
example: FACE_VERIFICATION
locationInfo:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.LocationInfo'
partnerReference:
type: string
description: Your (usually unique) identifier of the end user performing the scenario. Will be sent together with the rest of the information via the webhook.
example: MyRef-jqhof
webhook:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.WebhookInfo'
successUrl:
type: string
description: End user will be sent to this URL after the selected scenario has been successfully completed.
example: https://example.com/success
cancelUrl:
type: string
description: End user will be sent to this URL if they cancel the scenario.
example: https://example.com/cancel
retainData:
type: boolean
description: Indicates whether Infobip should store and retain data. This value overrides value in account configuration.
example: true
biometricData:
$ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricData'
required:
- locationInfo
- scenarioName
- webhook
title: VerificationSessionRequest
ApiException:
type: object
properties:
requestError:
$ref: '#/components/schemas/ApiRequestError'
title: ApiException
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmvVerifyAdvancedRequestDto:
type: object
description: Silent Mobile Verification Advanced request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to verify. The number must be in international format.
example: '441134961234'
callbackUrl:
type: string
description: Your URL that will be called to provide [result](#platform-connectivity/mobile-identity/receive-advanced-silent-mobile-verification-result) when the process is completed.
example: https://api.infobip.com/my-callback-webook/my-path
returnUrl:
type: string
description: An URL to which the mobile device will be redirected to when verification is complete.
example: https://api.infobip.com/my-site/my-shop.html
smsFailover:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SmsFailoverDto'
simSwapCheck:
$ref: '#/components/schemas/c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.SimSwapCheckDto'
deviceIp:
type: string
format: xxx.xxx.xxx.xxx|xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx:xxxx
description: IPv4 or IPv6 address of the mobile device that will be verified with operator. Currently, can be used only in Brazil.
example: 10.20.30.100|1111:22222:3333:4444:AAAA:BBBB:CCCC:DDDD
devicePort:
type: integer
format: int32
description: Port of the mobile device that will be verified with operator. Can be used only when "deviceIp" is also provided. Currently, can be used only in Brazil.
example: 54321
required:
- callbackUrl
- consentGranted
- phoneNumber
title: SmvVerifyAdvancedRequestDto
8018948352e80bbff88731d9fb43f611b84a58f2b44c304c63a8e4ae9c4bd661.PageInfo:
type: object
properties:
page:
type: integer
format: int32
description: Requested page number.
minimum: 0
size:
type: integer
format: int32
description: Requested page size.
minimum: 1
totalPages:
type: integer
format: int32
description: The total number of pages of the results matching the requested parameters.
minimum: 0
totalResults:
type: integer
format: int64
description: The total number of the results matching the requested parameters.
minimum: 0
required:
- page
- size
- totalPages
- totalResults
title: PageInfo
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.NinCheckRequestDto:
type: object
description: National Identity Number check request object.
properties:
consentGranted:
type: boolean
description: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
example: true
phoneNumber:
type: string
description: Mobile phone number (MSISDN) to perform a query by. The number must be in international format.
example: '441134961234'
nationalId:
type: string
description: National Identification Number that will be used to check for a match against a mobile phone number.
example: 123.456.789-10
maxLength: 50
minLength: 1
documentType:
type: string
description: 'Document type that will be used to check for a match against a mobile phone number.
Currently, used and mandatory only in Colombia.
'
enum:
- CC
- CE
- NIT
required:
- consentGranted
- nationalId
- phoneNumber
title: NinCheckRequestDto
c4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17ae.CamaraUnauthenticatedErrorResponse:
type: object
description: Camara API error response for unauthenticated requests.
properties:
status:
type: integer
format: int32
description: HTTP status code.
example: 401
code:
type: string
description: Error code.
example: UNAUTHENTICATED
message:
type: string
description: Detailed error message.
example: Request not authenticated due to missing, invalid, or expired credentials
title: Camara Error Response
8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricReference:
type: object
allOf:
- $ref: '#/components/schemas/8a19359d3a412667abbd2d38733e247b91417d2a845ae41758328736ea0ecce9.BiometricData'
- type: object
properties:
reference:
type: string
description: 36-character unique identifier of a biometric vector associated with the end user. Used, if Infobip needs to store the vector in enrolment phase and return reference in result.
example: usr_eb1cfc67ead74fc29ff2c65c4cec2baf
title: BiometricReference
4503c9be2d8553d1e8648e283b9ba9017ae14f51177b500d7b5df7dc4842e4d2.ErrorInfoResponse:
type: object
description: Information about error occurred. If there is no error this object is omitted.
properties:
id:
type: number
format: integer
description: Unique identifier of occurred error on Infobip platform.
name:
type: string
description: Unique string identifier of occurred error on Mobile Identity platform.
description:
type: string
description: Description of error occurred for easier comprehension.
title: MobileIdentityErrorInfoResponse
responses:
ApiException401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
example:
requestError:
serviceException:
messageId: UNAUTHORIZED
text: Unauthorized
application/xml:
schema:
$ref: '#/components/schemas/ApiException'
example: "\n \n \n UNAUTHORIZED\n Unauthorized\n \n \n\n"
ApiException500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
example:
requestError:
serviceException:
messageId: GENERAL_ERROR
text: Something went wrong. Please contact support.
application/xml:
schema:
$ref: '#/components/schemas/ApiException'
example: "\n \n \n GENERAL_ERROR\n Something went wrong. Please contact support.\n \n \n\n"
ApiException429:
description: Too Many Requests
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
example:
requestError:
serviceException:
messageId: TOO_MANY_REQUESTS
text: Too many requests
application/xml:
schema:
$ref: '#/components/schemas/ApiException'
example: "\n \n \n TOO_MANY_REQUESTS\n Too many requests\n \n \n\n"
ApiException403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ApiException'
example:
requestError:
serviceException:
messageId: FORBIDDEN
text: Forbidden
application/xml:
schema:
$ref: '#/components/schemas/ApiException'
example: "\n \n \n FORBIDDEN\n Forbidden\n \n \n\n"
securitySchemes:
APIKeyHeader:
type: apiKey
description: 'This is the most secure authorization type and the one with the most flexibility.
API 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
be 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.
Finally, the loss of an API key is easily manageable.
You can manage your API keys from [GUI](https://portal.infobip.com/settings/accounts/api-keys), or programmatically
with [dedicated API](#platform-&-connectivity/settings).
API key Authorization header example:
```shell
Authorization: App 003026bbc133714df1834b8638bb496e-8f4b3d9a-e931-478d-a994-28a725159ab9
```
'
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
with the Basic type.
In this case, the credentials included in the Authorization header should be a Base64 encoded username and password combination. More formally, basic
authentication header can be constructed in three steps:
* Username and password are concatenated using the colon `(:)` as a separator `username:password`.
* The resulting string is encoded using the [RFC2045-MIME](https://www.ietf.org/rfc/rfc2045.txt) variant of Base64.
* Encoded string is added as credentials after the `"Basic "` type.
Example:
```shell
Username: "Aladdin"
Password: "openSesame"
Concatenated string: "Aladdin:openSesame"
Base64 encoded string: "QWxhZGRpbjpvcGVuU2VzYW1l"
Authorization header: "Basic QWxhZGRpbjpvcGVuU2VzYW1l"
```
> **Implementation detail**: Base64 encoding is a standard and many available programming languages and frameworks provide convenient methods for encoding
> strings.
'
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
credentials 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
used to authenticate subsequent API requests. Note that the session will expire automatically after a predefined period of inactivity, and can also be manually
terminated by making an appropriate API call.
You can find more details on the creation and behavior of the session at
the [dedicated documentation page](#platform-connectivity/account-management/create-session).
After obtaining the session token by calling the above-referenced API method you can include it in the Authorization header like this:
```shell
Authorization: IBSSO 2f9b4d31-2d0d-49a8-85f0-9b862bdca394
```
'
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
the 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.
You can use the token to authorize your API calls until it expires. You can find out more about the process in
the [official specification](https://tools.ietf.org/html/rfc6749#section-4.4).
You can include your access token in the Authorization HTTP request header like this:
```http
Authorization: Bearer
```'
flows:
clientCredentials:
tokenUrl: https://api.infobip.com/auth/1/oauth2/token
scopes: {}