Retrieve an Identity

Retrieves the detail of a specific Identity.

API Endpoint

GET https://api.plivo.com/v1/Account/{auth_id}/Verification/Identity/{id}/

Arguments

No arguments need to be passed.

Returns

Returns an Identity object.

Response

HTTP Status Code: 200

{
  "account": "MAXXXXXXXXXXXXXXXXXX",
  "alias": null,
  "api_id": "6e951a10-0b5a-11e8-a416-06f8d2f9b24c",
  "country_iso": "FR",
  "document_details": {
    "first_name": "Bruce",
    "id_number": "33522",
    "id_type": "passport",
    "last_name": "Wayne",
    "nationality": "FR",
    "salutation": "Mr"
  },
  "first_name": "Bruce",
  "id": "24856289978366",
  "id_number": "33522",
  "id_type": "passport",
  "last_name": "Wayne",
  "nationality": "FR",
  "salutation": "Mr",
  "subaccount": null,
  "url": "https://api.plivo.com/v1/Account/MAXXXXXXXXXXXXXXXXXX/Verification/Identity/24856289978366/",
  "validation_status": "pending",
  "verification_status": "pending"
}

Example Request

1
2
3
4
5
6
import plivo

client = plivo.RestClient()
response = client.identities.get(
    identity_id='32208455725227', )
print(response)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
/**
 * Example for Account Get
 */
using System;
using System.Collections.Generic;
using Plivo;
using Plivo.Exception;

namespace PlivoExamples
{
    internal class Program
    {
        public static void Main(string[] args)
        {
            var api = new PlivoApi("YOUR_AUTH_ID", "YOUR_AUTH_TOKEN");
            try
            {
                var response = api.Identity.Get(
                    "identityId"
                );
                Console.WriteLine(response);
            }
            catch (PlivoRestException e)
            {
                Console.WriteLine("Exception: " + e.Message);
            }
        }
    }
}