List all Identities

    Returns a list of identities.

    API Endpoint

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

    Arguments

    country_iso

    Country ISO 2 code

    customer_name

    Name of the customer or business that is mentioned in the address

    alias

    Friendly name of the id proof

    verification_status

    The status of the identity: approved, pending, rejected

    Returns

    An array of Identity objects.

    Response

    HTTP Status Code: 200

    {
      "api_id": "3c294e0c-0b5a-11e8-9ad8-064c8d7b2d26",
      "meta": {
        "limit": 1,
        "next": "https://api.plivo.com/v1/Account/MAXXXXXXXXXXXXXXXXXX/Verification/Identity/?limit=1&offset=1",
        "offset": 0,
        "previous": null,
        "total_count": 6
      },
      "objects": [
        {
          "account": "MAXXXXXXXXXXXXXXXXXX",
          "alias": null,
          "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
    7
    
    import plivo
    
    client = plivo.RestClient()
    response = client.identities.list(
        offset=0,
        limit=5, )
    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
    
    /**
     * 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.List();
                    Console.WriteLine(response);
                }
                catch (PlivoRestException e)
                {
                    Console.WriteLine("Exception: " + e.Message);
                }
            }
        }
    }