---
title: "GET /relationship_categories"
method: GET
path: "/relationship_categories"
tags: ["relationship_categories"]
---

# GET /relationship_categories

`GET /relationship_categories`

## Request

- Base URL: `https://api.propstack.de/v2`
- URL: `https://api.propstack.de/v2/relationship_categories`
- Auth: API key in header `X-Api-Key`

List contact relationship categories and their behavior

## Query parameters

- `locale` 'en' | 'de' | 'es' | 'fr' | 'id' | 'it' | 'ja' | 'nl' | 'pt-BR' | 'ru' | 'sv' | 'ar' | 'bg' | 'ca-CAT' | 'ca' | 'da-DK' | 'de-AT' | 'de-CH' | 'ee' | 'en-AU' | 'en-BORK' | 'en-CA' | 'en-GB' | 'en-IND' | 'en-MS' | 'en-NEP' | 'en-NG' | 'en-NZ' | 'en-PAK' | 'en-SG' | 'en-TH' | 'en-UG' | 'en-US' | 'en-ZA' | 'en-au-ocker' | 'es-AR' | 'es-MX' | 'fa' | 'fi-FI' | 'fr-CA' | 'fr-CH' | 'he' | 'hy' | 'ko' | 'lt' | 'lv' | 'mi-NZ' | 'nb-NO' | 'no-NO' | 'pl' | 'pt' | 'sk' | 'th' | 'tr' | 'uk' | 'vi' | 'zh-CN' | 'zh-TW' | 'hu' | 'az' | 'bs' | 'cs' | 'da' | 'el' | 'et' | 'fi' | 'hi' | 'hr' | 'nb' | 'prs' | 'ro' | 'sl' | 'sq' | 'sr' | 'ur'

## Response `200`

List contact relationship categories and their behavior

- RelationshipCategoryEntity: RelationshipCategoryEntity model
  - `id` integer
  - `label_a` string
  - `label_b` string
  - `hierarchy` string
  - `subcontact_form_enabled` boolean
  - `include_related_activities` boolean
  - `include_related_email_addresses` boolean
  - `route_deals_to_main_contact` boolean
  - `show_main_contact_link` boolean
  - `include_related_in_main_contact_search` boolean
  - `delete_related_contacts_with_main_contact` boolean
  - `translations` object[]

## Other responses

- `400`: validation_error
- `401`: authentication_error
- `403`: authorization_error
- `404`: not_found_error
- `422`: validation_error
- `429`: rate_limit_exceeded
- `500`: internal_server_error

## Changes

- **2026-11-04** `b68ea1933caa`: 1 info
  - added the non-success response with the status `429`
- **2026-10-09** `66a565c0ca01`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/changes/relationship_categories/get.md)

---

[API](https://skmtc.dev/propstack/apis/propstack-api-v2-beta.md) - [All operations](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/propstack/apis/propstack-api-v2-beta/revisions/b68ea1933caa?raw)