Skip to content
On this page

Get All Phone Number Verification Requests.

Endpoint for getting all Phone Number Verification requests by search filter.

Endpoints

EnvironmentURL
Sandboxhttps://api-test.streamline.laboremus.ug/phone-verify/api/Verification[?RequesterId][&VerificationStatuses][&Statuses][&PhoneNumber][&From][&To][&ReferenceId][&Query][&Skip][&Limit]&v=1.0
Productionhttps://api.streamline.laboremus.ug/phoneid/api/Verification

Request

Request Type : GET

Authorization

There are two ways to be authorized when making this request.

js
const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT, 
  headers: {
    Authorization: `Bearer ${token}`
  }
)
const token = 'eyJhbGciOiJIUzI1NiIsInR5.eyJzd...ssw5c'
axios.get(API_ENDPOINT, 
  headers: {
    Authorization: `Bearer ${token}`
  }
)
js
import axios from 'axios'
    import oauth from 'axios-oauth-client'
    
    const getClientCredentials = oauth.clientCredentials(
    axios.create(),
    'https://oauth.com/2.0/token',
    'CLIENT_ID',
    'CLIENT_SECRET'
    )

    const auth = await getClientCredentials('OPTIONAL_SCOPES')
    // => { "access_token": "...", "expires_in": 900, ... }

    axios.get(API_ENDPOINT, 
      headers: {
        Authorization: `Bearer ${auth.access_token}`
      }
    )
import axios from 'axios'
    import oauth from 'axios-oauth-client'
    
    const getClientCredentials = oauth.clientCredentials(
    axios.create(),
    'https://oauth.com/2.0/token',
    'CLIENT_ID',
    'CLIENT_SECRET'
    )

    const auth = await getClientCredentials('OPTIONAL_SCOPES')
    // => { "access_token": "...", "expires_in": 900, ... }

    axios.get(API_ENDPOINT, 
      headers: {
        Authorization: `Bearer ${auth.access_token}`
      }
    )

INFO

Always add your Subscription key to the request.

js
axios.get(API_ENDPOINT, 
  headers: {
    'Ocp-Apim-Subscription-Key': 'd484a1f0d34f43019'
  }
)
axios.get(API_ENDPOINT, 
  headers: {
    'Ocp-Apim-Subscription-Key': 'd484a1f0d34f43019'
  }
)
js
const res = await axios.get(API_ENDPOINT, { 
  params: { 
    Ocp-Apim-Subscription-Key: 'd484a1f0d34f43019' 
  } 
});
const res = await axios.get(API_ENDPOINT, { 
  params: { 
    Ocp-Apim-Subscription-Key: 'd484a1f0d34f43019' 
  } 
});

Path Parameters Values

NameTypeRequiredDescription
idstring(uuid)yesThe Unique ID of a URSB-AnnualReturns request

Query Parameters Values

NameTypeRequiredDescription
RequesterIdstring or nullnoThe unique Id for the request initiator
VerificationStatusArray of string (Enum: Unknown, Valid, Invalid)noThe verification stage status
StatusesArray of string (Enum: Pending, Completed, Error)noThe stage at which the request is at
PhoneNumberstring or nullnoPhone number sent in request payload.
Fromstring (date-time)noStart date in query.
Tostring (date-time)noEnd date in query.
ReferenceIdstring or nullnoReference Id sent in the verification request.
Querystring or nullnoSearch input.
Skipinteger (int32)noPage number
Limitinteger (int32)noNumber of responses per page.

Response

Response Values

Content type

application/json

NameTypeDescription
statusCodeinteger (int32)

Example Response Body

json
{
  "statusCode": 0,
}
{
  "statusCode": 0,
}

Error Response

400 Bad Request

application/json

NameTypeDescription
statusCodeinteger(int32)The status of the error response

Example Error Response

json
{
 "statusCode": 0
}
{
 "statusCode": 0
}

401 Unauthorized

application/json

NameTypeDescription
statusCodeinteger(int32)The status of the error response

Example Error Response

json
{
 "statusCode": 0
}
{
 "statusCode": 0
}

500 Server Error

No response

Tech served right