INinfobip
connectivity
camara
network-based-number-verification

Number verify device authorization

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).
get/camara/number-verification/v0/authorize

Request

  • Base URL
    https://api.infobip.com (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Query parameters

clientIdstring required

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 and/or client_id that is being used when generating OAuth2 token.

redirectUrlstring uri required

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.

statestring

String that will be returned as a query parameter in the redirectUrl.

login_hintstring

OIDC login hint. Expects a phone number in tel:+{phone_number_with_country_code} format.

Changes

No recorded changes to this operation across all 1 revision of this API.