Choose a proof category
Use the returned category and entity type when preparing the evidence required for an identity. This list describes categories, not your uploaded files and not approval of any proof.
Match the actual requirements
A category being listed does not mean it satisfies every country, number type or customer identity. Read the applicable requirements before uploading evidence, and keep returned IDs opaque.
Request
Use your enabled API account credentials over HTTPS. Basic authentication and enabled API-account bearer tokens are supported; account restrictions apply.
GET with any documented parameter in the URL path.
curl --fail-with-body --silent --show-error \
--user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_proof_types"Response
Check status.code in the JSON body as well as the HTTP status. response is an array of id, name and entity_type objects. These values come from the current proof catalogue. IDs are opaque; copy them rather than constructing or hashing one. An empty catalogue can be returned successfully. Do not hard-code a complete entity-type enum from this example.
Illustrative response shape; not live account data or a current quote.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"id": "PROOF_TYPE_ID_FROM_RESPONSE",
"name": "Example proof category",
"entity_type": "ENTITY_TYPE_FROM_RESPONSE"
}
]
}Errors
- Check status.code and status.msg for authentication or service errors. A successful empty catalogue is not approval of a document or a registration exemption.
Availability and side effects
- This catalogue/requirements lookup does not create an identity, upload a proof, register a number or place an order.
- A successful catalogue response is not approval of your documents or confirmation that a selected number can be activated.