---
title: "Get contact by role"
method: GET
path: "/contacts/{id}/role/{role}"
tags: ["Contacts"]
---

# Get contact by role

`GET /contacts/{id}/role/{role}`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/contacts/{id}/role/{role}`
- Auth: HTTP bearer

Retrieve a contact's information filtered by a specific role.

## Path parameters

- `id` string, uuid, required
- `role` string, required

## Response `200`

Contact with role

- Contact
  - `id` string, uuid
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `email` string, email, nullable
  - `phone` string, nullable
  - `address` object, nullable
    - `street` string, nullable
    - `city` string, nullable
    - `postal_code` string, nullable
    - `country` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)