Get Contacts for a Matter

GET

/v1/matters/{matter_id}/contacts

Get a list of the contacts under a given matter

NOTE: if you are pulling this directly after the intakeform.submitted event you are probably getting incomplete information. DecisionVault functions like a portal and the client can come back later to add more info - check out the webhook event intakeform.completed which can be the right trigger for this.)

Request

Path Params

Responses

🟢200OK

application/json

Body

Response Example

{
    "matter": "matter_D65508D9A98A473B874F4FC2CEDC800E",
    "contacts": [
        {
            "id": "contact_6AB8E24C9CF84EAB82B1E19AF553F05F",
            "for_matter": "matter_D65508D9A98A473B874F4FC2CEDC800E",
            "is_client": true,
            "first_name": "Mary",
            "middle_name": "",
            "last_name": "Smith",
            "suffix": null,
            "full_name": "Mary Smith",
            "also_known_as": null,
            "preferred_name": null,
            "gender_binary": "Female",
            "date_of_birth": "1971-02-02",
            "date_of_death": null,
            "phone_numbers": [
                {
                    "id": "phone_F03EC16DEB2943A0A6052D2E74FEC48E",
                    "type": "home",
                    "number": "(555) 333-2222"
                },
                {
                    "id": "phone_5CB5C90DED4F448ABECF1806CBCD282F",
                    "type": "mobile",
                    "number": "(555) 444-3333"
                }
            ],
            "email_addresses": [
                {
                    "id": "email_3293ABCB1CF74A2589055AECB1527AC4",
                    "type": "home",
                    "email": "marysmith@example.com"
                }
            ],
            "addresses": [
                {
                    "id": "address_P2CB56A57A4F241FC96B7C30DA6322D49",
                    "type": "home",
                    "street": "123 Main St",
                    "city": "Denver",
                    "state": "CO",
                    "postal_code": "80008",
                    "country_iso": "USA",
                    "country_display": "United States of America",
                    "full_address": "123 Main St, Denver, CO 80008, USA"
                }
            ],
            "created_at": "2022-03-09T17:10:59.899267+00:00"
        }
    ]
}

Modified at 2025-09-21 17:21:43

Get Assets for a Matter

Get Documents for Matter