TRtruv
Users

List all users

Changed on

The endpoint returns a list of users.

get/v1/users/

Request

  • Base URL
    https://prod.truv.com
  • URL
    https://prod.truv.com/v1/users/
  • Auth
    API key in header X-Access-Client-Id and API key in header X-Access-Secret

Query parameters

created_at__ltestring

Filter created_at less than or equal (ISO-8601)

created_at__gtestring

Filter created_at greater than or equal (ISO-8601)

product_type'income' | 'employment' | 'deposit_switch' | 'pll' | 'insurance' | 'transactions' | 'assets'
Example:income

Filter by product type.

providerstring

Filter by provider id.

querystring

Search query by the following fields: id, external_user_id, email, first_name, last_name, link_id.

link_existsboolean

If not set, returns all users; otherwise, returns users with/without attempts.

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

external_user_idstring

Filter by user external identifier.

list_linksboolean

When set to true, for each user adds the payload from the account links endpoint.

show_fraud_reasonsboolean

Set to true to include fraud_reasons for each link returned in the response. Requires list_links=true.

Response

countinteger required
nextstring uri nullable
previousstring uri nullable

Example response

{
  "results": [
    {
      "id": "24d7e80942ce4ad58a93f70ce4115f5c",
      "external_user_id": "12345",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john.doe@example.com",
      "phone": "+14155554193",
      "ssn": "*****3333",
      "created_at": "2022-05-04T11:30:00Z",
      "updated_at": "2022-05-04T12:00:00Z",
      "links": [
        {
          "id": "48427a36d43c4d5aa6324bc06c692456",
          "access_token": "****************************7610",
          "created_at": "2022-06-07T15:00:00Z",
          "updated_at": "2022-06-30T15:00:00Z",
          "deleted_at": "2022-06-30T15:00:00Z",
          "tracking_info": "user123456",
          "status": "new",
          "user_external_id": "user123456",
          "provider_id": "adp",
          "provider": {
            "id": "adp",
            "name": "ADP"
          },
          "company_mapping": {
            "id": "meta",
            "name": "Meta"
          },
          "link_hash": "bc917458a3da4b2c8cc8282aa1707aaa",
          "allowed_products": [
            "income"
          ],
          "initial_product_type": "income",
          "data_source": "payroll",
          "fraud_reasons": [
            {
              "code": "editing_software_detected",
              "message": "Document metadata identifies editing software.",
              "severity": "high",
              "document_ids": [
                "d1f3a6e0b1c24f6c9b3e2a7d5c8e9f01"
              ],
              "uploaded_file_ids": [
                "9ac0b2d4e6f84a1c8e3b5d7f9a1c3e5b"
              ],
              "details": {
                "software": [
                  "Adobe Photoshop 25.0 (Windows)"
                ]
              },
              "task_id": "48427a36d43c4d5aa6324bc06c692456",
              "created_at": "2026-10-20T14:03:11Z"
            }
          ]
        }
      ]
    }
  ]
}

Changes

  • 64de38c55f45Revision changes
    • info

      added the new optional query request parameter show_fraud_reasons

    • info

      added the optional property //// to the response with the status

  • e58688835e25Revision changes
    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • breaking

      the ///// response property's maxLength was increased from 128 to 255 for the response status

    • warning

      added the new credit enum value to the ///// response property for the response status

    • warning

      added the new credit enum value to the //// response property for the response status

    • warning

      added the new credit enum value to the //// response property for the response status

    • warning

      added the new education enum value to the ///// response property for the response status

    • warning

      added the new education enum value to the //// response property for the response status

    • warning

      added the new education enum value to the //// response property for the response status