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);
                }
            }
        }
    }