masstack

V1
API Overview Resources Schemas

KYC Tenure

API operation to check the length of tenure of a subscriber.

Parameters

Name In Type Required Description
Authorization header string true Bearer ‘token’
body body TenureRequest true ‘none’

Request body - instance of TenureRequest

1
2
3
4

{
  "phoneNumber": "+346661113334",
  "tenureDate": "2023-07-03"
}
Name Type Required Description
phoneNumber PhoneNumber false A public identifier addressing a telephone subscription. In mobile networks it corresponds to the MSISDN (Mobile Station International Subscriber Directory Number). In order to be globally unique it has to be formatted in international format, according to E.164 standard, prefixed with ‘+’.
tenureDate string(date) true The date, in RFC 3339 / ISO 8601 compliant format “YYYY-MM-DD”, from which continuous tenure is required to be confirmed. Must not be in the future.

Request example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


curl -X POST https://apimanager-opengateway.sta.k8s.masmovil.com/kyc-tenure/v0/check-tenure \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: string" \
 --data-raw "{
  'phoneNumber': '+346661113334',
  'tenureDate': '2023-07-03'
}"

Responses

Code Meaning Description Schema
200 OK Respond with tenure information TenureResponse
400 Bad Request Problem with the client request ErrorInfo
401 Unauthorized Unauthorized ErrorInfo
403 Forbidden Forbidden ErrorInfo
404 Not Found Not found ErrorInfo
422 Unprocessable Entity Unprocessable Content ErrorInfo
500 Internal Server Error Server error ErrorInfo
503 Service Unavailable Service unavailable. Typically the server is down. ErrorInfo
504 Gateway Time-out Request time exceeded. If it happens repeatedly, consider reducing the request complexity ErrorInfo

Endpoints

Phone number verify

    Sim Swap

      Device Swap

        KYC Match

          KYC Age Verification

            KYC Tenure

              Consent Information

                Authentication

                  Phone number share